Skip to main content

​
À quoi ça sert

L’intégration Zendesk relie votre outil de support à vos agents vocaux. Pendant l’appel, l’agent peut chercher un ticket, retrouver un utilisateur et ouvrir un ticket avec un sujet, une description et un demandeur. Comme pour les autres intégrations, vous branchez votre propre compte : Bookivox ne fournit aucun identifiant. Vous saisissez le sous-domaine de votre espace Zendesk, l’e-mail de votre compte et un jeton API, puis vous cochez les actions.
Cette intégration écrit réellement dans Zendesk : un ticket créé apparaît dans votre file d’attente. Le client fournit sa propre clé ; Bookivox ne fournit aucun identifiant.

​
Ce qu’il faut préparer

L’identifiant Basic Auth envoyé à Zendesk est votre e-mail suivi de /token. Bookivox ajoute ce suffixe automatiquement : saisissez l’e-mail seul, sans /token.

​
Connecter Zendesk

1

Créer le jeton API

Dans le Centre d’administration Zendesk, ouvrez Applications et intégrations → API et créez un jeton. Copiez-le immédiatement.
2

Relever le sous-domaine

Regardez l’adresse à laquelle vous vous connectez. Pour acme.zendesk.com, le sous-domaine est acme.
3

Saisir le compte et la clé

Dans Intégrations → Zendesk, renseignez le sous-domaine, l’e-mail du compte, puis collez le jeton API. Le formulaire valide le format de chaque champ.
4

Cocher les actions

Sélectionnez les actions à exposer. Chacune devient un outil indépendant.
5

Vérifier la connexion

Cliquez sur Créer les outils. Un bandeau vert confirme la création et indique le nombre d’outils créés. Le jeton disparaît du formulaire : il reste chiffré et n’est plus jamais réaffiché.
6

Compléter la connexion

La carte Connexions Zendesk liste les comptes reliés à l’organisation avec leur état (Complète ou Partielle). Le bouton Créer ajoute une action manquante sans ressaisir les identifiants.

​
Ce que l’agent peut faire

Chaque action crée un outil distinct : vous pouvez n’en activer qu’une partie, et n’attacher à un agent que celles dont il a besoin.
La recherche Zendesk accepte une syntaxe de requête (type:ticket status:open) ou un numéro de ticket. Pour un ticket, demandez ce numéro au client avant d’appeler l’outil.

​
Cas d’usage

​
Comment ça marche

  1. Bookivox crée une credential basic_auth dont l’utilisateur est <e-mail>/token et le mot de passe le jeton API.
  2. Le sous-domaine est normalisé puis figé dans l’URL de l’outil : https://<sous-domaine>.zendesk.com/api/v2.
  3. Le suffixe .json fait partie du chemin de chaque endpoint : /search.json, /users/search.json, /tickets.json.
  4. Un outil http_api par action est créé, avec config.provider = "zendesk", config.operation et un timeout de 10 000 ms.
  5. Les résultats sont bornés à 100 par page, et la recherche Zendesk est plafonnée à 1 000 résultats au total. Le preset n’expose pas de paramètre de page : au-delà de la première page, la requête (page=11) renvoie 422.
  6. Pour un ticket, l’objet ticket transmet le sujet, la description (champ obligatoire) et le demandeur.

​
Rédiger la description de l’outil

La description de l’outil est ce qui décide quand l’agent appelle Zendesk. Rédigez-la comme une consigne :
Si vous exposez Rechercher des tickets et Créer un ticket, précisez dans le prompt de chercher d’abord un ticket ouvert avant d’en créer un nouveau. Sans cette consigne, l’agent ouvre des doublons.

​
Sécurité

Faites tourner votre jeton avant le 28 juillet 2026 : un jeton inutilisé est désactivé à cette date, puis supprimé le 30 avril 2027. Une fois le nouveau jeton créé, recréez la connexion Bookivox pour l’enregistrer.

​
Ce qui est déconseillé

​
Limites et dépannage

Zendesk n’est pas relié ici par un serveur MCP : chaque action est un outil HTTP distinct, ce qui permet à l’agent de choisir précisément une action plutôt que d’appeler un serveur générique.

Intégrations

Toutes les intégrations et les catégories d’outils.

API HTTP

Comprendre les outils HTTP : paramètres, presets, credentials.
Last modified on November 3, 2026