Le widget Routage intelligent : Sonner vers (via API) utilise une réponse API pour déterminer vers quel utilisateur Aircall, quelle équipe, quel numéro interne ou quel numéro externe acheminer un appel, selon les données stockées en dehors d’Aircall.

Ce widget offre des fonctionnalités puissantes et flexibles de routage dynamique en connectant Aircall à des systèmes tiers tels que des CRM ou des Helpdesks.

Important: Le widget Sonner vers (via API) est disponible uniquement avec le forfait Professional. Pour passer à ce forfait, contactez votre responsable de compte Aircall.

Prérequis

Avant de configurer le widget, assurez-vous que les conditions suivantes sont remplies.

Identifiants d’authentification

La méthode d’authentification dépend de la plateforme externe dont vous souhaitez récupérer les données. Les méthodes prises en charge incluent :

  • Authentification de base
  • Jeton Bearer
  • Clé API
  • OAuth

Exemple (API Aircall) :

  1. Accédez à Intégrations > Clés API dans le tableau de bord Aircall.
  2. Générez une nouvelle clé API.
  3. Enregistrez l’identifiant de la clé API et le jeton.
  4. Dans la configuration du widget Sonner vers (via API), accédez à Identifiants, puis définissez :
    • Nom d’utilisateur = identifiant de la clé API
    • Mot de passe = jeton API

Pour en savoir plus sur la recherche de votre clé API Aircall, consultez notre article Où trouver ma clé API Aircall.

Connaissance de l’API de la plateforme

Vous devez comprendre la structure et les points de terminaison de l’API publique de la plateforme externe.

Bien que l’article Où trouver ma clé API Aircall utilise l’API Aircall comme exemple, vous pouvez également utiliser des plateformes telles que HubSpot, Salesforce, Zendesk, Intercom, Pipedrive ou des CRM internes.

Connaissance de JSON

Le widget utilise JSON (JavaScript Object Notation) pour échanger des données avec les API. Vous devez connaître les structures JSON de base afin de configurer correctement les chemins d’accès aux données.

Conseil: Si vous avez besoin d’aide pour configurer le widget, notre équipe technique peut vous proposer des services de conseil et d’assistance à la mise en œuvre. Contactez notre équipe de gestion des comptes.

Considérations relatives à l’utilisation

Le widget Sonner vers (via API) permet un routage d’appels dynamique (« intelligent ») reposant sur des données externes. Il peut interroger tout système prenant en charge les API REST et les méthodes d’authentification standard.

Remarque: Les requêtes effectuées par Sonner vers (via API) expirent après 10 secondes. Assurez-vous que votre point de terminaison répond dans ce délai, sans quoi le widget risque de ne pas pouvoir récupérer la cible de routage.

La réponse API doit renvoyer des données dans un format qu’Aircall peut interpréter pour le routage. Les types de réponses pris en charge incluent :

Type de réponseDescription
UtilisateurAchemine l’appel vers un agent spécifique à l’aide de son identifiant utilisateur Aircall ou de son adresse e-mail.
ÉquipeAchemine l’appel vers une équipe Aircall spécifique à l’aide de son identifiant d’équipe.
Numéro AircallAchemine l’appel en interne vers un autre numéro Aircall à l’aide de son identifiant de numéro.
Numéro externeAchemine l’appel en externe vers un numéro de téléphone (qui doit être au format international E.164).
Cible dynamique (identifiant)Permet à votre API externe de spécifier dynamiquement le type et l’identifiant de la cible.

Lorsque vous utilisez une cible dynamique (identifiant), vous devez définir deux chemins JSON dans le widget :

  • Chemin vers le type de cible (utilisateur, équipe, numéro ou externe)
  • Chemin vers la valeur de la cible (l’identifiant unique de la cible)
Remarque: Pour les réponses de type Cible dynamique, le widget accepte uniquement les valeurs suivantes pour le type de cible : agent, team, internal et external.

Si la cible déterminée est une équipe, les règles de sonnerie standard s’appliquent. S’il s’agit d’un utilisateur ou d’un numéro, ces règles ne s’appliquent pas.

Toute logique avancée (par exemple, routage conditionnel ou hiérarchisation) doit être traitée dans votre système externe avant le renvoi de la réponse API.

Étapes de configuration

Le widget détermine s’il doit faire sonner un utilisateur, une équipe, un numéro Aircall, un numéro externe ou une cible dynamique (identifiant) selon l’appel API configuré.

Étapes :

  1. Dans l’éditeur de flux, ajoutez un widget Sonner vers (via API).
  2. Choisissez la méthode HTTP (GET ou POST), selon la section de l’API que vous souhaitez utiliser.
    • Exemple : lorsque vous utilisez le point de terminaison Rechercher des appels de l’API Aircall, sélectionnez GET.

  3. Saisissez l’URL de l’API, par exemple :

    https://api.aircall.io/v1/calls/search?order=desc&phone_number={{callerNumber}}

    Cette requête recherche les appels les plus récents associés au numéro de téléphone de l’appelant.

  4. Utilisez des variables telles que callerNumber, targetNumber ou callUUID pour insérer dynamiquement des données propres à l’appel dans votre requête. Consultez la documentation de l’API Aircall pour obtenir la liste complète des paramètres de requête.

Configuration de la réponse

Dans la section Configuration de la réponse, définissez la manière dont la réponse API sera analysée afin de déterminer la cible de routage.

Types de réponses pris en charge :

  • Utilisateur (identifiant ou e-mail)
  • Équipe (identifiant)
  • Numéro Aircall (interne)
  • Numéro externe (format E.164)
  • Cible dynamique (identifiant)

Exemple de chemin JSON :

calls[0].user.id

Ce chemin fait référence au premier élément du tableau « calls » et récupère l’ID de l’utilisateur.

Exemple de réponse JSON de la cible dynamique :

{
  "calls": [
    {
      "target_type": "team",
      "target_id": 12345
    }
  ]
}
  • Chemin vers le type de cible : calls[0].target_type
  • Chemin vers la valeur de la cible : calls[0].target_id

Si le type de cible est team, les règles de sonnerie seront appliquées en conséquence.

Tester la configuration

Utilisez le champ Tester la réponse pour simuler des requêtes API et vérifier que les chemins configurés renvoient les valeurs correctes.

Exemple d’entrée de test :

{
  "callerNumber": "+15551234567",
  "targetNumber": "+15557654321",
  "callUUID": "abcd-1234-efgh-5678",
  "lineId": 12345
}

Chaque clé du JSON correspond à une variable utilisée dans votre URL ou le corps de votre requête. Lorsque vous exécutez le test, le widget remplace ces variables et affiche les résultats analysés.

Si une erreur se produit, consultez la section Erreurs de la documentation de l’API Aircall pour obtenir des conseils de dépannage.

Réglages de la sonnerie

Après avoir configuré et testé votre intégration API, ajustez les réglages de la sonnerie afin de définir la distribution des appels. Ces réglages fonctionnent de la même manière que ceux du widget standard Faire sonner.

Pour plus de détails, consultez notre article du Centre d’aide Présentation du routage des flux d’appel

Conseil: :
Si vous souhaitez tirer parti de cette fonctionnalité, mais ne disposez pas de l’expertise technique nécessaire, contactez notre équipe de gestion des comptes. Elle vous mettra en relation avec notre équipe technique afin de vous accompagner et de vous conseiller pour la mise en œuvre.