Aircall

Ce que ça fait

Aircall envoie en temps réel vers DURUM.ai les appels terminés, leurs enregistrements et les notes après appel de vos représentants. Chaque appel est rattaché au bon rep, l'enregistrement est téléchargé, transcrit et analysé par le pipeline d'appels de DURUM.ai.

Aircall n'alimente pas les leads, les rendez-vous ni les ventes : cette intégration ne concerne que les appels. Un filet de sécurité relit l'API Aircall chaque heure pour rattraper tout appel que le webhook aurait manqué.

Avant de commencer

• Un compte Aircall avec accès au Dashboard et le droit de générer une clé API (section Integrations & API).
• Vos représentants créés dans DURUM.ai avec le même courriel que leur compte Aircall. C'est ce courriel qui rattache chaque appel au bon rep. Un rep peut aussi déclarer son numéro de ligne Aircall ou son identifiant utilisateur Aircall dans Profil, section Tracking d'appels.
• Un siège enregistrement attribué à chaque rep dont vous voulez faire traiter les enregistrements. Un rep sans siège voit ses appels rattachés et visibles, mais ses enregistrements ne sont pas traités.

Connexion étape par étape

1. Dans Aircall, ouvrez le Dashboard, puis Integrations & API, puis API Keys.
2. Cliquez sur Generate an API key. Copiez l'API ID et l'API Token.
3. Dans DURUM.ai, allez dans Paramètres puis Intégrations, et cliquez sur Connecter sur la carte Aircall (catégorie Appels).
   • Si DURUM.ai vous redirige vers Aircall, autorisez l'application : c'est la connexion en un clic.
   • Sinon, une fenêtre Connecter Aircall s'ouvre : collez l'API ID et l'API Token, puis cliquez sur Connecter. Les deux modes font exactement la même chose.
4. DURUM.ai valide les accès, puis :
   • crée dans votre compte Aircall un webhook nommé DURUM.ai vers https://app.durum.ai/api/webhook/aircall-recording, abonné aux événements call.ended, call.commented et call.comm_assets_generated ;
   • importe vos agents et vos lignes Aircall : chaque agent dont le courriel correspond à un rep DURUM.ai est lié, et chaque ligne attribuée à un seul agent lié est associée à ce rep par son numéro. Les lignes partagées entre plusieurs agents ne sont pas associées.
5. Le message « Aircall connecté : nom de la compagnie, X/Y agents liés » confirme la connexion.

Si le webhook n'a pas pu être créé

La connexion reste enregistrée. Ouvrez les paramètres de l'intégration Aircall : DURUM.ai affiche l'URL à coller à la main.

1. Dans le Dashboard Aircall, ouvrez Integrations, puis Webhooks, puis Create Webhook.
2. Collez l'URL affichée par DURUM.ai dans le champ Webhook URL.
3. Sélectionnez les événements call.ended, call.comm_assets_generated et call.commented.
4. Enregistrez.

Vérifier que ça marche

1. Passez un appel de test depuis une ligne Aircall d'un rep lié, avec enregistrement activé.
2. Raccrochez et attendez environ une minute.
3. Dans DURUM.ai, ouvrez Logs Data : un événement call.ended de source aircall doit apparaître avec le statut processed et un rep rattaché.
4. Dans la section Appels, la fiche de l'appel apparaît, puis l'enregistrement et la transcription quelques minutes plus tard.

Événements captés

Côté Aircall	Ce que DURUM.ai crée	Ce qu'il alimente
call.ended	Une fiche d'appel : sens (entrant ou sortant), statut, durée, agent, ligne Aircall utilisée, contact (numéro, courriel, nom), étiquettes. Si le lien d'enregistrement est déjà présent, l'enregistrement est créé en même temps.	Section Appels, attribution au rep.
call.comm_assets_generated	L'enregistrement de l'appel (lien MP3), quand Aircall le fournit après la fin de l'appel.	Téléchargement, transcription, analyse.
call.commented	La note ajoutée par l'agent, rattachée à la fiche d'appel existante.	Fiche d'appel.
Tout autre événement Aircall	aucun	Reçu puis ignoré.

Deux mécanismes complètent le webhook :

• Rattrapage horaire : chaque heure, DURUM.ai relit les appels des 26 dernières heures via l'API Aircall et ajoute ceux qui manquent (webhook indisponible, événement perdu, enregistrement arrivé tard).
• Téléchargement des enregistrements : toutes les 3 minutes, DURUM.ai télécharge les enregistrements en attente. Les liens Aircall expirent après une heure ; si le lien a expiré, DURUM.ai en redemande un frais à l'API.

Siège enregistrement

L'enregistrement n'est traité que si le rep rattaché occupe un siège enregistrement. Sinon, l'appel reste visible mais l'enregistrement est mis en attente avec le statut skipped_unpaid_seat. Dès que le siège est activé, les enregistrements en attente repartent automatiquement.

Dépannage

Problème	Solution
« Credentials Aircall invalides »	Vérifiez l'API ID et l'API Token dans le Dashboard Aircall, Integrations & API, API Keys. Au besoin, générez une nouvelle clé.
« Format invalide » à la connexion	Copiez l'API ID et l'API Token tels quels, sans espace ni deux-points.
« Trop de tentatives côté Aircall »	Attendez 1 minute et réessayez.
Statut rejected avec « Invalid Aircall webhook token » dans Logs Data	Le jeton du webhook Aircall n'est pas enregistré côté DURUM.ai. Contactez votre gestionnaire de compte.
Appel reçu mais aucun rep rattaché	Le courriel de l'agent Aircall ne correspond à aucun rep. Alignez le courriel du rep dans DURUM.ai, ou déclarez son identité Aircall (ligne ou identifiant utilisateur) dans Profil, Tracking d'appels.
« X/Y agents liés » avec X inférieur à Y	Les agents non liés n'ont pas de rep au même courriel dans DURUM.ai. Créez ou corrigez les reps, puis déconnectez et reconnectez pour relancer l'import.
Enregistrement en attente (skipped_unpaid_seat)	Le rep n'a pas de siège enregistrement. Attribuez-lui un siège : l'enregistrement sera traité au prochain passage.
Enregistrement absent de la fiche	Aircall envoie parfois le lien après call.ended, dans call.comm_assets_generated. Sinon, le rattrapage horaire le récupère. Vérifiez aussi que l'enregistrement est activé sur la ligne Aircall.
Ligne partagée, appels mal attribués	Une ligne attribuée à plusieurs agents n'est pas associée par numéro. L'attribution se fait alors par le courriel ou l'identifiant de l'agent qui a pris l'appel.

FAQ

Pourquoi une clé API plutôt qu'une connexion en un clic ?

Le bouton Connecter tente d'abord la connexion en un clic. Si elle n'est pas disponible, la fenêtre de clé API s'ouvre. Les deux modes créent le même webhook et font le même import d'agents.

La clé API expire-t-elle ?

Non. Elle est chiffrée dans DURUM.ai et reste valable tant que vous ne la révoquez pas dans Aircall.

Aircall crée-t-il des leads ou des rendez-vous ?

Non. Aircall n'alimente que la section Appels et l'attribution des appels aux reps.

Que se passe-t-il à la déconnexion ?

DURUM.ai supprime uniquement le webhook qui pointe vers app.durum.ai/api/webhook/aircall-recording. Vos autres webhooks Aircall ne sont jamais touchés.

Les appels manqués et les messages vocaux ?

Chaque appel terminé crée une fiche, avec son statut Aircall (répondu, manqué, messagerie). Un enregistrement n'est créé que si Aircall fournit un lien.

---