Pour utiliser la téléphonie Aircall dans Mavibot, vous devez créer une paire de clés API dans votre compte Aircall et les saisir dans les paramètres d'intégration.

Aircall est un système téléphonique cloud pour les équipes commerciales et d'assistance, offrant des numéros de téléphone dans plus de 100 pays. Il est conçu pour les entreprises dont les employés utilisent déjà l'application Aircall : le bot passe des appels au nom d'un employé, plutôt qu'à partir d'un numéro de bot séparé.

Le bot peut connecter un employé avec un client, récupérer les enregistrements d'appels et envoyer des événements d'appel à la conversation.

Obtention des données requises

  1. Inscrivez-vous sur aircall.io, achetez un numéro de téléphone dans le pays requis et créez des utilisateurs Aircall pour vos employés.
  2. Ouvrez Dashboard → Settings → Integrations & API → API Keys et créez une paire de clés :
    • API ID
    • API Token
  3. Trouvez le Number ID pour le numéro qui sera utilisé pour les appels sortants et les User IDs pour vos employés. Ces identifiants sont visibles dans la barre d'adresse lorsque vous ouvrez les pages correspondantes dans le tableau de bord Aircall.

API Token n'est affiché qu'une seule fois lors de sa création. Si vous le perdez, créez une nouvelle paire de clés API et révoquez l'ancienne.

Connexion

Dans les paramètres de téléphonie, sélectionnez Aircall et saisissez :

  • API ID — l'identifiant de la clé API.
  • API Token — le jeton API secret.
  • Number ID — l'identifiant numérique de la ligne Aircall qui sera utilisée pour les appels sortants.

L'intégration est maintenant connectée.


Pour déconnecter l'intégration, effacez le champ API ID et enregistrez les paramètres.

Employés

Dans les paramètres de l'employé, remplissez le champ Aircall User ID avec l'identifiant numérique du compte Aircall de l'employé.

Saisissez l'identifiant utilisateur, pas le numéro de téléphone de l'employé. Sans cet identifiant, le bouton d'appel dans la fiche client ne fonctionnera pas pour cet employé.

Appel depuis la fiche client

Un bouton d'appel apparaîtra à côté du numéro de téléphone du client dans la fiche de conversation.

Aircall lance d'abord l'appel dans l'application Aircall de l'employé — sur ordinateur ou mobile. Une fois que l'employé répond, Aircall appelle le client et connecte les deux parties.

L'appel ne passera pas si l'employé est hors ligne, déjà en communication, ou n'est pas assigné au numéro sélectionné dans Aircall. C'est une limitation d'Aircall : les appels ne peuvent être passés que via un utilisateur disponible.

Fonctions de la calculatrice

Appel Employé-Client

aircall_employee_call(client_phone, employee_user_id, number_id)

Paramètres :

  • client_phone — le numéro de téléphone du client au format international E.164. Requis.
  • employee_user_id — l'identifiant utilisateur Aircall de l'employé qui recevra l'appel dans son application Aircall. Requis.
  • number_id — l'identifiant du numéro Aircall utilisé pour passer l'appel. Optionnel. S'il est omis, le numéro configuré dans les paramètres d'intégration est utilisé.

Obtenir le lien d'enregistrement d'appel

aircall_get_record_link(call_id)

Demande un lien frais vers l'enregistrement de l'appel.

Paramètres :

  • call_id — l'identifiant de l'appel Aircall. Optionnel. S'il est omis, l'appel le plus récent du client est utilisé.

Rappels pendant un appel

Au fur et à mesure que l'appel progresse, des rappels sont envoyés à la conversation au format suivant :

aircall_call_event call.answered

Événements possibles :

Événement Quand il est déclenché
call.created L'appel a été créé
call.ringing_on_agent L'employé reçoit l'appel
call.answered L'appel a été répondu
call.hungup L'une des parties a raccroché
call.ended L'appel est complètement terminé
call.voicemail_left Le client a laissé un message vocal

Un scénario typique "pas de réponse → envoyer un message dans le messager" peut être déclenché par call.ended et la vérification de la variable aircall_missed_reason.

Variables client après un appel

Après un appel, les variables suivantes sont disponibles pour le client :

Variable Valeur
aircall_call_id Identifiant de l'appel Aircall
aircall_call_direction Direction de l'appel : inbound ou outbound
aircall_call_status Statut de l'appel : initial, answered ou done
aircall_call_duration Durée de l'appel en secondes
aircall_missed_reason Raison pour laquelle l'appel n'a pas été complété
aircall_record_link Lien vers l'enregistrement de l'appel

Enregistrements d'appels

L'enregistrement des appels doit être activé dans vos paramètres Aircall. Les enregistrements sont stockés dans votre compte Aircall.

⏳ Les liens d'enregistrement Aircall sont disponibles pour une durée limitée — généralement seulement quelques heures après l'appel. Après cela, les liens cessent de fonctionner. C'est ainsi que fonctionne Aircall et ce n'est pas une limitation de Mavibot.

Ce que cela signifie :

  • Dans un scénario qui envoie un enregistrement d'appel, appelez aircall_get_record_link() au moment où l'enregistrement est envoyé au lieu d'utiliser un lien précédemment enregistré.
  • Si vous devez conserver un enregistrement de manière permanente, enregistrez le fichier dans votre propre stockage immédiatement après l'appel.
  • L'archive des enregistrements reste disponible dans le tableau de bord Aircall, où les enregistrements peuvent être lus et téléchargés ultérieurement.

L'enregistrement des appels est réglementé par la loi. En Allemagne, en France, en Espagne et dans de nombreux États américains, le consentement des deux parties peut être requis, et dans certaines juridictions, une notification verbale au début de l'appel peut également être nécessaire. Le propriétaire du compte Aircall est responsable du respect des lois et réglementations applicables.

Dépannage

Erreur Cause / Solution
Erreur d'autorisation lors de la passation d'un appel La paire API ID / API Token est incorrecte. Le jeton n'est affiché qu'une seule fois lors de sa création. S'il a été perdu, créez une nouvelle paire sous API Keys et révoquez l'ancienne.
L'appel n'est pas créé ou l'employé ne reçoit pas l'appel L'employé est hors ligne dans l'application Aircall, déjà en communication, ou n'est pas assigné au numéro sélectionné dans les paramètres Aircall.
"Aircall User ID n'est pas spécifié" Le champ Aircall User ID dans les paramètres de l'employé est vide, ou un numéro de téléphone a été saisi au lieu de l'identifiant utilisateur numérique.
Les appels fonctionnent, mais aucun rappel n'apparaît dans la conversation Le webhook n'a pas été enregistré. Enregistrez à nouveau les paramètres d'intégration Aircall pour l'enregistrer.
Le lien d'enregistrement ne s'ouvre pas Le lien a expiré. Demandez un lien frais en utilisant aircall_get_record_link() ou ouvrez l'enregistrement directement dans le tableau de bord Aircall.