- A webhook-végpontok a stabil, alább dokumentált
payloadtal fogadják a
telephony.complete(telefonhívások) vagyweb.complete(webes hívások és builder mikrofonos teszthívások) eseményt, kézbesítésenkéntievent_idazonosítóval, 30 másodperces időtúllépéssel és legfeljebb 24 órán át tartó újrapróbálkozásokkal. - A régi, egyetlen URL-es webhook egy szinkron próbálkozást fogad (10 másodperces időtúllépés, újrapróbálkozás nélkül), kissé eltérő payloadtal — lásd: Régi payload eltérései.
Kérelem payloadja (végponti ké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ótörténethez (megszakításjelölőkkel,
visszajelzéskérő promptokkal és nyers pozíciókkal) használja a
GET /v1/calls/{call_id}/history végpontot.
Eltérések a régi payloadban
A régi, egyetlen URL-t használó webhook boríték formátuma:{"type": "telephony.complete" | "web.complete", "data": {…}}, amely
nem tartalmaz event_id értéket, és a data mezője eltér a végpont
payloadjától:
- A fordulók tömbje a
historyalatt található, nem atranscriptsalatt (a fordulóséma megegyezik a fentivel). - A mezőkészlet a nyers hívásvégi jelentés, és a fenti táblázaton 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") kihagyják afrom_number/to_numbermezőket, és hozzáadják azorigin_domainmezőt. - A Builder mikrofonteszt-hívások a régi útvonalon
telephony.completeeseményként jelennek meg (a végpont rendszere ezeketweb.completeeseményre képezi le). - Hívásátadási koordináció: amikor egy hívás átadással ér véget, a régi webhookot
szinkron módon hívja meg a rendszer, és az
{"transfer_ready": false}választ adhatja annak jelzésére, hogy az átadási cél még nem áll készen. Bármely más válasz (vagy régi webhook hiánya) lehetővé teszi az átadás folytatását. A végpontkézbesítéseket ehhez soha nem veszi figyelembe a rendszer.
Példa kezelő
Gyakori használati esetek
CRM-integráció
Tárolja minden hívás átiratát és felvételi URL-jét az
ügyféladatok mellett.
Elemzés
Továbbítsa az átiratokat egy folyamatba témamodellezéshez, CSAT-jelek
kinyeréséhez vagy átadási arányok monitorozásához.
Minőségellenőrzés
Nyissa meg a hívásokat egy QA-eszközben emberi felülvizsgálathoz, vagy futtassa
őket saját értékelési modelljén.
Értesítések
Átadás vagy hiba esetén értesítsen egy emberi csapattársat.
Kapcsolódó tartalom
telephony.incoming / web.incoming
A hívás indításakor futó, blokkoló párja.
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
újrajátszáshoz.