> 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

Die Integration **Webhook Tool** stellt Ihre HTTP-Endpunkte als Tools bereit, die Ihr Rezeptionist oder Business Assistant während Unterhaltungen aufrufen kann. Die KI entscheidet anhand der Unterhaltung, wann der Endpunkt aufgerufen wird.

## So funktionieren Webhook-Tools

Wenn Sie ein Webhook-Tool erstellen, definieren Sie:

1. Einen aufzurufenden HTTP-Endpunkt.
2. Eine Beschreibung seiner Funktion, damit die KI weiß, wann sie ihn verwenden soll.
3. Parameter, die die KI aus der Unterhaltung erfassen soll.

Wenn während eines Anrufs die Unterhaltung zum Zweck des Tools passt, erfasst Ihr Rezeptionist die Parameter, ruft den Endpunkt auf und verwendet die Antwort, um die Unterhaltung fortzusetzen.

## Webhook-Tool erstellen

Gehen Sie zu **Integrations**, wählen Sie **Add integration** und dann **Webhook Tool**. Konfigurieren Sie die folgenden Felder und wählen Sie **Enable**. Sie können mehrere Webhook-Tools hinzufügen.

| Feld                           | Beschreibung                                                                    |
| ------------------------------ | ------------------------------------------------------------------------------- |
| **Name**                       | Tool-Name, den die KI sieht, zum Beispiel `check_order_status`                  |
| **Description**                | Wann und warum dieses Tool verwendet wird                                       |
| **Method**                     | GET, POST, PUT, PATCH oder DELETE                                               |
| **URL**                        | Ihr HTTP-Endpunkt                                                               |
| **Response timeout (seconds)** | Wie lange auf Ihren Server gewartet wird: 5–120 Sekunden, Standardwert 20       |
| **Assign to agents**           | **Receptionist**, **Assistant agent** oder beide                                |
| **Disable interruptions**      | Verhindert Unterbrechungen durch den Anrufer, während das Tool ausgeführt wird  |
| **Request Headers**            | Optionale Header, die mit jeder Anfrage gesendet werden, etwa ein API-Schlüssel |
| **Body Parameters**            | Parameter, die im Anfrage-Body gesendet werden                                  |
| **Query Parameters**           | Parameter, die als URL-Abfragezeichenfolgen gesendet werden                     |

### Parameter

Jeder Parameter hat:

* **Key**: der Feldname.
* **Type**: `string`, `number` oder `boolean`.
* **Description**: welcher Wert von der KI aus der Unterhaltung extrahiert werden soll.
* **Required**: ob die KI ihn vor dem Aufruf erfassen muss.

## Anwendungsfälle

| Szenario          | Beschreibung                                                              | Methode |
| ----------------- | ------------------------------------------------------------------------- | ------- |
| CRM-Abfrage       | Kundeninformationen in Ihrem System suchen                                | GET     |
| Bestandsprüfung   | Produktverfügbarkeit in Echtzeit prüfen                                   | GET     |
| Lead-Erfassung    | Anruferdaten an Ihr Marketingsystem senden                                | POST    |
| Ticket-Erstellung | Während des Anrufs ein Support-Ticket erstellen                           | POST    |
| Preisangebot      | Ein individuelles Angebot anhand der Anforderungen des Anrufers berechnen | POST    |

## Beispiel

Ein Sanitärbetrieb erstellt ein Webhook-Tool:

* **Name:** `check_service_area`
* **Description:** "Prüfen, ob wir die Postleitzahl des Anrufers bedienen und wann der nächste verfügbare Termin ist."
* **URL:** `https://api.mybusiness.com/check-area`
* **Method:** POST
* **Request Headers:** `Authorization`, festgelegt auf den API-Schlüssel des Unternehmens
* **Body Parameters:** `zip_code` (string, erforderlich), `service_type` (string, erforderlich)

Wenn ein Anrufer nach Service in seiner Region fragt, erfasst der Rezeptionist seine Postleitzahl, ruft den Webhook auf und teilt ihm das Ergebnis mit.

Webhook-Tools sind in jedem Tarif verfügbar.