- A webhookvégpontok a
telephony.complete(telefonhívások) vagyweb.complete(webes hívások és builder mikrofonos teszthívások) eseményt kapják az alább dokumentált stabil hasznos teherrel, kézbesítésenkéntievent_idazonosítóval, 30 másodperces időtúllépéssel és legfeljebb 24 órás újrapróbálkozással. - A régi, egy URL-es webhook egy szinkron próbálkozást kap (10 másodperces időtúllépés, nincs újrapróbálkozás) kissé eltérő hasznos teherrel — lásd: Régi hasznos teher eltérései.
Kérés hasznos terhe (végpontkézbesítések)
Befejezési okok
Átirat formátuma
Atranscripts minden bejegyzése egy beszélgetési forduló. A szerepkörök:
user (a hívó beszéde), model (az ügynök beszéde és eszközhívások),
tool (eszközeredmények) és system (hívási események, például nyelvváltások).
A teljesen strukturált fordulóelőzményekhez (megszakításjelölőkkel,
visszaigazolási kérésekkel és nyers pozíciókkal) használja a
GET /v1/calls/{call_id}/history végpontot.
Régi payload eltérései
A régi, egyetlen URL-t használó webhook-burkoló:{"type": "telephony.complete" | "web.complete", "data": {…}}, amelyben
nincs event_id, és a data mező eltér a végpont payloadjától:
- A fordulótömb neve
history, nemtranscripts(a fordulóséma megegyezik a fentivel). - A mezőkészlet a nyers hívásvégi jelentés, és a fenti táblázatban szereplőkön túl további belső mezőket is tartalmazhat — az ismeretlen mezőket tájékoztató jellegűként kezelje.
- A webes hívások (
direction: "web") nem tartalmaznakfrom_number/to_numbermezőt, és hozzáadják azorigin_domainmezőt. - A Builder mikrofonteszt-hívásai a régi útvonalon
telephony.completeeseményként jelennek meg (a végpontrendszer ezeketweb.completeeseményekké képezi le). - Átirányítási koordináció: ha egy hívás átirányítással ér véget, a régi webhookot szinkron módon hívják meg, és válaszolhat
{"transfer_ready": false}értékkel annak jelzésére, hogy az átirányítás célpontja még nem áll készen. Bármely más válasz (vagy régi webhook hiánya) lehetővé teszi az átirányítás folytatását. A végpontkézbesítéseket ehhez soha nem veszik figyelembe.
Példa kezelő
Gyakori felhasználási esetek
CRM-integráció
Mentse az egyes hívások átiratát és felvételi URL-jét az ügyféladatok
mellett.
Elemzések
Továbbítsa az átiratokat egy folyamatba témamodellezéshez, CSAT-jelzések
kinyeréséhez vagy az átadási arány figyeléséhez.
Minőségellenőrzés
Nyissa meg a hívásokat egy QA-eszközben emberi ellenőrzéshez, vagy futtassa
át őket saját értékelési modellen.
Értesítések
Átadás vagy hiba esetén értesítsen egy emberi csapattársat.
Kapcsolódó témák
telephony.incoming / web.incoming
A hívás kezdetekor futó blokkoló megfelelője.
Eseménykatalógus
További eseménytípusok, amelyekre feliratkozhat.
Híváselőzmények API
Ugyanezek az adatok REST-en keresztül is elérhetők visszatöltéshez vagy
visszajátszáshoz.
