> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Webhooks

L’intégration **Webhook Tool** expose vos points de terminaison HTTP en tant qu’outils que votre réceptionniste ou assistant professionnel peut appeler pendant les conversations. L’IA décide d’appeler le point de terminaison en fonction de la conversation.

## Fonctionnement des outils webhook

Lorsque vous créez un outil webhook, vous définissez :

1. Un point de terminaison HTTP à appeler.
2. Une description de sa fonction, afin que l’IA sache quand l’utiliser.
3. Les paramètres que l’IA doit collecter à partir de la conversation.

Lors d’un appel, lorsque la conversation correspond à la finalité de l’outil, votre réceptionniste collecte les paramètres, appelle le point de terminaison et utilise la réponse pour poursuivre la conversation.

## Créer un outil webhook

Accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**. Configurez les champs ci-dessous et sélectionnez **Enable**. Vous pouvez ajouter plusieurs outils webhook.

| Champ                          | Description                                                          |
| ------------------------------ | -------------------------------------------------------------------- |
| **Name**                       | Nom de l’outil visible par l’IA, par exemple `check_order_status`    |
| **Description**                | Quand et pourquoi utiliser cet outil                                 |
| **Method**                     | GET, POST, PUT, PATCH ou DELETE                                      |
| **URL**                        | Votre point de terminaison HTTP                                      |
| **Response timeout (seconds)** | Temps d’attente pour votre serveur : 5 à 120 secondes, 20 par défaut |
| **Assign to agents**           | **Receptionist**, **Assistant agent** ou les deux                    |
| **Disable interruptions**      | Empêche l’appelant d’interrompre pendant l’exécution de l’outil      |
| **Request Headers**            | En-têtes facultatifs envoyés avec chaque requête, comme une clé API  |
| **Body Parameters**            | Paramètres envoyés dans le corps de la requête                       |
| **Query Parameters**           | Paramètres envoyés comme chaînes de requête URL                      |

### Paramètres

Chaque paramètre comporte :

* **Key** : le nom du champ.
* **Type** : `string`, `number` ou `boolean`.
* **Description** : la valeur que l’IA doit extraire de la conversation.
* **Required** : indique si l’IA doit le collecter avant l’appel.

## Cas d’usage

| Scénario                | Description                                                     | Méthode |
| ----------------------- | --------------------------------------------------------------- | ------- |
| Consultation CRM        | Recherche les informations client dans votre système            | GET     |
| Vérification des stocks | Vérifie la disponibilité des produits en temps réel             | GET     |
| Collecte de prospects   | Envoie les informations de l’appelant à votre système marketing | POST    |
| Création de ticket      | Crée un ticket d’assistance pendant l’appel                     | POST    |
| Devis                   | Calcule un devis personnalisé selon les besoins de l’appelant   | POST    |

## Exemple

Une entreprise de plomberie crée un outil webhook :

* **Name:** `check_service_area`
* **Description:** "Vérifie si nous intervenons dans le code postal de l’appelant et quel est le prochain créneau disponible."
* **URL:** `https://api.mybusiness.com/check-area`
* **Method:** POST
* **Request Headers:** `Authorization` défini sur la clé API de l’entreprise
* **Body Parameters:** `zip_code` (chaîne, requis), `service_type` (chaîne, requis)

Lorsqu’un appelant demande si vous intervenez dans sa zone, le réceptionniste collecte son code postal, appelle le webhook et lui communique le résultat.

Les outils webhook sont disponibles avec tous les forfaits.