Eseménykatalógus

Minden webhooktörzs rendelkezik egy type mezővel, amelynek értéke az ezen az oldalon szereplő eseménytípusok egyike. Amikor feliratkozik egy végpontra, az events tömbnek tartalmaznia kell a kívánt eseménytípusokat (vagy üresnek kell lennie, ha mindenre fel szeretne iratkozni). Két kézbesítési mód továbbítja ezeket az eseményeket:

A végpontkézbesítések mindig nem blokkoló értesítések újrapróbálkozásokkal: válaszoljon bármely 2xx kóddal; a boríték egy event_id azonosítót tartalmaz a duplikációk kiszűréséhez.
A blokkoló adatcserék csak a régi, egyetlen URL-es webhookon futnak: a telephony.incoming / web.incoming konfigurációs kérés (webhook módú számok és widgetkulcsok, 10 mp-es időkorlát), valamint a webhook módú eszközdiszpécselés. Válasza alakítja az élő hívást.

Az alábbi mintaterhelések a végpontborítékot a továbbítási sorrendben mutatják (a kulcsok ábécésorrendben vannak: data, event_id, type); a régi kézbesítések ugyanazt a data értéket tartalmazzák event_id nélkül.

Hívásesemények

`telephony.incoming`

Akkor kerül elküldésre, amikor egy bejövő hívás eléri az Ön egyik telefonszámát. A végpontkézbesítések minden bejövő hívás esetén elküldött, választ nem váró értesítések, függetlenül attól, hogy a szám ügynökhöz vagy webhookhoz van-e konfigurálva. A hozzárendelt ügynök nélküli számok emellett megkapják a blokkoló konfigurációs kérést az örökölt webhookon — a teljes kérési / válaszsémát lásd itt: telephony.incoming / web.incoming.

{
  "data": {
    "call_id": 987654321,
    "from_number": "+14155550199",
    "to_number": "+15551234567"
  },
  "event_id": "3f6b2ad0-1c9e-4a57-9f2b-8f6f0f9d2f11",
  "type": "telephony.incoming"
}

`telephony.complete`

Akkor kerül elküldésre, amikor egy bejövő vagy kimenő telefonhívás véget ér. Nem blokkoló. Tartalmazza a teljes átiratot, a felvétel URL-jét és a számlázási összesítőt. A hasznos adat sémáját lásd itt: telephony.complete / web.complete.

`telephony.tool`

Akkor kerül elküldésre, miután egy telefonhívás meghív egy függvényeszközt. Nem blokkoló naplózási értesítés — az eszköz már lefutott, amikor ez az esemény kézbesítésre kerül; csak az Ön saját függvényeszközeire vonatkozik (nem a beépített, tudásbázis-, alkalmazáskapcsolati vagy MCP-eszközökre).

{
  "data": {
    "arguments": { "date": "2026-04-21" },
    "call_id": 987654321,
    "from_number": "+14155550199",
    "response": {
      "response": { "available_slots": ["9:00 AM", "2:00 PM"] },
      "status": 200
    },
    "to_number": "+15551234567",
    "tool_name": "search_appointments"
  },
  "event_id": "1f0a7c3e-52d4-4a0e-8f4b-b1a6a1c0d9e2",
  "type": "telephony.tool"
}

A response a végrehajtás eredménye: siker esetén {"status": <http status>, "response": <your endpoint's JSON>}, hiba esetén pedig {"status": <status>, "error": "<message>"}.

`web.incoming`

A telephony.incoming webcsatornás megfelelője, amely akkor kerül elküldésre, amikor egy webes widget munkamenete vagy egy szerkesztői mikrofonteszt-hívás elindul. A végpontkézbesítések minden webes munkamenet esetén elküldött, választ nem váró értesítések. A mode="webhook" módban lévő közzétehető kulcsok emellett megkapják a blokkoló konfigurációs kérést az örökölt webhookon — ennek a blokkoló kérésnek eltérő az alakja (origin_domain, publishable_key_prefix; nincsenek telefonszámok). Lásd: telephony.incoming / web.incoming.

{
  "data": {
    "call_id": 987654322,
    "from_number": "web",
    "origin_domain": "https://example.com",
    "publishable_key_prefix": "pk_live_a1b2",
    "to_number": "+15551234567"
  },
  "event_id": "9a2b4c6d-8e0f-4a1b-9c2d-3e4f5a6b7c8d",
  "type": "web.incoming"
}

A from_number értéke mindig a szó szerinti "web". Webhook módú widget-munkameneteknél a to_number üres (a munkamenet ügynökszáma a konfiguráció után lesz hozzárendelve); szerkesztői mikrofonteszt-hívásoknál az origin_domain és a publishable_key_prefix üres.

`web.complete`

A telephony.complete webcsatornás megfelelője, amely a webes widget-hívásokat (direction: "web") és a szerkesztői mikrofonteszt-hívásokat (direction: "test") fedi le. Nem blokkoló. A hasznos adat alakja megegyezik a telephony.complete eseményével, kiegészítve az origin_domain mezővel, a from_number értéke pedig "web".

Az örökölt egyetlen URL-es webhookon a szerkesztői mikrofonteszt-hívások korábban telephony.complete eseményként szerepelnek — ott csak a direction: "web" hívások használják a web.complete típust. A végpontrendszer a webes és a teszthívásokat is web.* formátumra képezi le. A korábbi hasznos adatok tartalmazhatják az örökölt direction értékeket: widget vagy mic.

`web.tool`

A telephony.tool webcsatornás megfelelője. A data a from_number / to_number helyett az origin_domain mezőt tartalmazza.

Minőségi események

`call.graded`

Akkor kerül elküldésre, amikor egy hívás AI-értékelési futása befejeződik. Nem blokkoló.

{
  "data": {
    "call_id": 987654321,
    "grade": {
      "call_outcome": "success",
      "created_at": "2026-04-20T18:25:11.002Z",
      "detected_issues": [],
      "graded_at": "2026-04-20T18:25:11.002Z",
      "grader_model": "heuristic-v1",
      "id": 5512,
      "score": 92,
      "status": "completed",
      "summary": "Caller asked about their policy and got a full answer…"
    }
  },
  "event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "type": "call.graded"
}

Mező	Típus	Leírás
`grade.id`	integer	Értékelésazonosító
`grade.score`	integer \| null	0–100
`grade.call_outcome`	string	`success`, `failure`, `unknown` vagy `no_conversation`
`grade.summary`	string	Egyszerkezdéses összefoglaló
`grade.detected_issues`	array	Az értékelő által észlelt problémákat leíró karakterláncok
`grade.status`	string	Mindig `completed` — csak a befejezett futások bocsátanak ki eseményt
`grade.grader_model`	string	Az eredményt létrehozó értékelő (pl. `heuristic-v1`)
`grade.graded_at`, `grade.created_at`	timestamp

Egy hívás többször is értékelhető — a gyors heurisztikus értékelést gyakran teljes modellértékelés követi, amint a felvétel elérhetővé válik, és manuális újraértékelésre is van lehetőség. Minden befejezett futás saját call.graded eseményt bocsát ki; a legfrissebb graded_at értéket tekintse hitelesnek.

`issue.reported`

Akkor kerül elküldésre, amikor egy hibajelentés létrejön — akár egy felhasználó küldi be az irányítópultról (source: "user"), akár a hívásértékelés hozza létre automatikusan (source: "system"). Nem blokkoló.

{
  "data": {
    "call_id": 987654321,
    "issue_report": {
      "created_at": "2026-04-20T18:25:11.002Z",
      "description": "Five-second silence before responding to the main question.",
      "id": 4321,
      "severity": "warning",
      "source": "system",
      "status": "open",
      "title": "Agent paused too long"
    }
  },
  "event_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
  "type": "issue.reported"
}

Mező	Típus	Leírás
`issue_report.severity`	string	`critical`, `warning` vagy `info`
`issue_report.status`	string	`open` vagy `resolved`
`issue_report.source`	string	`user` (az irányítópultról beküldve) vagy `system` (értékelés által létrehozva)

Egy hívás újraértékelése újraépíti a rendszer által létrehozott hibajelentéseit, ami a létrehozott jelentésekhez ismét kibocsátja az issue.reported eseményt. Ha alapul szolgáló problémánként csak egy értesítést szeretne, szűrje a duplikátumokat call_id + title alapján.

Teszthívási események

`test-call.completed`

Akkor kerül elküldésre, amikor egy teszthívási futás végleges állapotba kerül — completed vagy failed, beleértve azokat a futásokat is, amelyek indításkor sikertelenek voltak, és soha nem hoztak létre hívást. Nem blokkoló. Hasznos kötegelt CI-futtatások csevegési/értesítési rendszerekhez való kapcsolásához.

{
  "data": {
    "test_call_run": {
      "call_id": 987654321,
      "completed_at": "2026-04-20T18:25:04.822Z",
      "error_message": "",
      "id": 7110,
      "status": "completed",
      "target_id": 12,
      "target_type": "agent"
    }
  },
  "event_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
  "type": "test-call.completed"
}

Mező	Típus	Leírás
`test_call_run.target_type`	string	`agent` vagy `phone_number`
`test_call_run.target_id`	integer	A futás által célzott AI-ügynök-azonosító vagy telefonszám-azonosító, a `target_type` értékének megfelelően
`test_call_run.status`	string	`completed` vagy `failed`
`test_call_run.call_id`	integer \| null	`null`, ha a futás a hívás kezdeményezése előtt sikertelen volt
`test_call_run.error_message`	string	Siker esetén üres

Riasztási események

`alert.triggered`

Akkor küldjük, amikor egy riasztási szabály, amelynél engedélyezve van a Kézbesítés fejlesztői webhookokba csatorna, átlépi a küszöbértékét. Nem blokkoló. Egy szabály egyszer aktiválódik, majd betartja a várakozási idejét, így a tartós küszöbsértés várakozási időablakonként egy eseményt eredményez.

{
  "data": {
    "comparator": "lt",
    "event_id": "b8e6a1d4-2c3f-4a5b-9c8d-7e6f5a4b3c2d",
    "fired_at": "2026-04-20T18:00:00+00:00",
    "metric": "success_rate",
    "metric_value": 71.4,
    "rule_id": "d2c3b4a5-6f7e-4d8c-9b0a-1c2d3e4f5a6b",
    "rule_name": "Success rate below 80%",
    "threshold": 80.0,
    "window_hours": 24
  },
  "event_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
  "type": "alert.triggered"
}

Mező	Típus	Leírás
`event_id` (a `data` mezőben)	UUID	A riasztás aktiválási azonosítója — eltér a boríték kézbesítési `event_id` értékétől
`rule_id`, `rule_name`	UUID, karakterlánc	Az aktiválódott szabály
`metric`	karakterlánc	`success_rate`, `failure_rate`, `avg_score`, `call_volume` vagy `suite_regression`
`comparator`	karakterlánc	`lt`, `lte`, `gt` vagy `gte`
`metric_value`	szám	A metrika értéke az időablakban, amikor a szabály aktiválódott
`threshold`	szám	A beállított küszöbérték
`window_hours`	egész szám	Visszatekintő kiértékelési időablak
`fired_at`	időbélyeg

A szabályok, metrikák, várakozási idők, valamint az e-mailes / Slack-csatornák beállításához tekintse meg a Riasztások útmutatót.

Kapcsolódó

telephony.incoming / web.incoming

A blokkoló bejövőhívás-adatcsomag, amelyre válaszolnia kell.

telephony.complete / web.complete

Hívás utáni átirat és metrikák.

Webhook-végpontok

Iratkoztasson fel egy URL-t ezen események egy részhalmazára.

Függvényeszközök

A telephony.tool / web.tool események létrehozásának módja.

Webhooks

Function Tools

Hívásesemények

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Minőségi események

`call.graded`

`issue.reported`

Teszthívási események

`test-call.completed`

Riasztási események

`alert.triggered`

Kapcsolódó

telephony.incoming / web.incoming

telephony.complete / web.complete

Webhook-végpontok

Függvényeszközök

​Hívásesemények

​telephony.incoming

​telephony.complete

​telephony.tool

​web.incoming

​web.complete

​web.tool

​Minőségi események

​call.graded

​issue.reported

​Teszthívási események

​test-call.completed

​Riasztási események

​alert.triggered

​Kapcsolódó

telephony.incoming / web.incoming

telephony.complete / web.complete

Webhook-végpontok

Függvényeszközök

Hívásesemények

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Minőségi események

`call.graded`

`issue.reported`

Teszthívási események

`test-call.completed`

Riasztási események

`alert.triggered`

Kapcsolódó