> ## Documentation Index > Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt > Use this file to discover all available pages before exploring further. # Eseménykatalógus > A ThunderPhone által kibocsátott összes webhookeseménytípus. 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](/hu/webhooks/endpoints), 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](/hu/webhooks/overview): 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](/hu/webhooks/overview) futnak: a [`telephony.incoming` / `web.incoming`](/hu/webhooks/call-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](/hu/tools/overview). 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](/api-reference/phone-numbers). 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`](/hu/webhooks/call-incoming). ```json theme={null} { "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`](/hu/webhooks/call-complete). ### `telephony.tool` Akkor kerül elküldésre, miután egy telefonhívás meghív egy [függvényeszközt](/hu/tools/overview). 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). ```json theme={null} { "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": , "response": }`, hiba esetén pedig `{"status": , "error": ""}`. ### `web.incoming` A `telephony.incoming` webcsatornás megfelelője, amely akkor kerül elküldésre, amikor egy [webes widget](/hu/widget/overview) 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`](/hu/webhooks/call-incoming). ```json theme={null} { "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`](/hu/webhooks/call-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](/api-reference/calls#ai-call-grading) befejeződik. Nem blokkoló. ```json theme={null} { "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](/api-reference/issue-reports) 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ó. ```json theme={null} { "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](/api-reference/test-calls#test-call-run-object) 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. ```json theme={null} { "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](/hu/guides/alerts), 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. ```json theme={null} { "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](/hu/guides/alerts). *** ## Kapcsolódó A blokkoló bejövőhívás-adatcsomag, amelyre válaszolnia kell. Hívás utáni átirat és metrikák. Iratkoztasson fel egy URL-t ezen események egy részhalmazára. A `telephony.tool` / `web.tool` események létrehozásának módja.