En termes simples, le widget « Sonner vers (via API) » de routage intelligent utilise une réponse API pour savoir vers quelle équipe Aircall, quel utilisateur, quel numéro interne ou quel numéro externe appeler en fonction de données externes à Aircall.
Bien que « Sonner vers (via API) » soit un widget flexible qui peut être utilisé pour réaliser un certain nombre de flux de travail souhaités basés sur plusieurs plateformes externes, dans ce tutoriel, nous examinerons un exemple d'utilisation de l'API Aircall pour acheminer dynamiquement les appels vers un utilisateur Aircall.
⚠️ Vous devez être abonné au forfait Professionnel pour accéder au widget « Sonner vers (via API) » dans votre éditeur Smartflows. Si vous souhaitez effectuer une mise à niveau, veuillez contacter votre gestionnaire de compte.
Prérequis
Avant de configurer le widget Ring to (via API), assurez-vous de disposer des éléments suivants :
Informations d'authentification
La méthode d'authentification dépend de la plateforme externe dont vous prévoyez de récupérer les données. Ring to (via API) prend actuellement en charge l'authentification de base, le jeton porteur, la clé API et OAuth.
Dans cet exemple, en utilisant l'API Aircall comme exemple, nous utiliserons la méthode d'authentification de base. Nous allons générer une clé API en accédant à la section « Intégrations & API » du tableau de bord, en cliquant sur l'onglet « Clés API » et en générant la clé.
📚 Où trouver ma clé API Aircall
Nous allons maintenant enregistrer l'ID et le jeton de la clé API, puis dans la configuration du widget Ring to (via API), nous irons dans « Informations d'identification » et définirons l'ID de la clé API comme nom d'utilisateur et le jeton comme mot de passe.
Connaissance de l'API de la plateforme
En fonction de la plateforme à partir de laquelle vous souhaitez récupérer des données, il est important de bien comprendre ce qui est inclus dans l'API publique de cette plateforme.
Cette documentation utilisera l'API Aircall comme exemple, mais les utilisateurs peuvent utiliser d'autres plateformes partenaires telles que HubSpot, Salesforce, Zendesk, Intercom, Pipedrive ou des CRM internes comme plateformes où les données sont demandées pour prendre des décisions de routage.
Connaissance de JSON
Ring to (via API) utilise également JSON, ou JavaScript Object Notation, un format textuel standard couramment utilisé pour transmettre des données entre des applications Web.
Nous vous recommandons de vous familiariser avec les concepts de base de JSON avant de tenter de configurer le widget Ring to (via API).
Si vous avez besoin d'aide pour la configuration du widget Ring to (via API), l'équipe des services professionnels Aircall est en mesure de fournir des conseils techniques et une mise en œuvre pratique pour le succès.
Considérations d'utilisation
Le widget Ring to (via API) offre de puissantes fonctionnalités en permettant un routage d'appels dynamique (« intelligent ») basé sur les données récupérées de votre système externe. Le widget peut interroger pratiquement n'importe quel système externe ou base de données que vous définissez (à condition qu'il prenne en charge une API REST basée sur le Web et des méthodes d'authentification standard) et, plus important encore, acheminer l'appelant entrant en fonction de la réponse de la requête/requête API — c'est essentiel.
La réponse de l'API doit renvoyer des données dans un format qu'Aircall peut interpréter et utiliser pour le routage. Les types de réponses pris en charge incluent :
- Utilisateur : achemine vers un agent spécifique en fonction de l’ID utilisateur ou de l’adresse e-mail d’Aircall
- Équipe : achemine vers une équipe spécifique en fonction de l’ID d’équipe d’Aircall
- Numéro Aircall : achemine en interne vers un autre numéro Aircall en fonction de l’ID du numéro Aircall
- Numéro externe : achemine en externe vers un numéro de téléphone spécifié (doit être au format international E.164)
Et si vous deviez ajouter une logique avancée supplémentaire au routage avant de transférer l’appel entrant au numéro nécessaire utilisateur, équipe ou numéro (par exemple, branchement conditionnel, boucles, etc.) ?
Essentiellement, vous devez gérer la logique avancée de qui ou où acheminer l'appelant entrant en dehors d'Aircall . Ce n'est que lorsque la décision finale est prise que vous devez présenter l'une des options ci-dessus dans le cadre de la charge utile de la réponse de l'API.
En d'autres termes, il s'agit d'un widget simple qui pose la question : « Vers qui ou où dois-je acheminer l'appelant entrant ? ». Il ne prend en compte aucune logique complexe (par exemple, si ceci, alors cela, mais vérifiez ceci d'abord, etc.). La logique complexe doit d'abord être gérée/traitée en dehors d'Aircall ; après, la réponse à la question est ce qui doit être présenté au widget.
Étapes de configuration
Le comportement final du widget Sonner à (via l'API) est qu'il choisira de sonner soit un utilisateur Aircall, une équipe Aircall, un numéro Aircall ou un numéro externe à Aircall.
Dans cet exemple, nous allons examiner la possibilité de sonner un utilisateur Aircall en utilisant le point de terminaison Rechercher des appels de l' API Aircall .
L'API, ou la section de l'API, que nous choisissons d'utiliser déterminera si nous sélectionnons GET ou POST comme « Méthode » dans la configuration Sonner à (via l'API). Dans ce cas, comme nous utiliserons le point de terminaison Search Calls de l'API Aircall, nous choisirons GET comme méthode.
Pour l'URL, nous utiliserons l'exemple suivant :
https://api.aircall.io/v1/calls/search?order=des & phone_number= {{callerNumber}}
Sur la base de cette URL, Ring to (via l'API) recherchera les numéros de téléphone par ordre décroissant, c'est-à-dire en commençant par les appels les plus récents. Aircall utilise presque toujours des numéros de téléphone ou des adresses e-mail comme identifiant unique sur les plateformes partenaires. Il s'agit donc d'une URL courante qui peut être utilisée pour rechercher un numéro de téléphone pertinent.
D'autres variables qui pourraient être incluses dans cette URL sont répertoriées sous les paramètres de requête dans la documentation de l'API Aircall pour les appels de recherche .
Configuration de la réponse
Nous allons maintenant examiner la section « Configuration de la réponse » du widget Sonner à (via l'API).
Les types de réponse pris en charge sont :
- Utilisateur (ID ou e-mail)
- Équipe (ID)
- Numéro Aircall (interne)
- Numéro externe
Tout comme le widget Ring to standard, le type de réponse déterminera à qui les appels entrants sont dirigés. « Utilisateur » appellera un agent Aircall individuel, « Équipe » appellera une équipe Aircall, « Numéro Aircall » appellera un autre numéro Aircall et « Numéro externe » appellera un numéro extérieur à Aircall.
La section « Chemin » analysera la réponse fournie par l'API. Étant donné que nous exploitons le point de terminaison « Rechercher des appels » de l'API Aircall, nous pouvons voir la réponse dans la documentation de l'API Aircall.
Prenons l'exemple suivant :
calls[0].user.id
En consultant la documentation de l'API Aircall, nous pouvons voir que le chemin fait référence à la section « appels » de la réponse, chaque point faisant référence à une sous-section de la section « appels » (dans ce cas, la valeur « utilisateur » et « id »). La valeur 0, contenue entre parenthèses, est un tableau qui indique que la réponse commencera par le premier appel de la liste.
Nous pouvons ensuite nous assurer que le chemin que nous avons choisi est correct via la section « Tester la réponse » du widget Sonner à (via l'API) en saisissant un numéro de téléphone sur lequel nous souhaitons exécuter la requête.
Veuillez vous assurer que le numéro saisi dans le champ « Réponse au test » est au format E.164 .
En cas d'erreur, veuillez consulter la section Erreurs de la documentation de l'API Aircall qui indique la raison de l'erreur et aide au dépannage.
Enfin, nous pouvons configurer les paramètres de sonnerie, qui sont identiques aux paramètres de sonnerie du widget standard Sonnerie. Pour plus d'informations sur les paramètres de sonnerie, veuillez consulter notre article du centre d'aide sur le routage des appels .
Si avez besoin d'aide pour la configuration du widget Ring to (via API), l'équipe des services professionnels Aircall est en mesure de fournir des conseils techniques et une mise en œuvre pratique pour garantir le succès.