Configurez le routage intelligent sur un numéro de téléphone partagé afin que les appelants soient efficacement mis en relation avec leur point de contact grâce au widget Ring-to (via API) dans un flux d'appel, avec une authentification OAuth Zendesk.
Remarque: Zendesk abandonne les jetons API comme méthode d’authentification. Cet article utilise OAuth, la méthode de remplacement. Si vous utilisez actuellement un jeton API pour cette configuration, consultez la section Pourquoi cet article utilise OAuth plutôt qu’un jeton API ci-dessous.
Remarque: Le tutoriel vidéo peut présenter l’ancienne version de la section Tester la réponse. Référez-vous toujours aux étapes écrites de cet article pour obtenir les instructions les plus récentes.
Dans ce guide, vous découvrirez :
Pourquoi cet article utilise OAuth plutôt qu’un jeton API.
- Comment l’utilisation du widget Ring-to (via API) améliore l’efficacité et l’expérience client.
- Comment configurer le routage intelligent vers le propriétaire du contact Zendesk.
- Première étape : créer le champ utilisateur personnalisé dans Zendesk
- Deuxième étape : créer un client OAuth confidentiel dans Zendesk
- Troisième étape : configurer le widget Ring-to (via API) dans l’éditeur de flux
- Quatrième étape : tester la configuration
Remarque: Le widget Ring-to (via API) est uniquement disponible avec le forfait Professional. Si vous ne disposez pas du forfait Professional, contactez votre chargé de compte pour obtenir de l’aide.
Pourquoi cet article utilise OAuth plutôt qu’un jeton API
Zendesk abandonne progressivement les jetons API comme méthode d’authentification pour les requêtes de l’API de support, au profit d’OAuth. Les jetons API existants continueront de fonctionner pendant une période de transition, mais Zendesk finira par les désactiver entièrement.
Important: Si ce routage fonctionne déjà avec un jeton API, n’attendez pas qu’il cesse de fonctionner. Créez la configuration OAuth sur un deuxième widget Ring-to (via API), vérifiez qu’elle fonctionne, puis basculez votre widget actif vers celle-ci. Consultez la section « Mise en service » ci-dessous pour connaître les étapes de basculement.
Le widget Ring-to (via API) s’authentifie auprès de Zendesk à l’aide du flux d’octroi des identifiants du client OAuth. Aircall demande un jeton d’accès à votre compte Zendesk à l’aide de votre ID client et de votre secret client, puis envoie ce jeton à l’API Zendesk sous forme d’en-tête Authorization: Bearer. Aircall met le jeton en cache et en demande automatiquement un nouveau lorsqu’il expire. Aucun jeton ne doit donc être renouvelé manuellement.
Remarque: Pour connaître le calendrier exact de l’abandon de cette méthode par Zendesk, consultez l’annonce de Zendesk concernant la suppression des jetons API.
Comment l’utilisation du widget Ring-to (via API) améliore l’efficacité et l’expérience client
Le routage intelligent sur un numéro de téléphone partagé offre des avantages considérables en améliorant l’efficacité, la précision et l’expérience client. En dirigeant intelligemment les appels entrants selon les données du CRM, le routage intelligent garantit que chaque appelant est rapidement mis en relation avec l’agent le plus approprié, ce qui réduit les temps d’attente et améliore les taux de résolution au premier appel.
Avec le widget Ring-to (via API) d’Aircall dans un flux d'appel, un cas d’utilisation courant consiste à diriger les appels entrants des clients VIP directement vers leur propriétaire du contact Zendesk (agent dédié du support client). Cela évite que toute l’équipe soit interrompue par des appels clients qui ne la concernent pas et qu’il soit nécessaire de mettre les appelants en attente pendant leur transfert vers l’agent qui leur est attribué.
Comment configurer le routage intelligent vers le propriétaire du contact Zendesk
Première étape : créer le champ personnalisé dans Zendesk
Important: Cette étape nécessite une bonne connaissance des champs personnalisés et des méthodes d’authentification de Zendesk.
Commencez dans Zendesk en créant une propriété personnalisée pour stocker l’adresse e-mail du propriétaire du contact.
-
Dans le Centre d’administration Zendesk, accédez à Contacts → Configuration → Champs utilisateur, puis sélectionnez Ajouter un champ.
Type de champ : Texte
Nom d’affichage : E-mail du propriétaire
Clé du champ : owner_email
-
Le champ sera automatiquement ajouté à tous les profils d’utilisateurs finaux. Une fois qu’il a été créé et qu’il est visible sur le profil de l’utilisateur final, renseignez-y une adresse e-mail. Vous en aurez besoin ultérieurement pour tester la validité du chemin dans le widget Ring-to (via API).
Remarque: L’adresse e-mail saisie doit correspondre à celle d’un utilisateur Aircall existant, sinon l’appel ne pourra pas lui être acheminé.
Deuxième étape : créer un client OAuth confidentiel dans Zendesk
Important: L’octroi des identifiants client est uniquement disponible pour les clients OAuth confidentiels. Un client public ne peut pas être utilisé pour cette configuration. Vous devez disposer de droits d’administration Zendesk pour créer un client OAuth.
- Dans le Centre d’administration Zendesk, accédez à Applications et intégrations > API > Clients OAuth, puis cliquez sur Ajouter un client OAuth.
- Renseignez les champs :
- Nom : le nom de votre choix, par exemple « Aircall - Transférer vers (via API) »
- Identifiant : renseigné automatiquement à partir du nom. Cette valeur correspond à votre ID client. Vous pouvez la modifier si vous le souhaitez.
- Type de client : Confidentiel. Ce choix est obligatoire.
-
URL de redirection : l’octroi des identifiants client n’utilise pas cette valeur. Si le formulaire ne peut pas être enregistré sans URL, saisissez une URL HTTPS absolue telle que
https://localhost. - Portées : facultatif. Si vous laissez ce champ vide, le client peut demander n’importe quelle portée. Si vous le renseignez, il définit une limite : le widget ne peut pas demander de portée ne figurant pas dans cette liste. Dans ce cas, incluez la portée que vous saisirez dans le widget à la troisième étape.
- Faire expirer les jetons : vous pouvez laisser ce réglage tel quel. Pour les clients OAuth créés à partir du 30 avril 2026, la case est désactivée, car les jetons émis par ces clients expirent déjà par défaut.
- Cliquez sur Enregistrer. La page s’actualise et un champ Secret apparaît.
- Copiez l’identifiant et le secret, puis conservez-les en lieu sûr.
Important: Le secret ne s’affiche intégralement qu’une seule fois. Une fois la page quittée, seuls ses neuf premiers caractères restent visibles. Si vous le perdez, vous devrez créer un nouveau client OAuth.
Important: Les actions effectuées avec un jeton d’identifiants client sont attribuées à l’utilisateur Zendesk ayant créé le client OAuth, généralement un administrateur. Cela affecte vos journaux d’audit. Cela signifie également que si cet utilisateur est ensuite supprimé, rétrogradé ou perd de toute autre manière les autorisations nécessaires pour gérer les clients OAuth, les jetons émis par ce client cessent de fonctionner et ce routage échoue. Si l’un de ces points est important pour vous, créez le client OAuth depuis un compte de service dédié avant de continuer.
Troisième étape : configurer le widget Transférer vers (via API) dans l’éditeur de flux
Important: Cette étape nécessite une bonne connaissance de l’API REST Zendesk et des flux d’appel.
Accédez à Tableau de bord Aircall > Numéros, puis ouvrez le numéro du flux d’appel à configurer.
Il est important de noter que les utilisateurs Aircall vers lesquels les appels seront acheminés via l’API n’ont pas besoin d’être affectés à la configuration du flux d’appel. S’ils y sont affectés, ils recevront les notifications d’appels manqués dans leur liste de tâches s’ils manquent l’appel transféré. Cependant, ils ne recevront pas ces notifications s’ils ne sont pas affectés au numéro.
- Accédez au numéro de téléphone sur lequel vous souhaitez configurer le widget Transférer vers (via API). Ajoutez le widget Transférer vers (via API) à l’emplacement souhaité dans la configuration de votre flux d’appel afin d’ouvrir l’éditeur du widget.
-
Définissez Authentification sur OAuth, puis cliquez sur Définir les identifiants. Remplissez le formulaire d’identifiants comme suit :
URL de connexion https://MyDomainName.zendesk.com/oauth/tokens(remplacezMyDomainNamepar votre sous-domaine Zendesk ; utilisez votre sous-domaine Zendesk principal et non un domaine mappé à un hôte)ID client L’identifiant de votre client OAuth Secret client Le secret de votre client OAuth Portée users:read readpour commencer. Zendesk ne publie pas de correspondance entre les portées et les points de terminaison. Considérez donc cette valeur comme un point de départ et confirmez-la à l’aide du test de la quatrième étape. Si le test renvoie une erreur de portée, Zendesk indique les portées requises ; saisissez-les exactement.
-
Quelques conseils pour configurer OAuth :
- Sélectionnez d’abord la valeur d’authentification, puis saisissez les identifiants. La modification de l’option d’authentification efface tous les identifiants déjà enregistrés dans le widget, et vous devrez les saisir de nouveau.
- Si le champ Portée n’apparaît pas dans le formulaire d’identifiants OAuth, actualisez votre tableau de bord Aircall. Le champ Portée est obligatoire pour Zendesk. Sans celui-ci, Zendesk rejette la demande de jeton.
- Les éléments de la liste des portées sont séparés par des espaces. Choisissez l’ensemble le plus restreint qui fonctionne. Il a été observé que Zendesk exige une portée générale « read » en plus de la portée propre à la ressource, raison pour laquelle « users:read read » est suggéré ci-dessus.
-
Revenez dans l’éditeur du widget et complétez la configuration de la requête :
URL :
https://MyDomainName.zendesk.com/api/v2/users/search.json?query={{callerNumber}}
(Remplacez « MyDomainName » par le nom de domaine réel de votre instance Zendesk.)Méthode : GET
-
Configurez les paramètres de réponse comme suit :
Type de réponse : Utilisateur (ID ou adresse e-mail)
Chemin :
users[0].user_fields.owner_email
Quatrième étape : tester la configuration
Effectuez un test dans le champ dédié Tester la réponse :
Saisissez un numéro de téléphone valide au format international E.164.
Vérifiez qu’une charge utile JSON est renvoyée.
Confirmez que le Chemin permet bien de trouver la valeur utilisée pour acheminer l’appel entrant.
Vérifiez que l’adresse e-mail du contact existant correspond à celle d’un utilisateur Aircall existant.
Conseil: :
Ajustez les paramètres de sonnerie situés directement sous le champ de test en fonction des besoins de votre activité.
Vous pouvez maintenant commencer à tester les appels entrants afin de vérifier le routage intelligent vers le propriétaire du contact Zendesk à l’aide du widget Ring-to (via API).
Mise en production
Une fois vos tests terminés et le routage opérationnel comme prévu, veillez à renseigner le champ Adresse e-mail du propriétaire dans Zendesk pour chaque profil d’utilisateur final dont vous souhaitez acheminer automatiquement les appels.
Si vous utilisiez auparavant un jeton d’API pour authentifier ce widget, utilisez maintenant les identifiants OAuth pour votre widget en production, puis supprimez l’ancien jeton d’API du Centre d’administration Zendesk après avoir vérifié que la configuration OAuth fonctionne.
Résolution des problèmes
| Symptôme | Cause et solution |
|---|---|
| Erreur lors de la demande du jeton d’accès, ou erreur HTTP 401 lors de la recherche | Les identifiants ont été refusés. Vérifiez que le client OAuth est de type Confidentiel et que l’ID client correspond exactement à l’Identifiant. Si le Secret a été copié à nouveau après avoir quitté la page du Centre d’administration, il est tronqué à neuf caractères : créez un nouveau client et utilisez le Secret complet. |
| Un test ou un appel isolé échoue, puis le même test réussit immédiatement après | Cela peut se produire au moment où un jeton d’accès mis en cache expire et est renouvelé. Relancez le test. Si le problème se reproduit systématiquement plutôt qu’occasionnellement, considérez qu’il s’agit réellement d’un problème d’identifiants ou de portée et suivez les lignes ci-dessous. |
{"error":"Forbidden","description":"You are missing the following required scopes: ..."} | Le jeton a été émis, mais il ne dispose pas de la portée requise par le point de terminaison. Modifiez les identifiants OAuth du widget et définissez Portée sur les portées indiquées dans le message d’erreur. |
Erreur HTTP 400 avec invalid_scope
| La portée demandée par le widget ne figure pas dans la liste des Portées configurées pour le client OAuth dans Zendesk. Ajoutez la portée aux portées autorisées du client ou modifiez la Portée du widget pour qu’elle reste dans les limites autorisées. |
| Les identifiants semblent avoir été effacés | La modification de la sélection Authentification efface les identifiants enregistrés. Saisissez-les à nouveau après avoir sélectionné la méthode. |
| Le test renvoie une charge utile, mais l’appel n’est pas acheminé | La valeur du Chemin configuré doit correspondre à un utilisateur Aircall existant. Vérifiez que la valeur Adresse e-mail du propriétaire du profil Zendesk correspond à l’adresse e-mail d’un utilisateur Aircall. |
| Le routage fonctionnait auparavant, mais ne fonctionne plus sans que la configuration ait été modifiée | Vérifiez que l’utilisateur Zendesk ayant créé le client OAuth existe toujours et qu’il est toujours autorisé à gérer les clients OAuth. Les jetons d’identification du client agissent au nom de cet utilisateur et cessent de fonctionner si celui-ci perd cet accès. |
Services professionnels
Si vous avez besoin d’aide supplémentaire pour mettre en œuvre cette configuration de routage intelligent ou souhaitez découvrir des automatisations similaires pour améliorer vos opérations, consultez notre équipe chargée de la réussite client afin de réserver un créneau avec nos consultants techniques.