Webhook envoyé après la fin d’une conversation de chat, contenant la transcription, les variables extraites et les données clientLe webhook de fin de conversation est automatiquement envoyé à l’URL de webhook que vous avez spécifiée une fois qu’une conversation de chat (WhatsApp ou widget Web) se termine. Ce webhook contient la transcription complète, les variables extraites, les informations client et les détails de l’expéditeur.
Configuration du webhook
Pour activer les webhooks de fin de conversation :- Utilisez le point de terminaison API Activer le webhook de fin de conversation
- Fournissez l’URL de webhook où les notifications seront envoyées
- Configurez éventuellement des variables post-appel sur votre assistant pour extraire des données structurées des conversations
Format de la requête
Le webhook est envoyé sous forme de requête POST à l’URL que vous avez configurée, avec le payload JSON suivant :Structure du payload
integer
Identifiant numérique de la conversation (le même
id affiché dans l’URL de conversation du tableau de bord). Utilisez conversation_id (UUID) lors des appels à l’API.string
Identifiant unique (UUID) de la conversation
string
Identifiant unique (UUID) de l’assistant ayant traité la conversation
string
Le type de conversation. Valeurs possibles :
widget, whatsappinteger
Nombre total de messages échangés dans la conversation
string
Statut de la conversation. Valeur :
endedobject
Variables extraites par l’IA en fonction de la configuration du schéma post-appel de votre assistant
object
Variables transmises à l’assistant au début de la conversation (par ex., depuis les champs du formulaire pré-chat ou des flux d’automatisation)
array
Tableau d’objets message représentant la conversation complète, du plus ancien au plus récent
string
Transcription formatée lisible par un humain avec les préfixes
AI: et Customer:array
Fichiers média (images, vidéos, documents) partagés pendant la conversation. Chaque entrée inclut une URL directe que vous pouvez transmettre à des services externes (par exemple, analyse d’image ou de vidéo). Il s’agit d’un tableau vide lorsqu’aucun média n’a été partagé — les médias sont généralement présents sur les conversations WhatsApp.
string
Numéro de téléphone du client (disponible pour les conversations WhatsApp,
null pour les conversations widget)string
Nom du client si fourni (par ex., depuis un formulaire pré-chat), ou
nullobject
Informations sur l’expéditeur WhatsApp (présentes uniquement pour les conversations WhatsApp,
null pour le widget)string
Horodatage ISO 8601 du début de la conversation (dans le fuseau horaire configuré de l’utilisateur)
string
Horodatage ISO 8601 de la fin de la conversation (dans le fuseau horaire configuré de l’utilisateur)
Comportement de nouvelle tentative
Si votre point de terminaison de webhook renvoie un code de statut non-2xx ou si la requête échoue, le système réessaiera :
Après 3 tentatives infructueuses, la livraison du webhook est marquée comme échouée et aucune nouvelle tentative n’est effectuée.
Remarques importantes
- Les champs
conversation_idetassistant_idsont des UUID, et non des identifiants entiers - Le champ
sendern’est renseigné que pour les conversations WhatsApp ; il vautnullpour les conversations widget Web - Le champ
customer_phonen’est disponible que pour les conversations WhatsApp - Le champ
customer_nameprovient des données du formulaire pré-chat ou du contexte de la conversation - Les horodatages utilisent le fuseau horaire configuré de l’utilisateur (format ISO 8601)
- Les
extracted_variablessont renseignées à partir de l’évaluation du schéma post-appel de votre assistant - Les
input_variablescontiennent des données provenant des formulaires pré-chat (widget Web) ou des flux d’automatisation - Le tableau
attachmentsliste les médias (images, vidéos, documents) partagés pendant la conversation, chacun avec uneurltéléchargeable — utile pour transmettre à des outils d’analyse externes. Il s’agit d’un tableau vide lorsqu’aucun média n’a été partagé (le plus souvent sur les conversations widget Web)