Guide
Zendesk : relier un agent IA aux données du client
Les agents IA Zendesk peuvent appeler le système du client par API : offres requises, spécifications (30 s, JSON), authentification, pannes fréquentes.
Mis à jour le
Un agent IA Zendesk peut aller chercher des informations dans le système du client (une commande, une adresse, un contrat) par une intégration personnalisée : il appelle une API (interface de programmation) de serveur à serveur. Pour un intégrateur, le travail porte rarement sur Zendesk lui-même : il porte sur l'API qu'on expose à l'agent, ce qu'elle permet, et comment elle répond. Cette page résume l'aide Zendesk lue le 15/11/2026.
Ce que permet une intégration personnalisée
L'article « Préparation à la création d'une intégration personnalisée pour un agent IA » donne deux exemples :
- getOrder : pour une demande du type « Où est ma commande », l'agent récupère les commandes récentes du client dans le système, les présente, puis affiche le statut et le lien de suivi de celle qu'il choisit ;
- updateAddress : pour « modifier mon adresse », le client s'identifie avec son e-mail et sa référence de commande, puis la nouvelle adresse est enregistrée dans le système.
Le premier est une lecture, le second une écriture. Cette différence doit guider tout le projet.
Offres requises : Suite Team, Growth, Professional, Enterprise ou Enterprise Plus ; ou Support Team, Professional ou Enterprise. L'article demande aussi de maîtriser les blocs conditionnels, les entités (qui valident le format de ce que saisit le client) et les actions de Zendesk.
Les exigences techniques côté client
L'article de spécifications liste ce que l'API appelée doit respecter :
| Exigence | Ce que dit Zendesk |
|---|---|
| Architecture | REST ou GraphQL |
| Délai | « Fournir une réponse API sous 30 secondes » |
| Format | JSON de préférence |
| Authentification | Clé API, jeton porteur, jeton à expiration, authentification de base, OAuth 2.0, ou adresses IP autorisées |
| Limites d'appels | Zendesk demande si votre système en a |
Le rôle de l'intégrateur : une API taillée pour l'agent
Brancher l'agent directement sur l'API complète d'un ERP (progiciel de gestion intégré) ou d'un CRM (logiciel de gestion de la relation client) revient à lui donner bien plus que nécessaire. La méthode plus sûre : exposer une petite API intermédiaire avec seulement les opérations prévues au cadrage.
| Opération exposée | Lecture ou écriture | Garde-fou |
|---|---|---|
| Dernières commandes d'un client | Lecture | Identification préalable du client |
| Statut et lien de suivi d'une commande | Lecture | Seulement les commandes de ce client |
| Changement d'adresse de livraison | Écriture | Vérification e-mail + référence, journal, refus si la commande est expédiée |
| Création d'un ticket de réclamation | Écriture | Champs limités, pas de montant |
Cette API intermédiaire répond aussi à l'exigence des 30 secondes : si le système du client est lent, c'est elle qui met en cache ou renvoie un message d'attente. Elle porte le journal des appels, que l'ANSSI recommande pour tout système d'IA (voir Droits d'accès).
Les pannes fréquentes, d'après l'aide Zendesk
L'article de dépannage de la connexion avec les agents IA classe les problèmes en trois familles :
- L'agent ne rejoint pas les conversations : moteur d'automatisation désactivé, routage incorrect (compte, service, identifiant du bot), compte bot non autonome, identifiant de service erroné, absence de modèle IA.
- Les transferts vers un agent humain échouent : agents hors ligne, nombre maximal de chats atteint, transfert hors des horaires d'ouverture.
- L'ajout de marqueurs échoue : le type de donnée ne correspond pas à ce que le champ accepte, par exemple un champ qui n'accepte que du texte.
La deuxième famille relève autant de l'organisation que de la technique : qui prend le relais, à quelles heures, avec quelles informations. Ces questions sont traitées sur la page transfert vers un humain de chatbot.alaisia.fr.
Points à vérifier avant de chiffrer
- L'offre Zendesk du client.
- La liste fermée des opérations à exposer, lecture et écriture séparées.
- Le temps de réponse réel du système du client, à mesurer.
- La méthode d'authentification retenue et le renouvellement des secrets.
- Les horaires et la capacité de l'équipe qui reçoit les transferts.
- Un environnement de test pour l'API intermédiaire (voir Sandbox CRM).
Questions fréquentes
Quelles offres Zendesk permettent une intégration personnalisée pour un agent IA ?
D'après l'aide Zendesk lue le 15/11/2026 : Suite Team, Growth, Professional, Enterprise ou Enterprise Plus, et Support Team, Professional ou Enterprise.
Quelles contraintes doit respecter l'API du client ?
Une architecture REST ou GraphQL, une réponse en moins de 30 secondes, du JSON de préférence, et l'une des authentifications listées par Zendesk (clé API, jeton porteur, authentification de base, OAuth 2.0, adresses IP de confiance…).
Sources
Pages consultées pour écrire cet article :