API

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.

APIs, données et infrastructures que nos projets savent connecter
Du besoin métier au run mesurable
01 Contrat versionné
02 Sécurité explicite
03 Reprise testée
04 Supervision actionnable

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.

Lecture seule
Appel entrant CALL-90814
Aircall · status done
12 min 06
raw_digits
+33 6 •• •• 41 82
Ligne Aircall
Support France · …704
Agent final
M. Bernard · …119
contact
null
Accès du premier lot Basic Auth · outil interne OAuth reste hors périmètre de ce raccord privé.
Événements reçus 1 call ID · 5 événements
  1. call.createdDossier ouvert
    reçu +0 s
  2. call.answeredAgent A
    reçu +1 s
  3. call.transferredAgent A → B
    reçu +2 s
  4. call.endedUpsert préparé
    reçu +1 s
  5. call.taggedPriorité haute
    reçu après ended
Résolution CRM 2 candidats
Claire Laurent Compte Nord · contact actif
62 %
Atelier Laurent Compte Ouest · standard partagé
58 %
Règle

Deux comptes actifs partagent le numéro. Ni le score ni l’ordre des résultats ne peuvent choisir l’owner.

01
ReceiveWebhook acquitté
02
Groupcall.id reconnu
03
ResolveContact à arbitrer
04
UpsertActivité unique
05
ReconcileCRM relu
Contact null Ne pas perdre l’appel

Le dossier garde raw_digits et la ligne, puis passe par le moteur de candidats.

Tag tardif Mettre à jour, ne pas insérer

L’activité existante reçoit une qualification si aucune décision humaine plus récente ne s’y oppose.

Timeout CRM Relire avant de refaire

La clé externe permet de reconnaître l’effet déjà obtenu et d’éviter une seconde tâche.

call.id ≠ activité CRM

Les deux systèmes gardent leur identité et le lien qui les rapproche.

contact null ≠ client inconnu

L’absence dans Aircall ouvre une recherche ; elle ne supprime pas le contexte métier.

webhook reçu ≠ appel complet

Les événements successifs enrichissent un même dossier jusqu’au verdict attendu.

recording URL ≠ droit d’archiver

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.

01 Identité

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.

02 Événements

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é.

03 Données vocales

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.

01 · Aircall

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.

02 · Aircall

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.

03 · Aircall

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.

04 · Aircall

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.

05 · Aircall

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.

06 · Aircall

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.

01

Décision 1

Une activité CRM reliée au call ID, au bon contact et à la chronologie réellement observée.

02

Décision 2

Des appels manqués, transferts, tags tardifs et commentaires traités sans nouvelles activités parasites.

03

Décision 3

Des enregistrements accessibles uniquement dans le périmètre et pendant la durée décidés.

04

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.

1 ligne 1 type d’appel 1 activité CRM 5 contre-tests 0 doublon toléré

Sorties attendues

01

Registre Aircall–CRM avec call ID, raw_digits, line/number ID, user ID, contact candidates et activité cible.

02

Choix Basic Auth ou OAuth, inventaire des comptes, credentials, webhooks, propriétaires et droits sur les enregistrements.

03

Machine d’état pour created, answered, transferred, hungup, ended, tagged, commented et voicemail_left.

04

Cinq contre-tests : contact nul, numéro partagé, événement rejoué, tag tardif et recording expiré ou interdit.

05

Upsert CRM avec clé externe, règles de merge, owner, statut, note, consentement et reçu de l’effet obtenu.

06

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.

01 · Identité

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.
02 · Chronologie

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.
03 · Appel manqué

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.

Avis & exigence projet

Une intégration Aircall pensée pour l’appel, le client et l’effet réellement obtenu.

5/5★★★★★Avis clients Dawap
Token, event, call ID et payload utile sont conservés puis acquittés rapidement.
À la réception
Numéro, ligne, candidats, owner et action cible sont arbitrés sans association silencieuse.
À la décision
Aircall et CRM sont relus ; doublons, conflits et assets vocaux gardent une conduite à tenir.
Après l’écriture
Preuves projet, portée explicite

Quatre réalisations pour juger contacts, support et run sans inventer une référence Aircall.

Corim, Origami, 1UP et Daspeed prouvent synchronisation de contacts, tickets, portail client et monitoring. Votre flux Aircall doit encore être recetté sur vos lignes et votre CRM.

Synchronisation API entre le portail Corim et l’ERP Colline Intégration API Corim Solutions : un portail client connecté à l’ERP Colline Voir le projet
  • 28 mai 2026
  • Cas client · 17 min

Dawap a relié comptes, licences et contacts Colline aux parcours du portail Corim. Trois circuits asynchrones préservent la fluidité, tandis qu’un suivi à deux niveaux permet aux équipes de comprendre chaque synchronisation et de reprendre précisément les ressources en erreur.

Architecture des adaptateurs API Origami pour la marketplace Shopetic Intégration API Shopetic × Origami : 24 adaptateurs API Voir le projet
  • 19 juillet 2023
  • Étude de cas · 21 min

Pour relier Shopetic à Origami, Dawap a réparti catalogue, client, panier multivendeur, livraison, paiement et commandes dans 24 adaptateurs et 21 mappers. Soixante-cinq opérations alimentent les parcours, tandis que 14 mutations sensibles conservent leur requête, leur statut et leur réponse pour faciliter le diagnostic.

Architecture suspendue représentant le portail client B2B de 1UP Distribution Développement web 1UP Distribution : portail client, catalogue et tarifs B2B Voir le projet
  • 8 janvier 2026
  • Lecture ~32 min

Dawap a transformé la relation client de 1UP Distribution en portail B2B multi-compte : onboarding, catalogue contextualisé, tarifs issus d’Odoo, disponibilité vendable, paniers réservés, commandes, factures, avoirs et support. Une expérience autonome qui conserve les règles commerciales, les droits et les preuves nécessaires au run.

Daspeed plateforme d’analyse SEO et PageSpeed par API Intégration API Daspeed : plateforme SEO pilotée par API Voir le projet
  • 19 juin 2023
  • Lecture ~18 min

Deux générations d’un produit SEO : exploration des sites, mesures PageSpeed mobile et desktop, campagnes Symfony Messenger et restitution page par page.

Guides Aircall et fiabilité événementielle

Approfondir appels, webhooks signés, désordre réseau et audit trail.

Quatre lectures prolongent l’appel pilote sans détourner l’intention commerciale de cette offre.

Aircall API : appels, contacts et journalisation CRM Intégration API Aircall API : appels, contacts et journalisation CRM Lire l'article
  • 30 avril 2026
  • Lecture ~12 min

L’API Aircall relie appels, contacts et journalisation CRM avec des événements dont l’ordre peut varier entre sonnerie, réponse et clôture. Pour traiter ce point sans raccourci, il faut rapprocher numéros, utilisateurs et dossiers, afin de produire une timeline utile sans créer plusieurs activités pour le même appel ni exposer des données inutiles.

Webhooks signés : vérifier l’origine et bloquer le rejeu Intégration API Webhooks signés : vérifier l’origine et bloquer le rejeu Lire l'article
  • 9 juin 2026
  • Lecture ~12 min

Un webhook signé doit prouver son origine, l’intégrité du corps et la fraîcheur de la requête avant tout effet métier. Une mise en œuvre rigoureuse consiste à vérifier signature, horodatage et identifiant, puis à bloquer le rejeu, afin qu’un attaquant ou une nouvelle tentative ne déclenche pas deux paiements ou mises à jour.

Des événements désordonnés traversent un moteur causal avant de former une chronologie cohérente Intégration API Webhooks hors ordre : préserver un état possible Lire l'article
  • 10 août 2026
  • Lecture ~13 min

Un webhook tardif ne doit ni ramener une commande en arrière ni être ignoré par réflexe. La stratégie compare version, temps métier, préconditions et état courant, puis choisit application, attente, isolation ou réconciliation. Elle traite aussi événements manquants, concurrence, rejeu et preuve de la projection reconstruite.

Audit trail API, support et conformité Intégration API Audit trail API : tracer qui a fait quoi Lire l'article
  • 2 juin 2025
  • Lecture ~48 min

Audit trail API garde la preuve utile quand le support, la conformité et le run doivent reconstituer une action sans fouiller tout le système. La trace doit montrer qui a fait quoi, quand, sur quel endpoint et avec quel contexte, puis rester exploitable après incident. Il reste utile quand un incident tombe après coup.

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