> 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.

# Webhooki

Integracja **Webhook Tool** udostępnia twoje punkty końcowe HTTP jako narzędzia, które recepcjonista lub asystent biznesowy mogą wywoływać podczas rozmów. AI decyduje, kiedy wywołać punkt końcowy na podstawie rozmowy.

## Jak działają narzędzia webhook

Tworząc narzędzie webhook, określasz:

1. Punkt końcowy HTTP do wywołania.
2. Opis jego działania, aby AI wiedziało, kiedy go użyć.
3. Parametry, które AI powinno zebrać z rozmowy.

Podczas rozmowy, gdy jej temat odpowiada przeznaczeniu narzędzia, recepcjonista zbiera parametry, wywołuje punkt końcowy i wykorzystuje odpowiedź, aby kontynuować rozmowę.

## Tworzenie narzędzia webhook

Przejdź do **Integrations**, wybierz **Add integration**, a następnie **Webhook Tool**. Skonfiguruj pola poniżej i wybierz **Enable**. Możesz dodać wiele narzędzi webhook.

| Pole                           | Opis                                                          |
| ------------------------------ | ------------------------------------------------------------- |
| **Name**                       | Nazwa narzędzia widoczna dla AI, np. `check_order_status`     |
| **Description**                | Kiedy i dlaczego używać tego narzędzia                        |
| **Method**                     | GET, POST, PUT, PATCH lub DELETE                              |
| **URL**                        | Twój punkt końcowy HTTP                                       |
| **Response timeout (seconds)** | Jak długo czekać na serwer: 5–120 sekund, domyślnie 20        |
| **Assign to agents**           | **Receptionist**, **Assistant agent** lub oba                 |
| **Disable interruptions**      | Uniemożliwia dzwoniącemu przerwanie działania narzędzia       |
| **Request Headers**            | Opcjonalne nagłówki wysyłane z każdym żądaniem, np. klucz API |
| **Body Parameters**            | Parametry wysyłane w treści żądania                           |
| **Query Parameters**           | Parametry wysyłane jako ciągi zapytania URL                   |

### Parametry

Każdy parametr ma:

* **Key**: nazwę pola.
* **Type**: `string`, `number` lub `boolean`.
* **Description**: wartość, którą AI powinno wyodrębnić z rozmowy.
* **Required**: czy AI musi ją zebrać przed wywołaniem.

## Przypadki użycia

| Scenariusz          | Opis                                                  | Metoda |
| ------------------- | ----------------------------------------------------- | ------ |
| Wyszukiwanie w CRM  | Wyszukaj dane klienta w swoim systemie                | GET    |
| Sprawdzanie zapasów | Sprawdź dostępność produktu w czasie rzeczywistym     | GET    |
| Zbieranie leadów    | Wyślij dane dzwoniącego do systemu marketingowego     | POST   |
| Tworzenie zgłoszeń  | Utwórz zgłoszenie do wsparcia podczas rozmowy         | POST   |
| Wycena              | Oblicz własną wycenę na podstawie wymagań dzwoniącego | POST   |

## Przykład

Firma hydrauliczna tworzy narzędzie webhook:

* **Name:** `check_service_area`
* **Description:** "Sprawdź, czy obsługujemy kod pocztowy dzwoniącego i jaki jest najbliższy wolny termin."
* **URL:** `https://api.mybusiness.com/check-area`
* **Method:** POST
* **Request Headers:** `Authorization` ustawione na klucz API firmy
* **Body Parameters:** `zip_code` (string, wymagany), `service_type` (string, wymagany)

Gdy dzwoniący pyta o usługę w swojej okolicy, recepcjonista zbiera jego kod pocztowy, wywołuje webhook i przekazuje wynik.

Narzędzia webhook są dostępne w każdym planie.