- raw_digits
- +33 6 •• •• 41 82
- Ligne Aircall
- Support France · …704
- Agent final
- M. Bernard · …119
- contact
- null
Intégration API Aircall à votre logiciel pour CRM, appels et support
Dawap relie Aircall à votre CRM, helpdesk, application ou reporting quand un appel terminé ne suffit pas à créer une activité juste. Le connecteur conserve le call ID, le numéro réellement composé, la ligne Aircall, les agents, les transferts, les tags et les événements reçus ; il résout ensuite le bon contact, protège l’accès aux enregistrements et confirme l’effet obtenu dans le système métier.
Réponse immédiate
Une intégration API Aircall relie chaque appel à la bonne fiche CRM et à une action support explicable.
Dawap construit le middleware entre Aircall et votre logiciel. Les webhooks alimentent une file par call ID, le worker rapproche raw_digits, ligne, agents, transferts, tags et commentaires, puis relit le CRM avant de créer ou mettre à jour une activité. L’historique REST sert au rattrapage ; une URL signée d’enregistrement ou un contact Aircall ne sont jamais assimilés à une identité métier fiable.
- Choisir Basic Authentication pour un raccord privé ou OAuth pour une application publique et multi-clients.
- Acquitter rapidement les webhooks, vérifier leur token, conserver l’événement puis traiter l’effet métier hors requête.
- Utiliser call.id comme clé Aircall et upsert côté CRM afin que plusieurs événements ne créent pas plusieurs activités.
- Relire les appels par pages pour le backfill et la réconciliation sans faire du polling permanent le chemin nominal.
Aircall call reconciliation desk · dossier fictif
Suivre l’appel, résoudre le contact, puis décider ce qui peut entrer dans le CRM.
Cette maquette ne se connecte à aucun compte. Le numéro, la ligne, les personnes, le call ID et les événements servent uniquement à montrer le niveau de contrôle attendu.
-
call.createdDossier ouvertreçu +0 s
-
call.answeredAgent Areçu +1 s
-
call.transferredAgent A → Breçu +2 s
-
call.endedUpsert préparéreçu +1 s
-
call.taggedPriorité hautereçu après ended
Deux comptes actifs partagent le numéro. Ni le score ni l’ordre des résultats ne peuvent choisir l’owner.
Le dossier garde raw_digits et la ligne, puis passe par le moteur de candidats.
L’activité existante reçoit une qualification si aucune décision humaine plus récente ne s’y oppose.
La clé externe permet de reconnaître l’effet déjà obtenu et d’éviter une seconde tâche.
Les deux systèmes gardent leur identité et le lien qui les rapproche.
L’absence dans Aircall ouvre une recherche ; elle ne supprime pas le contexte métier.
Les événements successifs enrichissent un même dossier jusqu’au verdict attendu.
L’accès technique ne décide ni de la finalité ni de la durée de conservation.
Quand l’appel est “done”
Un appel peut être terminé dans Aircall et rester faux ou absent dans votre CRM.
Plusieurs événements décrivent un même appel. Le contact Aircall peut être nul, un numéro peut correspondre à plusieurs fiches et un tag peut arriver après la fin. Sans réconciliation, le système cible transforme une chronologie utile en doublons ou en certitudes inventées.
Le premier contact trouvé devient le client
raw_digits sert de clé de recherche, pas de preuve d’identité. Un numéro partagé ou réattribué ouvre une décision ; il ne justifie pas une association silencieuse.
Chaque webhook crée une nouvelle activité
call.created, call.answered, call.ended, call.tagged et call.commented décrivent un même call ID. Le worker fait un upsert et conserve l’ordre observé.
Une URL de recording devient une archive durable
Recording et voicemail sont des URLs signées avec une durée de vie. Droit d’accès, téléchargement éventuel, conservation et suppression doivent être décidés avant le stockage.
Contrats Aircall
Six contrats empêchent la téléphonie de fabriquer une fausse mémoire client.
Aircall expose appels, contacts, utilisateurs, numéros et événements. Le projet attribue encore chaque identité, transition et effet CRM.
Accès adapté au produit
Basic Authentication convient au raccord privé de vos propres outils ; OAuth est prévu pour une application publique qui agit pour plusieurs comptes autorisés.
Call ID comme pivot
Tous les événements d’un appel rejoignent le même dossier par call.id. La clé CRM reste distincte et les deux identifiants sont conservés.
Identité sans raccourci
raw_digits initie la recherche. Le champ contact peut être nul ; plusieurs candidats ou une fusion CRM exigent une règle ou une revue humaine.
Chronologie réconciliée
Création, sonnerie, réponse, transfert, fin, tag et commentaire portent occurrence et réception. Une arrivée tardive enrichit l’activité sans la dupliquer.
Voix et données bornées
Recording, voicemail, transcription éventuelle, numéros et commentaires suivent des droits, une finalité, une rétention et des logs expurgés.
Rattrapage opérable
Webhooks pour le temps réel, REST paginé pour l’historique et le contrôle : rate limits, backoff, checkpoints et replay restent visibles au support.
Méthode call-first
Partir d’un appel réel et fermer le dossier dans le CRM, pas dans le webhook.
Dawap réunit métier, sales, support, sécurité et IT autour d’un appel qui a déjà créé un doute. On nomme la ligne, le numéro, les candidats, l’owner, la qualification et l’action attendue. Le worker ingère d’abord en lecture seule, rejoue les cinq ruptures, puis ouvre une seule écriture idempotente avant toute extension.
Décision 1
Une activité CRM reliée au call ID, au bon contact et à la chronologie réellement observée.
Décision 2
Des appels manqués, transferts, tags tardifs et commentaires traités sans nouvelles activités parasites.
Décision 3
Des enregistrements accessibles uniquement dans le périmètre et pendant la durée décidés.
Décision 4
Un support capable de comparer Aircall et le système cible puis de reprendre un seul dossier.
Premier lot Aircall
Journaliser un appel pilote sans ouvrir toutes les lignes et tous les workflows.
On choisit une ligne Aircall, un type d’appel et une activité cible. La première passe inventorie accès, événements et champs en lecture seule. La création CRM ne s’ouvre qu’après validation du matching, de l’upsert et des cinq contre-tests.
Sorties attendues
Registre Aircall–CRM avec call ID, raw_digits, line/number ID, user ID, contact candidates et activité cible.
Choix Basic Auth ou OAuth, inventaire des comptes, credentials, webhooks, propriétaires et droits sur les enregistrements.
Machine d’état pour created, answered, transferred, hungup, ended, tagged, commented et voicemail_left.
Cinq contre-tests : contact nul, numéro partagé, événement rejoué, tag tardif et recording expiré ou interdit.
Upsert CRM avec clé externe, règles de merge, owner, statut, note, consentement et reçu de l’effet obtenu.
Backfill paginé, rapprochement périodique, limites, alertes, quarantaine, replay ciblé et runbook support.
Recette Aircall
Trois dossiers qui doivent produire une décision lisible par sales, support et exploitation.
Ces scénarios sont illustratifs et doivent être rejoués sur votre compte, vos lignes, vos règles de matching et votre CRM. Ils ne constituent pas des résultats clients ni une intégration Aircall déjà livrée.
Un appel terminé correspond à deux contacts CRM qui partagent le même numéro.
- Scénario terrain
- Aircall fournit le numéro distant, mais aucun contact interne fiable. Créer l’activité sur le premier résultat fausserait l’historique et son owner.
- Architecture
- Inbox par event ID, dossier par call ID, normalisation du numéro, recherche de candidats, règles compte/contexte et file de décision humaine.
- Livrable
- Fixture avec deux candidats, score explicable, activité non créée, motif d’attente, écran de résolution et trace expurgée.
- Décision
- Conserver l’appel en attente, faire choisir le bon contexte puis créer une seule activité avec les deux identifiants.
- Résultat vérifiable
- Aucune association silencieuse et un dossier reprenable sans rejouer les autres appels.
Un tag critique arrive après call.ended et après la première écriture CRM.
- Scénario terrain
- L’activité existe déjà quand la qualification change. Un insert créerait un doublon ; ignorer l’événement laisserait le CRM incomplet.
- Architecture
- Upsert sur external call ID, horodatages occurrence/réception, transitions autorisées et version de l’activité cible.
- Livrable
- Suite d’événements hors ordre, activité initiale, patch idempotent, audit du changement et contre-test avec le tag rejoué.
- Décision
- Enrichir l’activité existante si la version le permet, sinon mettre le dossier en conflit sans écraser une qualification humaine récente.
- Résultat vérifiable
- Une activité unique et une qualification dont la source, la date et l’arbitrage restent visibles.
Le même appel manqué déclenche deux relances après un timeout du CRM.
- Scénario terrain
- Le premier appel CRM a peut-être réussi avant la coupure. Une seconde création aveugle doublerait la tâche commerciale.
- Architecture
- Clé externe call ID + action, lecture préalable du CRM, statut done, missed_call_reason, outbox et rapprochement après timeout.
- Livrable
- Timeout provoqué, tâche existante retrouvée, seconde tentative en no-op, métrique de doute et procédure de résolution.
- Décision
- Relire avant de refaire ; clôturer si la tâche existe, créer seulement si l’absence est prouvée et mettre en revue tout résultat ambigu.
- Résultat vérifiable
- Une seule relance commerciale et un incident explicable depuis l’appel jusqu’au CRM.
Frontières de responsabilité
Orienter chaque décision vers le système qui doit réellement faire foi.
Aircall porte l’appel. Le CRM, le support et l’architecture transverse conservent leurs propres objets et responsabilités.
Avis & exigence projet
Une intégration Aircall pensée pour l’appel, le client et l’effet réellement obtenu.
Token, event, call ID et payload utile sont conservés puis acquittés rapidement.
Numéro, ligne, candidats, owner et action cible sont arbitrés sans association silencieuse.
Aircall et CRM sont relus ; doublons, conflits et assets vocaux gardent une conduite à tenir.
Questions d’achat
Questions fréquentes sur l’intégration API Aircall
Les réponses à clarifier avant de relier appels, contacts et événements Aircall à votre CRM, helpdesk ou reporting.
01Quand faire appel à un intégrateur API Aircall ?
Quand Aircall doit alimenter votre CRM, helpdesk, application ou reporting avec des règles d’identité, de chronologie, de droits, d’idempotence, d’observabilité et de reprise propres à votre métier.
02Faut-il utiliser Basic Authentication ou OAuth ?
Aircall destine Basic Authentication aux intégrations privées de vos propres outils. OAuth est adapté aux applications publiques qui accèdent aux comptes de plusieurs clients après autorisation. Le choix dépend donc du produit, pas d’une préférence technique.
03Comment éviter les activités CRM en double ?
Le middleware utilise call.id comme clé Aircall stable, stocke chaque événement dans une inbox, puis fait un upsert sur une clé externe côté CRM. Après un timeout, il relit l’activité avant toute nouvelle écriture.
04Le champ contact Aircall suffit-il pour retrouver le client ?
Non. Aircall précise qu’il peut être nul, notamment pour des contacts venant d’un CRM externe. raw_digits sert de clé de recherche, mais un numéro partagé ou réattribué exige encore une règle de contexte ou une décision humaine.
05Comment traiter les appels manqués et le temps parlé ?
Un appel manqué se lit avec status done et missed_call_reason ; il n’existe pas un type missed unique. La durée inclut la sonnerie, tandis que le temps parlé se calcule avec answered_at et ended_at lorsque answered_at existe.
06Quel premier lot Aircall recommandez-vous ?
Une ligne, un type d’appel et une activité CRM, avec un appel témoin et cinq contre-tests. Contacts, reporting étendu, autres lignes et automatisations ne rejoignent le lot qu’après une reprise réussie par le support.
Aircall Public API · appels et CRM
Votre prochain appel Aircall peut-il être expliqué jusqu’à l’activité CRM ?
Dawap cadre les accès, identités, événements, écritures, assets vocaux et reprises avant d’ouvrir le flux à toutes vos lignes.
Cadrer mon flux Aircall