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

Kérés hasznos terhe (végpontké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ó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, nem transcripts (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 tartalmaznak from_number / to_number mezőt, és hozzáadják az origin_domain mezőt.
  • A Builder mikrofonteszt-hívásai a régi útvonalon telephony.complete eseményként jelennek meg (a végpontrendszer ezeket web.complete esemé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.