Bookivox Documentation

Le nœud Webhook (webhook) exécute un appel HTTP sortant pour notifier ou alimenter un service externe après l’appel : CRM, ERP, outil métier, tableur.

Le webhook s’exécute après la fin de l’appel, une fois la conversation terminée. Ce n’est pas un appel pendant la conversation.

Champs du nœud

Champ	Type	Requis	Défaut	Description
Nom	texte	non	`Webhook`	Libellé du nœud.
Activé	interrupteur	non	activé	Si désactivé, le webhook est ignoré à l’exécution.
Méthode HTTP	liste	non	`POST`	`GET`, `POST`, `PUT`, `PATCH` ou `DELETE`.
URL cible	texte	non	vide	L’adresse appelée, en `https://`.
Identifiant	référence	non	vide	Le credential appliqué en en-tête `Authorization`.
En-têtes personnalisés	liste clé/valeur	non	vide	Des en-têtes supplémentaires.
Modèle de charge utile	JSON	non	modèle par défaut	Le corps envoyé, rendu avec des variables.

En-têtes personnalisés

Chaque en-tête a deux champs obligatoires :

Sous-champ	Type	Requis	Description
Nom de l’en-tête	texte	oui	Par exemple `X-Environnement`.
Valeur de l’en-tête	texte	oui	Supporte les variables de template.

Ne placez jamais de secret dans un en-tête personnalisé : il est visible en clair. Utilisez un identifiant pour l’authentification.

Modèle de charge utile

Le corps est un objet JSON dont les valeurs sont rendues dynamiquement. Le modèle fourni par défaut est :

{
  "call_id": "{{workflow_run_id}}",
  "first_name": "{{initial_context.first_name}}",
  "rsvp": "{{gathered_context.rsvp}}",
  "duration": "{{cost_info.call_duration_seconds}}",
  "recording_url": "{{recording_url}}",
  "user_recording_url": "{{user_recording_url}}",
  "bot_recording_url": "{{bot_recording_url}}",
  "transcript_url": "{{transcript_url}}"
}

Adaptez-le à votre service : gardez les clés dont vous avez besoin, ajoutez les vôtres, retirez le reste.

Variables disponibles

Ces variables sont remplacées dans le modèle de charge utile, l’URL et les en-têtes.

Variable	Contenu
`{{workflow_run_id}}`	L’identifiant unique de l’exécution.
`{{initial_context.<clé>}}`	Une donnée transmise au déclenchement.
`{{gathered_context.<clé>}}`	Une variable extraite pendant l’appel.
`{{annotations}}`	Les annotations de l’appel (par exemple le motif de fin).
`{{recording_url}}`	L’URL de l’enregistrement complet.
`{{user_recording_url}}`	L’URL de l’enregistrement de la voix du client.
`{{bot_recording_url}}`	L’URL de l’enregistrement de la voix de l’agent.
`{{transcript_url}}`	L’URL de la transcription.
`{{cost_info.call_duration_seconds}}`	La durée de l’appel en secondes.

Le contexte collecté provient des nœuds qui font de l’extraction. Voir Extraction de variables et Réglages de l’agent.

Ordre d’affichage des champs

Nom
Activé
Méthode HTTP
URL cible
Identifiant
En-têtes personnalisés
Modèle de charge utile

Cas d’usage

Alimenter un CRM

Créer ou mettre à jour la fiche du contact avec le résumé de l’appel, le motif et l’enregistrement.

Envoyer un récapitulatif

Notifier votre équipe ou déclencher un e-mail de suivi après chaque appel.

Journaliser dans un tableur

Enregistrer chaque appel dans un Google Sheet ou un Airtable pour analyse.

Déclencher une action métier

Créer une tâche, ouvrir un ticket, planifier une relance selon le résultat de l’appel.

Différence avec un outil HTTP

	Nœud Webhook	Outil Appel HTTP
Moment	Après l’appel	Pendant l’appel
Déclenchement	Le workflow l’exécute systématiquement	Le modèle décide quand l’appeler
Charge utile	Modèle JSON fixe, rendu par variables	Paramètres remplis par le modèle
Usage	Post-traitement déterministe	Capacité à la disposition de l’agent

Pour récupérer des données avant que l’agent parle, utilisez le chargement pré-appel du nœud Départ d’appel.

Contraintes

Le nœud est isolé : il n’a ni entrée, ni sortie. Il s’exécute après l’appel, indépendamment du chemin de conversation.
Un workflow peut contenir plusieurs webhooks.
Si Activé est désactivé, ou si l’URL cible est vide, le webhook est ignoré.

Sécurité

Utilisez HTTPS.
Le webhook envoie des données d’appel (transcription, enregistrement) : assurez-vous que la destination est de confiance et conforme (RGPD).
Validez l’origine des données côté récepteur et vérifiez les signatures si votre service en émet.
Appliquez le moindre privilège sur le credential utilisé.
Survivez aux échecs : côté récepteur, rendez la réception idempotente (un même appel peut être rejoué).

Appel HTTP (outil)

L’alternative pilotée par le modèle.

Déclencheur

Entrée par API.

Réglages de l'agent

Variables et contexte.

Le canevas du builder

Revenir à l’éditeur.

Prise en main

LABS

Construire

Préparer

Piloter

Revendeur (White-label)

Nœud Webhook

Champs du nœud

En-têtes personnalisés

Modèle de charge utile

Variables disponibles

Ordre d’affichage des champs

Cas d’usage

Différence avec un outil HTTP

Contraintes

Sécurité

Appel HTTP (outil)

Déclencheur

Réglages de l'agent

Le canevas du builder

​Champs du nœud

​En-têtes personnalisés

​Modèle de charge utile

​Variables disponibles

​Ordre d’affichage des champs

​Cas d’usage

​Différence avec un outil HTTP

​Contraintes

​Sécurité

Appel HTTP (outil)

Déclencheur

Réglages de l'agent

Le canevas du builder

Champs du nœud

En-têtes personnalisés

Modèle de charge utile

Variables disponibles

Ordre d’affichage des champs

Cas d’usage

Différence avec un outil HTTP

Contraintes

Sécurité