> ## 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. # Notikumu katalogs > Visi tīmekļa aizķeres notikumu veidi, ko izvada ThunderPhone. Katra tīmekļa aizķeres pamattekstā ir lauks `type`, kura vērtība ir viens no šajā lapā norādītajiem notikumu tipiem. Abonējot [galapunktu](/lv/webhooks/endpoints), masīvā `events` ir jāiekļauj vajadzīgie notikumu tipi (vai tas jāatstāj tukšs, lai abonētu visus notikumus). Šie notikumi tiek nosūtīti divos veidos: * **Galapunktu piegādes** vienmēr ir **nebloķējoši** paziņojumi ar [atkārtotiem mēģinājumiem](/lv/webhooks/overview): atbildiet ar jebkuru 2xx; aploksnē ir `event_id`, ko izmantot deduplikācijai. * **Bloķējošas** apmaiņas notiek tikai [mantotajā vienas URL tīmekļa aizķerē](/lv/webhooks/overview): konfigurācijas pieprasījums [`telephony.incoming` / `web.incoming`](/lv/webhooks/call-incoming) (numuri tīmekļa aizķeres režīmā un logrīku atslēgas, 10 s taimauts) un tīmekļa aizķeres režīma [rīku nosūtīšana](/lv/tools/overview). Jūsu atbilde nosaka aktīvā zvana gaitu. Tālāk sniegtie piemēra dati rāda galapunkta aploksni tās pārsūtīšanas secībā (atslēgas sakārtotas alfabētiski: `data`, `event_id`, `type`); mantotajās piegādēs tiek nosūtīts tas pats `data` bez `event_id`. ## Zvanu notikumi ### `telephony.incoming` Nosūta, kad ienākošais zvans sasniedz kādu no jūsu [tālruņa numuriem](/api-reference/phone-numbers). Galapunkta piegādes ir fire-and-forget paziņojumi, kas tiek nosūtīti par **katru** ienākošo zvanu neatkarīgi no tā, vai numurs ir konfigurēts balss aģentam vai tīmekļa aizķerei. Numuri bez piešķirta balss aģenta papildus saņem **bloķējošu** konfigurācijas pieprasījumu mantotajā tīmekļa aizķerē — pilnu pieprasījuma / atbildes shēmu skatiet [`telephony.incoming` / `web.incoming`](/lv/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` Nosūta, kad beidzas ienākošs vai izejošs telefonijas zvans. Nebloķējošs. Ietver pilnu transkriptu, ieraksta URL un norēķinu kopsavilkumu. Datu struktūras shēmu skatiet [`telephony.complete` / `web.complete`](/lv/webhooks/call-complete). ### `telephony.tool` Nosūta pēc tam, kad telefonijas zvans izsauc [funkcijas rīku](/lv/tools/overview). Nebloķējošs audita paziņojums — rīks jau ir izpildīts, kad šis notikums tiek piegādāts; tas attiecas uz jūsu pašu funkciju rīkiem (nevis iebūvētiem, zināšanu bāzes, lietotņu savienojumu vai MCP rīkiem). ```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" } ``` `response` ir izpildes rezultāts: `{"status": , "response": }` veiksmes gadījumā vai `{"status": , "error": ""}` kļūmes gadījumā. ### `web.incoming` `telephony.incoming` ekvivalents tīmekļa kanālam, kas tiek nosūtīts, kad sākas [tīmekļa logrīka](/lv/widget/overview) sesija vai veidotāja mikrofona testa zvans. Galapunkta piegādes ir fire-and-forget paziņojumi par katru tīmekļa sesiju. Publicējamās atslēgas režīmā `mode="webhook"` papildus saņem **bloķējošu** konfigurācijas pieprasījumu mantotajā tīmekļa aizķerē — šim bloķējošajam pieprasījumam ir cita struktūra (`origin_domain`, `publishable_key_prefix`; nav tālruņa numuru). Skatiet [`telephony.incoming` / `web.incoming`](/lv/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" } ``` `from_number` vienmēr ir burtiskā vērtība `"web"`. Logrīka sesijām tīmekļa aizķeres režīmā `to_number` ir tukšs (sesijas balss aģenta numurs tiek piešķirts pēc konfigurēšanas); veidotāja mikrofona testa zvaniem `origin_domain` un `publishable_key_prefix` ir tukši. ### `web.complete` `telephony.complete` ekvivalents tīmekļa kanālam, kas aptver tīmekļa logrīka zvanus (`direction: "web"`) un veidotāja mikrofona testa zvanus (`direction: "test"`). Nebloķējošs. Tāda pati datu struktūra kā [`telephony.complete`](/lv/webhooks/call-complete), papildināta ar `origin_domain`, kur `from_number` ir iestatīts uz `"web"`. Mantotajā viena URL tīmekļa aizķerē veidotāja mikrofona testa zvani vēsturiski tiek ziņoti kā `telephony.complete` — tur tipu `web.complete` izmanto tikai zvani ar `direction: "web"`. Galapunktu sistēma gan tīmekļa, gan testa zvanus kartē uz `web.*`. Vēsturiskās datu struktūrās var būt mantotās `direction` vērtības `widget` vai `mic`. ### `web.tool` `telephony.tool` ekvivalents tīmekļa kanālam. `data` ietver `origin_domain`, nevis `from_number` / `to_number`. *** ## Kvalitātes notikumi ### `call.graded` Tiek nosūtīts ikreiz, kad zvanam tiek pabeigta [AI vērtēšanas izpilde](/api-reference/calls#ai-call-grading). Nebloķējošs. ```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" } ``` | Lauks | Tips | Apraksts | | ------------------------------------- | --------------- | -------------------------------------------------------------- | | `grade.id` | integer | Vērtējuma ID | | `grade.score` | integer \| null | 0–100 | | `grade.call_outcome` | string | `success`, `failure`, `unknown` vai `no_conversation` | | `grade.summary` | string | Vienas rindkopas kopsavilkums | | `grade.detected_issues` | array | Vērtētāja atrastās problēmu virknes | | `grade.status` | string | Vienmēr `completed` — notikumu ģenerē tikai pabeigtas izpildes | | `grade.grader_model` | string | Vērtētājs, kas ģenerēja rezultātu (piem., `heuristic-v1`) | | `grade.graded_at`, `grade.created_at` | timestamp | | Zvanu var vērtēt vairāk nekā vienu reizi — ātram heiristiskajam vērtējumam bieži seko pilns modeļa vērtējums, tiklīdz ir pieejams ieraksts, un ir iespējama arī manuāla atkārtota vērtēšana. Katra pabeigtā izpilde ģenerē savu `call.graded` notikumu; par autoritatīvu uzskatiet jaunāko `graded_at`. ### `issue.reported` Tiek nosūtīts, kad tiek izveidots [problēmas ziņojums](/api-reference/issue-reports) — to lietotājs iesniedz no informācijas paneļa (`source: "user"`) vai tas tiek automātiski izveidots zvana vērtēšanas laikā (`source: "system"`). Nebloķējošs. ```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" } ``` | Lauks | Tips | Apraksts | | ----------------------- | ------ | ----------------------------------------------------------------------------------- | | `issue_report.severity` | string | `critical`, `warning` vai `info` | | `issue_report.status` | string | `open` vai `resolved` | | `issue_report.source` | string | `user` (iesniegts no informācijas paneļa) vai `system` (izveidots vērtēšanas laikā) | Atkārtoti vērtējot zvanu, tiek no jauna izveidoti tā sistēmas ģenerētie problēmu ziņojumi, tādēļ atkārtoti tiek ģenerēts `issue.reported` notikums atkārtoti izveidotajiem ziņojumiem. Dublējumu novēršanai izmantojiet `call_id` + `title`, ja vēlaties tikai vienu paziņojumu par katru pamatā esošo problēmu. *** ## Testa zvanu notikumi ### `test-call.completed` Tiek nosūtīts, kad [testa zvana izpilde](/api-reference/test-calls#test-call-run-object) sasniedz beigu statusu — `completed` vai `failed`, tostarp izpildēm, kas neizdevās palaišanas laikā un nekad neizveidoja zvanu. Nebloķējošs. Noderīgs, lai pakešveida CI izpildes savienotu ar tērzēšanas vai paziņojumu sistēmām. ```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" } ``` | Lauks | Tips | Apraksts | | ----------------------------- | --------------- | -------------------------------------------------------------------------------------------- | | `test_call_run.target_type` | string | `agent` vai `phone_number` | | `test_call_run.target_id` | integer | Balss aģenta ID vai tālruņa numura ID, uz kuru bija vērsta izpilde, atbilstoši `target_type` | | `test_call_run.status` | string | `completed` vai `failed` | | `test_call_run.call_id` | integer \| null | `null`, ja izpilde neizdevās, pirms tika veikts zvans | | `test_call_run.error_message` | string | Veiksmīgas izpildes gadījumā tukšs | *** ## Brīdinājumu notikumi ### `alert.triggered` Tiek nosūtīts, kad [brīdinājuma kārtula](/lv/guides/alerts) ar iespējotu kanālu **Piegādāt uz izstrādātāju tīmekļa aizķerēm** šķērso savu slieksni. Nebloķējošs. Kārtula tiek aktivizēta vienreiz un pēc tam ievēro savu atdzišanas periodu, tāpēc ilgstošs pārkāpums rada vienu notikumu katrā atdzišanas perioda logā. ```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" } ``` | Lauks | Tips | Apraksts | | ------------------------ | --------------- | --------------------------------------------------------------------------------- | | `event_id` (mapē `data`) | UUID | Brīdinājuma **aktivizēšanas** ID — atšķiras no aploksnes piegādes `event_id` | | `rule_id`, `rule_name` | UUID, virkne | Kārtula, kas tika aktivizēta | | `metric` | virkne | `success_rate`, `failure_rate`, `avg_score`, `call_volume` vai `suite_regression` | | `comparator` | virkne | `lt`, `lte`, `gt` vai `gte` | | `metric_value` | skaitlis | Metrikas vērtība logā, kad kārtula tika aktivizēta | | `threshold` | skaitlis | Konfigurētais slieksnis | | `window_hours` | vesels skaitlis | Atskatīšanās novērtēšanas logs | | `fired_at` | laikspiedols | | Skatiet [brīdinājumu ceļvedi](/lv/guides/alerts), lai izveidotu kārtulas, konfigurētu metrikas, atdzišanas periodus un e-pasta / Slack kanālus. *** ## Saistītie Bloķējošā ienākošā zvana slodze, uz kuru jums jāatbild. Pēczvana transkripts un metrikas. Reģistrējiet URL adresi, lai saņemtu šo notikumu apakškopu. Kā tiek ģenerēti `telephony.tool` / `web.tool` notikumi.