Integracje

Webhooki

Daj recepcjoniście własne narzędzia wywołujące twoje punkty końcowe HTTP.

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.

PoleOpis
NameNazwa narzędzia widoczna dla AI, np. check_order_status
DescriptionKiedy i dlaczego używać tego narzędzia
MethodGET, POST, PUT, PATCH lub DELETE
URLTwój punkt końcowy HTTP
Response timeout (seconds)Jak długo czekać na serwer: 5–120 sekund, domyślnie 20
Assign to agentsReceptionist, Assistant agent lub oba
Disable interruptionsUniemożliwia dzwoniącemu przerwanie działania narzędzia
Request HeadersOpcjonalne nagłówki wysyłane z każdym żądaniem, np. klucz API
Body ParametersParametry wysyłane w treści żądania
Query ParametersParametry 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

ScenariuszOpisMetoda
Wyszukiwanie w CRMWyszukaj dane klienta w swoim systemieGET
Sprawdzanie zapasówSprawdź dostępność produktu w czasie rzeczywistymGET
Zbieranie leadówWyślij dane dzwoniącego do systemu marketingowegoPOST
Tworzenie zgłoszeńUtwórz zgłoszenie do wsparcia podczas rozmowyPOST
WycenaOblicz własną wycenę na podstawie wymagań dzwoniącegoPOST

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.