- Punkty końcowe webhooków otrzymują
telephony.complete(połączenia telefoniczne) lubweb.complete(połączenia internetowe i testowe połączenia z mikrofonu w kreatorze) ze stabilnym ładunkiem opisanym poniżej, identyfikatoremevent_iddla każdego dostarczenia, limitem czasu 30 s oraz ponownymi próbami przez maksymalnie 24 h. - Starszy webhook z pojedynczym adresem URL otrzymuje jedną synchroniczną próbę (limit czasu 10 s, bez ponownych prób) z nieco innym ładunkiem — zobacz Różnice w starszym ładunku.
Ładunek żądania (dostarczenia do punktów końcowych)
Powody zakończenia
Format transkrypcji
Każdy wpis wtranscripts 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 wtranscripts(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_numberi dodająorigin_domain. - Połączenia testowe mikrofonu w Builderze są raportowane jako
telephony.completew starszej ścieżce (system punktów końcowych mapuje je naweb.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.