Skip to main content
API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.
Webhook envoyé après la fin d’une conversation de chat, contenant la transcription, les variables extraites et les données client
Le 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 :
  1. Utilisez le point de terminaison API Activer le webhook de fin de conversation
  2. Fournissez l’URL de webhook où les notifications seront envoyées
  3. 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, whatsapp
integer
Nombre total de messages échangés dans la conversation
string
Statut de la conversation. Valeur : ended
object
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 null
object
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_id et assistant_id sont des UUID, et non des identifiants entiers
  • Le champ sender n’est renseigné que pour les conversations WhatsApp ; il vaut null pour les conversations widget Web
  • Le champ customer_phone n’est disponible que pour les conversations WhatsApp
  • Le champ customer_name provient 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_variables sont renseignées à partir de l’évaluation du schéma post-appel de votre assistant
  • Les input_variables contiennent des données provenant des formulaires pré-chat (widget Web) ou des flux d’automatisation
  • Le tableau attachments liste les médias (images, vidéos, documents) partagés pendant la conversation, chacun avec une url té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)