En termes simples, le widget Smart Routing « Sonner vers (via API) » 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 des données qui se trouvent en dehors d'Aircall.
Bien que Ring to (via API) soit un widget flexible qui peut être utilisé pour obtenir un certain nombre de flux de travail souhaités en fonction d'un certain nombre de plates-formes externes, dans ce didacticiel, nous examinerons un exemple utilisant l'API Aircall pour acheminer dynamiquement les appels vers un utilisateur Aircall.
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 générerons 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 d'avoir une bonne compréhension de 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 (
API), équipe de services professionnels d' est en mesure de fournir des conseils techniques et une mise en œuvre pratique pour garantir le succèsConsidérations d'utilisation
Le widget Ring to (via API) offre des fonctionnalités puissantes en permettant un routage d'appel dynamique (« intelligent ») basé sur les données récupérées à partir 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, surtout, acheminer l'appelant entrant en fonction de la réponse de la requête/requête API — c'est la clé.
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éponse pris en charge sont les suivants :
- Utilisateur : routes vers un agent spécifique en fonction de l'ID utilisateur Aircall ou de l'e-mail
- Équipe : itinéraires vers une équipe spécifique en fonction de l'ID de l'équipe Aircall
- Numéro Aircall : route en interne vers un autre numéro Aircall en fonction de l'ID du numéro Aircall
- Numéro externe : routes externes vers un numéro de téléphone spécifié (doit être au format international E.164)
Et si vous avez besoin d'ajouter une logique avancée supplémentaire au routage avant de transférer l'appel entrant à l'utilisateur, à l'équipe ou au numéro nécessaire (par exemple, branchement conditionnel, boucles, etc.) ?
En substance, vous devez gérer la logique avancée de la personne ou de l'endroit vers lequel diriger l'appelant entrant en dehors d'Aircall . Ce n'est qu'une fois la décision finale 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 diriger l'appelant entrant ? ». Il ne prend en compte aucune logique complexe (par exemple, si ceci, alors cela, mais vérifiez d'abord ceci, etc.). La logique complexe doit d'abord être gérée/traitée en dehors d'Aircall. Ensuite, la réponse à la question est ce qui doit être présenté au widget.
Étapes de configuration
Le comportement final du widget Sonner vers (via API) est qu'il choisira de sonner soit vers un utilisateur Aircall, une équipe Aircall, un numéro Aircall ou un numéro externe en dehors d'Aircall.
Dans cet exemple, nous allons examiner l'appel d'un utilisateur Aircall en utilisant le point de terminaison Recherche d'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 Ring to (via 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 ce qui suit comme exemple :
https://api.aircall.io/v1/calls/search?order=des & phone_number= {{callerNumber}}
Sur la base de cette URL, Ring to (via API) recherchera les numéros de téléphone par ordre décroissant, ce qui signifie qu'il recherchera à partir des 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 de recherche d'appels .
Configuration de la réponse
Nous allons maintenant examiner la section « Configuration de la réponse » du widget Sonner vers (via API).
Les types de réponses pris en charge sont :
- Utilisateur (ID ou email)
- Équipe (ID)
- Numéro d'appel aérien (interne)
- Numéro externe
Tout comme le widget Sonner à standard, le type de réponse détermine à qui sont adressés les appels entrants. « Utilisateur » sonnera vers un agent Aircall individuel, « Équipe » sonnera vers une équipe Aircall, « Numéro Aircall » sonnera vers un autre numéro Aircall et « Numéro externe » sonnera vers 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 regardant 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 « Test de réponse » du widget Ring to (via 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 Ring to standard. Pour plus d'informations sur les paramètres de sonnerie, veuillez consulter notre article du centre d'aide sur le routage des appels .
Si vous avez besoin d'aide pour la configuration du widget Ring to (via API), l'équipe de services professionnels d'Aircall 's Professional Services est en mesure de fournir des conseils techniques et une mise en œuvre pratique pour garantir le succès.