Événements webhook
POST à chaque appel traité. Les webhooks se créent dans Paramètres > Avancé > Webhooks, page réservée aux personnes autorisées à gérer les webhooks, à partir du plan AI Meeting. Cette page décrit ce que votre URL reçoit ; la création et la suspension d'un webhook sont dans le guide Webhooks.Événement
| Événement | Quand il est envoyé |
|---|---|
call.processed | Une fois la transcription et les insights IA d'un appel entièrement générés. |
C'est le seul événement existant. Il est envoyé une fois par appel et par webhook ; les appels traités pendant qu'un webhook est inactif ne sont pas rejoués.
Contenu de la requête
Le corps est un objet JSON à deux champs :
| Champ | Contenu |
|---|---|
event | Le nom de l'événement, call.processed. |
data | L'appel complet, au même format que la lecture détaillée d'un appel dans l'API publique : métadonnées, participants, transcript, résumé. |
Les champs de l'objet appel sont décrits dans la référence de l'API publique ; le guide de démarrage des webhooks se trouve dans la référence webhooks. La requête n'est pas signée.
Webhooks destinataires
Seuls les webhooks actifs dont les règles d'accès couvrent l'appel reçoivent l'événement :
| Mode du webhook | Appels reçus |
|---|---|
| Accès à tout | Tous les appels de l'entreprise. |
| Liés à un utilisateur | Les appels auxquels l'utilisateur choisi a accès. |
| Accès personnalisés | Les appels ouverts par les règles d'accès dont le webhook est destinataire ; sans règle, aucun. |
Les règles d'accès dédiées aux webhooks sont décrites dans Types de règles d'accès.
Succès et nouvelles tentatives
Un envoi est réussi dès que votre URL répond avec un code HTTP inférieur à 400. Toute autre réponse, un délai dépassé ou une erreur de connexion déclenche une nouvelle tentative selon le calendrier suivant :
| Tentative | Délai après l'échec précédent |
|---|---|
| 2 | 10 secondes |
| 3 | 1 minute |
| 4 | 5 minutes |
| 5 | 15 minutes |
| 6 | 30 minutes |
| 7 | 1 heure |
| 8 | 6 heures |
| 9 | 24 heures |
| 10 | 24 heures |
| 11 | 24 heures |
Après le onzième échec consécutif (le premier envoi puis ses dix nouvelles tentatives), le webhook est désactivé et les Super administrateurs actifs de l'entreprise reçoivent un e-mail avec le nom du webhook et l'heure de désactivation. Le webhook se réactive depuis sa ligne dans la liste, une fois votre URL rétablie.