Skip to main content
Zdarzenie zakończenia jest wywoływane po zakończeniu każdego połączenia — telefonii przychodzącej, telefonii wychodzącej, połączenia internetowego lub połączenia testowego (sesja mikrofonu w kreatorze). Jest nieblokujące: odpowiedz dowolnym kodem 2xx. Zdarzenie jest dostarczane obiema ścieżkami:

Ładunek żądania (dostarczenia do punktów końcowych)

Powody zakończenia

Format transkrypcji

Każdy wpis w transcripts to jedna tura rozmowy. Role to user (wypowiedź rozmówcy), model (wypowiedź agenta oraz wywołania narzędzi), tool (wyniki narzędzi) i system (zdarzenia połączenia, takie jak zmiany języka).
Aby uzyskać w pełni ustrukturyzowaną historię tur (ze znacznikami przerwań, promptami potwierdzającymi i surowymi pozycjami), użyj GET /v1/calls/{call_id}/history.

Różnice w starszym ładunku

Starsza koperta webhooka z pojedynczym adresem URL ma format {"type": "telephony.complete" | "web.complete", "data": {…}} i nie zawiera event_id, a jej data różni się od ładunku punktu końcowego:
  • Tablica tur znajduje się w history, a nie w transcripts (ten sam schemat tury jak powyżej).
  • Zestaw pól to surowy raport końca połączenia i może zawierać dodatkowe pola wewnętrzne poza tabelą powyżej — traktuj nieznane pola jako informacyjne.
  • Połączenia internetowe (direction: "web") pomijają from_number / to_number i dodają origin_domain.
  • Połączenia testowe mikrofonu w Builderze są raportowane jako telephony.complete w starszej ścieżce (system punktów końcowych mapuje je na web.complete).
  • Koordynacja przekazania: gdy połączenie kończy się przekazaniem, starszy webhook jest wywoływany synchronicznie i może zwrócić {"transfer_ready": false}, aby zasygnalizować, że cel przekazania nie jest gotowy. Każda inna odpowiedź (lub brak starszego webhooka) pozwala na kontynuowanie przekazania. Dostawy do punktów końcowych nigdy nie są w tym celu sprawdzane.

Przykładowy moduł obsługi


Typowe przypadki użycia

Integracja z CRM

Zapisuj transkrypcję i adres URL nagrania każdego połączenia wraz z danymi klienta.

Analityka

Przesyłaj strumieniowo transkrypcje do potoku na potrzeby modelowania tematów, wyodrębniania sygnałów CSAT lub monitorowania współczynnika przekazań.

Kontrola jakości

Otwieraj połączenia w narzędziu QA do weryfikacji przez człowieka albo przetwarzaj je za pomocą własnego modelu oceny.

Powiadomienia

Powiadamiaj członka zespołu o przekazaniu / niepowodzeniu.

Powiązane

telephony.incoming / web.incoming

Blokujący odpowiednik uruchamiany na początku połączenia.

Katalog zdarzeń

Inne typy zdarzeń, które możesz subskrybować.

API historii połączeń

Te same dane dostępne przez REST na potrzeby uzupełniania danych / odtwarzania.