Intégration Zendesk
Connectez votre chatbot IA à Zendesk
Votre agent intoCHAT répond d'abord aux visiteurs. Quand quelqu'un a besoin d'une personne, le transfert ouvre un ticket Zendesk avec un résumé IA et la conversation, et votre équipe répond depuis Zendesk. En retour, l'agent peut apprendre des tickets résolus.
Ce que fait l'intégration Zendesk
L'intégration fonctionne dans les deux sens, et les deux utilisent la même connexion : un jeton d'API de votre compte Zendesk. De intoCHAT vers Zendesk : quand votre agent transfère une conversation par e-mail, il ouvre aussi un ticket dans Zendesk. L'adresse e-mail que le visiteur a donnée pour le transfert devient le demandeur : quand votre équipe répond depuis Zendesk, la réponse arrive au visiteur par e-mail. Le ticket contient ce dont votre équipe a besoin pour reprendre sans reposer de questions : le résumé de la demande rédigé par l'agent, trois à cinq points rédigés par l'IA, la page et le pays, les 30 derniers messages et un lien vers la conversation dans intoCHAT. L'e-mail de transfert à votre équipe part toujours ; le ticket s'y ajoute. De Zendesk vers intoCHAT : dès l'offre Starter, l'agent peut importer vos tickets Zendesk résolus et clos comme connaissances. Chaque ticket devient une question et la réponse publique de votre équipe, après suppression des données personnelles. Les notes internes ne sont jamais importées. Ce qu'elle ne fait pas : il n'y a pas de synchronisation bidirectionnelle. Les réponses, changements de statut et notes dans Zendesk ne reviennent pas dans intoCHAT. Votre équipe répond dans Zendesk, et la transcription dans intoCHAT renvoie au ticket.
Connecter Zendesk en cinq étapes
Activez le transfert par e-mail
Ouvrez votre agent, allez dans l'onglet Setup, activez Offer hand-off by email sous Hand-off to your team et enregistrez. Les tickets ne sont ouverts que pour les transferts par e-mail, c'est donc la première étape.
Créez un jeton d'API dans Zendesk
Dans l'Admin Center de Zendesk, ouvrez Apps and integrations, APIs, Zendesk API. Activez Token access s'il est désactivé, cliquez sur Add API token, nommez-le intoCHAT et copiez le jeton. Zendesk ne l'affiche qu'une fois.
Connectez-le dans intoCHAT
Dans la carte Helpdesk tickets de l'onglet Setup, choisissez Zendesk. Saisissez votre sous-domaine (acme pour acme.zendesk.com), l'e-mail de l'agent ou de l'administrateur au nom duquel les tickets sont créés et le jeton, puis cliquez sur Test and connect. intoCHAT vérifie le jeton par une lecture qui ne modifie rien.
Associez des champs de ticket (facultatif)
Sous Ticket fields, cliquez sur Add ticket fields. intoCHAT lit vos vrais champs Zendesk : vous choisissez un champ personnalisé, la priorité, le groupe, l'assigné ou des tags, et donnez à chacun une valeur fixe ou une variable comme l'e-mail du visiteur ou un attribut du contact.
Testez depuis le Playground
Demandez une personne à l'agent dans le Playground et donnez une adresse e-mail. Quelques secondes plus tard, un vrai ticket s'ouvre dans Zendesk, marqué [Test] dans l'objet. Importez ensuite des tickets résolus dans l'onglet Knowledge si vous voulez que l'agent en apprenne.
Ce que contient un ticket d'intoCHAT
Subject: [Acme Assistant] Chat hand-off: Ma facture indique l'offre annuelle, alors que j'ai choisi le mensuel. Quelqu'u…
A visitor asked for a person in the chat with Acme Assistant. Reply to them by email: anna@example.com
What they need
The visitor was charged for the annual plan but chose monthly, and wants the invoice corrected.
Summary
- Wants the invoice corrected: charged for the annual plan, chose monthly
- The AI explained where invoices are, but can't change billing
- Contact email given: anna@example.com
Visitor
Email: anna@example.com
Page: https://www.example.com/account/billing
Country: France
Conversation (last 4 messages)
Visitor: Ma facture indique l'offre annuelle, alors que j'ai choisi le mensuel. Quelqu'un peut-il corriger cela ?
AI: Je ne peux pas modifier la facturation moi-même, mais je peux transmettre cette conversation à notre équipe par e-mail. À quelle adresse doit-elle vous répondre ?
Visitor: anna@example.com
AI: Merci. J'ai transmis la conversation à l'équipe, qui vous répondra à anna@example.com.
In intoCHAT
https://www.intochat.ai/chatbots/…/edit?tab=activity&conversation=…Un exemple. Les intitulés et le résumé IA sont toujours en anglais ; l'objet et la conversation reprennent les mots du visiteur. Dans Zendesk, ce texte est le premier commentaire du ticket, ajouté en note interne, et le ticket porte le tag intochat. Vos champs de ticket s'y ajoutent.
Ce qui se passe dans Zendesk
Le visiteur est le demandeur
L'adresse e-mail donnée par le visiteur pour le transfert est le demandeur du ticket, avec son nom quand votre formulaire de leads ou la vérification d'identité le fournit. Les réponses publiques depuis Zendesk lui parviennent par e-mail.
La transcription reste interne
Le résumé et la conversation vont dans une note interne, pas dans un commentaire public : ils ne sont pas envoyés au visiteur. Les déclencheurs de Zendesk fonctionnent toujours, comme l'e-mail qui confirme la réception de la demande.
Vos champs, priorité et groupe
Remplissez sur chaque nouveau ticket des champs personnalisés, la priorité, le groupe, l'assigné par ID utilisateur et des tags. Les valeurs peuvent être fixes ou utiliser des variables comme {{contact.plan}} ou {{conversation.page}}.
Un résumé IA sur chaque ticket
Trois à cinq points en anglais indiquent ce que veut le visiteur et ce que l'agent a déjà répondu, au-dessus des 30 derniers messages. Si le résumé n'est pas prêt à temps, le ticket est créé sans lui.
Apprend des tickets résolus
Dès Starter, importez les tickets Zendesk résolus ces 30, 90 ou 365 derniers jours. La question du client et les réponses publiques de votre équipe deviennent des connaissances ; e-mails, numéros de téléphone et de commande sont remplacés avant.
Garde les connaissances à jour
Avec Sync automatically activé, intoCHAT cherche chaque jour ou chaque semaine les nouveaux tickets résolus et réentraîne ceux dont le texte a changé. Sync now fait de même à la demande.
Liés dans les deux sens
La transcription dans intoCHAT affiche Ticket # avec un lien qui l'ouvre dans Zendesk, et le ticket renvoie à la conversation. Le webhook handoff.requested contient aussi le numéro et le lien du ticket.
Identifiants protégés
Le jeton est stocké chiffré et n'est plus jamais affiché ; la carte n'en montre que les quatre derniers caractères et l'e-mail. Seuls le propriétaire du compte et les administrateurs peuvent connecter ou déconnecter Zendesk.
Limites à connaître avant de connecter
- Pas de synchronisation bidirectionnelle : les réponses, changements de statut et notes dans Zendesk ne reviennent pas dans intoCHAT.
- Les tickets ne sont ouverts que pour les transferts par e-mail. Une conversation reprise par votre équipe dans le live chat d'intoCHAT n'en ouvre pas.
- Un ticket par conversation. Un transfert ultérieur dans la même conversation envoie un autre e-mail, mais pas de second ticket.
- Un helpdesk par agent. Pour utiliser Zendesk et un autre helpdesk, il faut des agents distincts.
- Si Zendesk ne répond pas dans les 10 secondes ou limite les requêtes, ce ticket n'est pas créé et n'est pas retenté. L'e-mail de transfert part quand même, et la transcription indique que le ticket n'a pas pu être créé.
- Jusqu'à 25 champs de ticket par agent, chaque valeur jusqu'à 500 caractères, et jusqu'à 10 tags par ticket. Les champs à choix multiples ne sont pas proposés.
- L'import de tickets ne lit que les réponses publiques et est inclus dès l'offre Starter : jusqu'à 200 tickets par agent avec Starter, 1 000 avec Pro et 5 000 avec Enterprise.
Questions fréquentes
intoCHAT remplace-t-il Zendesk ?
Non. intoCHAT est l'agent IA de votre site, qui répond aux questions à partir de vos propres contenus. Zendesk reste l'endroit où votre équipe traite ce que l'agent ne peut pas résoudre. Quand un visiteur demande une personne, le transfert ouvre un ticket Zendesk, et votre équipe répond depuis Zendesk comme d'habitude.
De quoi ai-je besoin dans Zendesk pour le connecter ?
D'un jeton d'API Zendesk avec Token access activé dans l'Admin Center, et de l'adresse e-mail d'un agent ou d'un administrateur de votre compte. intoCHAT se connecte avec cet e-mail et le jeton, comme Zendesk le décrit pour les jetons d'API, et refuse un utilisateur qui n'est ni agent ni administrateur. Le jeton vaut pour tout votre compte Zendesk : supprimez-le dans Zendesk si vous cessez d'utiliser intoCHAT.
Quelle offre intoCHAT inclut l'intégration Zendesk ?
L'ouverture de tickets Zendesk pour les transferts est incluse dans toutes les offres, Free compris. L'import de tickets Zendesk résolus comme connaissances commence à Starter, avec jusqu'à 200 tickets par agent avec Starter, 1 000 avec Pro et 5 000 avec Enterprise. Les tickets importés comptent aussi dans les caractères d'entraînement de l'agent.
Le visiteur voit-il la transcription dans les e-mails de Zendesk ?
Non. Le résumé et la conversation sont ajoutés en note interne, que Zendesk n'envoie pas au demandeur. Le visiteur reçoit les réponses publiques de votre équipe et les notifications envoyées par vos déclencheurs Zendesk, comme la confirmation de réception de la demande.
Les réponses de Zendesk reviennent-elles dans le chat ?
Non. Il n'y a pas de synchronisation bidirectionnelle : réponses, changements de statut et notes restent dans Zendesk, et le visiteur reçoit votre réponse par e-mail. Dans intoCHAT, la conversation affiche le numéro du ticket avec un lien qui l'ouvre, pour passer facilement de l'un à l'autre.
Puis-je définir le groupe, la priorité ou un champ personnalisé sur chaque ticket ?
Oui. Sous Ticket fields, vous choisissez de vrais champs de votre compte Zendesk : champs personnalisés, tags, priorité, groupe et assigné par ID utilisateur. Une valeur peut être un texte fixe, une variable comme {{visitor.email}} ou {{contact.plan}}, ou les deux. Si Zendesk refuse une valeur, par exemple un groupe supprimé, intoCHAT renvoie le ticket sans les champs associés et affiche un avertissement dans la carte.
Comment l'agent apprend-il de nos tickets Zendesk ?
Dans l'onglet Knowledge, la carte Helpdesk tickets importe les tickets au statut Solved ou Closed. Chacun devient une question (l'objet et le premier message du client) et une réponse (les réponses publiques de votre équipe). Les commentaires non publics sont ignorés. Avant l'enregistrement, intoCHAT remplace les adresses e-mail, numéros de téléphone, numéros ressemblant à des cartes, numéros de commande et de compte, et les noms dans les salutations et signatures. Vérifiez d'abord le résultat avec Preview.
Quelles données intoCHAT envoie-t-il à Zendesk ?
Pour chaque transfert : la transcription, le résumé IA, l'adresse e-mail du visiteur et son nom s'il est connu, la page et le pays, plus ce qu'ajoutent vos champs de ticket, comme des attributs du contact. intoCHAT ne lit rien en retour dans Zendesk, sauf la liste des champs quand vous modifiez les champs de ticket et, si vous les importez, vos tickets résolus. Mentionnez Zendesk dans votre politique de confidentialité s'il n'y figure pas déjà.
Que se passe-t-il si Zendesk ne répond pas ?
Le visiteur n'attend jamais Zendesk : le ticket est ouvert quelques secondes après la réponse de l'agent. Si Zendesk ne répond pas dans les 10 secondes, ce ticket n'est pas créé et n'est pas retenté, mais l'e-mail de transfert à votre équipe part quand même. La transcription affiche Ticket couldn't be created, et la carte de l'onglet Setup vous signale si les identifiants enregistrés ne fonctionnent plus.
Voyez-le répondre à partir de votre site
Collez l’adresse de votre site et discutez avec un agent créé à partir de vos pages. Cela prend environ une minute.
Créer votre agent gratuitementOffre gratuite, sans carte bancaire.