> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bookivox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Recevoir les événements d'appel Bookivox sur votre serveur : nœud webhook du workflow, variables de template disponibles et validation des requêtes.

## Deux directions

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

| Direction | Qui initie | Quand | Où c'est décrit |
| - | - | - | - |
| **Vers votre serveur** | Le workflow Bookivox | À un point précis de l'appel | [Nœud Webhook](https://docs.bookivox.com/workflow/nodes/webhook.md) |
| **Vers Bookivox** | Votre système | Quand vous le décidez | [Référence API](https://docs.bookivox.com/api-reference/overview) |

## 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](https://docs.bookivox.com/workflow/nodes/webhook.md)**
>
> 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](https://docs.bookivox.com/workflow/nodes/webhook.md).

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

> [!WARNING]
>
> * **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](https://docs.bookivox.com/api-reference/overview) et le
[cheatsheet des endpoints](https://docs.bookivox.com/api-reference/endpoints).

> **[Nœud Webhook](https://docs.bookivox.com/workflow/nodes/webhook.md)**
>
> Le nœud du graphe.

> **[Intégrations HTTP (API)](https://docs.bookivox.com/api-reference/guides/http-api-integrations)**
>
> Outil `http_api` appelé pendant l'appel.

> **[Référence API](https://docs.bookivox.com/api-reference/overview)**
>
> Authentification et surface.

> **[Erreurs & codes](https://docs.bookivox.com/api-reference/errors)**
>
> Comprendre les réponses d'erreur.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.