Skip to main content

​
Deux directions

Le mot « webhook » recouvre deux flux distincts chez Bookivox. Ne les confondez pas.

​
Vers votre serveur (nœud webhook)

Le nœud webhook du workflow envoie une requête HTTP déterministe vers votre serveur, à l’endroit exact du graphe où il est placé. Contrairement à un outil http_api (décidé par le modèle pendant la conversation), le nœud webhook s’exécute toujours, dans l’ordre du workflow. Cas d’usage typiques :
  • Charger des données avant l’appel : récupérer le dossier du contact pour personnaliser le prompt.
  • Notifier votre CRM après l’appel : POST du résumé, du transcript ou du résultat d’extraction.
  • Déclencher une action métier : créer une tâche, envoyer un e-mail de suivi.

Nœud Webhook

Configuration complète, variables de template, cas d’usage et sécurité.

​
Variables de template

Les payloads sortants peuvent inclure des variables de contexte de l’appel (identifiant d’appel, numéro de l’appelant, champs extraits par le nœud startCall, valeurs de paramètres prédéfinis). La liste exacte et la syntaxe d’interpolation sont documentées sur la page du nœud Webhook.

​
Sécurité (règles à respecter côté récepteur)

  • HTTPS uniquement.
  • Validez côté serveur : ne faites jamais confiance au contenu du payload (un appelant peut influencer certains champs).
  • Rendez votre récepteur idempotent : une nouvelle tentative ne doit pas créer de doublon (utilisez l’identifiant d’appel comme clé).
  • Répondez vite (idéalement < 5 s) : au-delà, considérez l’appel comme perdu et prévoyez un retry.
  • N’écrivez jamais de secret dans les en-têtes envoyés ; gardez-les dans le gestionnaire d’identifiants.

​
Vers Bookivox

Pour piloter Bookivox depuis votre système, appelez les endpoints REST avec l’en-tête X-API-Key. Les points d’entrée et le format des réponses sont décrits dans Référence API : Vue d’ensemble et le cheatsheet des endpoints.

Nœud Webhook

Le nœud du graphe.

Intégrations HTTP (API)

Outil http_api appelé pendant l’appel.

Référence API

Authentification et surface.

Erreurs & codes

Comprendre les réponses d’erreur.
Last modified on October 28, 2026