Skip to main content
Befejezési esemény indul minden hívás befejeződése után — bejövő telefonhívás, kimenő telefonhívás, webes hívás vagy teszthívás (a builder mikrofonos munkamenete). Ez nem blokkoló: bármely 2xx válasszal válaszoljon. Az esemény mindkét útvonalon kézbesítésre kerül:

Kérelem payloadja (végponti kézbesítések)

Befejezési okok

Átirat formátuma

A transcripts 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 history alatt található, nem a transcripts alatt (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 a from_number / to_number mezőket, és hozzáadják az origin_domain mezőt.
  • A Builder mikrofonteszt-hívások a régi útvonalon telephony.complete eseményként jelennek meg (a végpont rendszere ezeket web.complete esemé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.