> 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

De integratie **Webhook Tool** maakt je HTTP-endpoints beschikbaar als tools die je receptionist of bedrijfsassistent tijdens gesprekken kan aanroepen. De AI bepaalt op basis van het gesprek wanneer het endpoint wordt aangeroepen.

## Hoe webhooktools werken

Wanneer je een webhooktool maakt, definieer je:

1. Een HTTP-endpoint om aan te roepen.
2. Een beschrijving van wat het doet, zodat de AI weet wanneer deze moet worden gebruikt.
3. Parameters die de AI uit het gesprek moet verzamelen.

Wanneer het gesprek tijdens een gesprek overeenkomt met het doel van de tool, verzamelt je receptionist de parameters, roept het endpoint aan en gebruikt de reactie om het gesprek voort te zetten.

## Een webhooktool maken

Ga naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**. Configureer de onderstaande velden en selecteer **Enable**. Je kunt meerdere webhooktools toevoegen.

| Veld                           | Beschrijving                                                                  |
| ------------------------------ | ----------------------------------------------------------------------------- |
| **Name**                       | Toolnaam die de AI ziet, bijvoorbeeld `check_order_status`                    |
| **Description**                | Wanneer en waarom deze tool moet worden gebruikt                              |
| **Method**                     | GET, POST, PUT, PATCH of DELETE                                               |
| **URL**                        | Je HTTP-endpoint                                                              |
| **Response timeout (seconds)** | Hoe lang er op je server wordt gewacht: 5–120 seconden, standaard 20          |
| **Assign to agents**           | **Receptionist**, **Assistant agent** of beide                                |
| **Disable interruptions**      | Voorkom dat de beller onderbreekt terwijl de tool wordt uitgevoerd            |
| **Request Headers**            | Optionele headers die bij elk verzoek worden verzonden, zoals een API-sleutel |
| **Body Parameters**            | Parameters die in de requestbody worden verzonden                             |
| **Query Parameters**           | Parameters die als URL-querystrings worden verzonden                          |

### Parameters

Elke parameter heeft:

* **Key**: de veldnaam.
* **Type**: `string`, `number` of `boolean`.
* **Description**: welke waarde de AI uit het gesprek moet halen.
* **Required**: of de AI deze moet verzamelen voordat er wordt aangeroepen.

## Toepassingen

| Scenario         | Beschrijving                                                              | Methode |
| ---------------- | ------------------------------------------------------------------------- | ------- |
| CRM opzoeken     | Klantinformatie in je systeem opzoeken                                    | GET     |
| Voorraadcontrole | Productbeschikbaarheid in realtime controleren                            | GET     |
| Leadregistratie  | Gegevens van de beller naar je marketingsysteem sturen                    | POST    |
| Ticket maken     | Tijdens het gesprek een supportticket maken                               | POST    |
| Prijsopgave      | Een aangepaste prijsopgave berekenen op basis van de wensen van de beller | POST    |

## Voorbeeld

Een loodgietersbedrijf maakt een webhooktool:

* **Name:** `check_service_area`
* **Description:** "Controleer of we de postcode van de beller bedienen en wat het eerstvolgende beschikbare tijdslot is."
* **URL:** `https://api.mybusiness.com/check-area`
* **Method:** POST
* **Request Headers:** `Authorization` ingesteld op de API-sleutel van het bedrijf
* **Body Parameters:** `zip_code` (string, verplicht), `service_type` (string, verplicht)

Wanneer een beller vraagt naar service in diens regio, verzamelt de receptionist de postcode, roept de webhook aan en vertelt de uitkomst.

Webhooktools zijn beschikbaar in elk abonnement.