> ## 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. # Hændelseskatalog > Alle webhook-hændelsestyper, som ThunderPhone udsender. Hver webhook-brødtekst har et `type`-felt, hvis værdi er en af hændelsestyperne på denne side. Når du abonnerer på et [endpoint](/da/webhooks/endpoints), skal `events`-arrayet indeholde de hændelsestyper, du ønsker (eller være tomt for at abonnere på alt). Disse hændelser leveres på to måder: * **Endpoint-leveringer** er altid **ikke-blokerende** notifikationer med [genforsøg](/da/webhooks/overview): svar med en vilkårlig 2xx; konvolutten indeholder et `event_id`, som kan bruges til deduplikering. * **Blokerende** udvekslinger kører kun på den [ældre webhook med én URL](/da/webhooks/overview): konfigurationsanmodningen [`telephony.incoming` / `web.incoming`](/da/webhooks/call-incoming) (numre i webhook-tilstand og widgetnøgler, timeout på 10 s) og [værktøjsdistribuering](/da/tools/overview) i webhook-tilstand. Dit svar former det aktive opkald. Eksempel-payloads nedenfor viser endpoint-konvolutten i dens overførselsrækkefølge (nøgler sorteret alfabetisk: `data`, `event_id`, `type`); ældre leveringer indeholder de samme `data` uden `event_id`. ## Opkaldshændelser ### `telephony.incoming` Sendes, når et indgående opkald når et af dine [telefonnumre](/api-reference/phone-numbers). Endpointleveringer er fire-and-forget-notifikationer, der sendes for **alle** indgående opkald, uanset om nummeret er agentkonfigureret eller webhookkonfigureret. Numre uden en tildelt agent modtager desuden den **blokerende** konfigurationsanmodning på den ældre webhook — se [`telephony.incoming` / `web.incoming`](/da/webhooks/call-incoming) for det fulde anmodnings- / svarskema. ```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` Sendes, når et indgående eller udgående telefoniopkald afsluttes. Ikke-blokerende. Inkluderer den fulde transskription, optagelses-URL og faktureringsoversigt. Se [`telephony.complete` / `web.complete`](/da/webhooks/call-complete) for payloadskemaet. ### `telephony.tool` Sendes, efter et telefoniopkald kalder et [funktionsværktøj](/da/tools/overview). Ikke-blokerende revisionsnotifikation — værktøjet er allerede kørt, når denne hændelse leveres; den dækker dine egne funktionsværktøjer (ikke indbyggede værktøjer, værktøjer til vidensbase, appforbindelser eller MCP-værktøjer). ```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` er det udførte resultat: `{"status": , "response": }` ved succes eller `{"status": , "error": ""}` ved fejl. ### `web.incoming` Webkanalens pendant til `telephony.incoming`, som sendes, når en [webwidget](/da/widget/overview)-session eller et builder-mikrofontestopkald starter. Endpointleveringer er fire-and-forget for alle websessioner. Offentlige nøgler i `mode="webhook"` modtager desuden den **blokerende** konfigurationsanmodning på den ældre webhook — den blokerende anmodning har en anden struktur (`origin_domain`, `publishable_key_prefix`; ingen telefonnumre). Se [`telephony.incoming` / `web.incoming`](/da/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` er altid den bogstavelige værdi `"web"`. For webwidget- sessioner i webhooktilstand er `to_number` tomt (sessionens agentnummer tildeles efter konfiguration); for builder-mikrofontestopkald er `origin_domain` og `publishable_key_prefix` tomme. ### `web.complete` Webkanalens pendant til `telephony.complete`, som dækker webwidgetopkald (`direction: "web"`) og builder-mikrofontestopkald (`direction: "test"`). Ikke-blokerende. Samme payloadstruktur som [`telephony.complete`](/da/webhooks/call-complete), plus `origin_domain`, med `from_number` indstillet til `"web"`. På den ældre webhook med én URL rapporteres builder-mikrofontestopkald historisk som `telephony.complete` — kun opkald med `direction: "web"` bruger typen `web.complete` der. Endpointsystemet knytter både web- og testopkald til `web.*`. Historiske payloads kan indeholde de ældre `direction`-værdier `widget` eller `mic`. ### `web.tool` Webkanalens pendant til `telephony.tool`. `data` indeholder `origin_domain` i stedet for `from_number` / `to_number`. *** ## Kvalitetshændelser ### `call.graded` Sendes, når en [AI-vurderingskørsel](/api-reference/calls#ai-call-grading) afsluttes for et opkald. Blokerer ikke. ```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" } ``` | Felt | Type | Beskrivelse | | ------------------------------------- | --------------- | -------------------------------------------------------------------------- | | `grade.id` | integer | Vurderings-id | | `grade.score` | integer \| null | 0–100 | | `grade.call_outcome` | string | `success`, `failure`, `unknown` eller `no_conversation` | | `grade.summary` | string | Opsummering på ét afsnit | | `grade.detected_issues` | array | Problemstrenge fundet af vurderingsmodellen | | `grade.status` | string | Altid `completed` — kun afsluttede kørsler udsender | | `grade.grader_model` | string | Hvilken vurderingsmodel der producerede resultatet (f.eks. `heuristic-v1`) | | `grade.graded_at`, `grade.created_at` | timestamp | | Et opkald kan vurderes mere end én gang — en hurtig heuristisk vurdering efterfølges ofte af en fuld modelvurdering, når optagelsen er tilgængelig, og manuelle genvurderinger er mulige. Hver afsluttet kørsel udsender sin egen `call.graded`-hændelse; behandl den seneste `graded_at` som autoritativ. ### `issue.reported` Sendes, når en [problemrapport](/api-reference/issue-reports) oprettes — enten indsendt af en bruger fra dashboardet (`source: "user"`) eller automatisk af opkaldsvurdering (`source: "system"`). Blokerer ikke. ```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" } ``` | Felt | Type | Beskrivelse | | ----------------------- | ------ | ------------------------------------------------------------------------ | | `issue_report.severity` | string | `critical`, `warning` eller `info` | | `issue_report.status` | string | `open` eller `resolved` | | `issue_report.source` | string | `user` (indsendt fra dashboardet) eller `system` (oprettet af vurdering) | Genvurdering af et opkald genopbygger dets systemgenererede problemrapporter, hvilket sender `issue.reported` igen for de genoprettede rapporter. Dedubliker på `call_id` + `title`, hvis du kun vil have én notifikation pr. underliggende problem. *** ## Hændelser for testopkald ### `test-call.completed` Sendes, når en [testopkaldskørsel](/api-reference/test-calls#test-call-run-object) når en endelig status — `completed` eller `failed`, herunder kørsler der mislykkedes ved opstart og aldrig oprettede et opkald. Blokerer ikke. Nyttig til at koble batch-CI-kørsler til dine chat- og notifikationssystemer. ```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" } ``` | Felt | Type | Beskrivelse | | ----------------------------- | --------------- | ------------------------------------------------------------------------------------------- | | `test_call_run.target_type` | string | `agent` eller `phone_number` | | `test_call_run.target_id` | integer | Agent-id'et eller telefonnummer-id'et, som kørslen målrettede, og som matcher `target_type` | | `test_call_run.status` | string | `completed` eller `failed` | | `test_call_run.call_id` | integer \| null | `null`, når kørslen mislykkedes, før et opkald blev foretaget | | `test_call_run.error_message` | string | Tom ved succes | *** ## Advarselsbegivenheder ### `alert.triggered` Sendes, når en [advarselsregel](/da/guides/alerts) med kanalen **Lever til udviklerwebhooks** aktiveret overskrider sin tærskel. Ikke-blokerende. En regel udløses én gang og respekterer derefter sin nedkølingsperiode, så en vedvarende overskridelse producerer én begivenhed pr. nedkølingsvindue. ```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" } ``` | Felt | Type | Beskrivelse | | ---------------------- | ------------ | ----------------------------------------------------------------------------------- | | `event_id` (i `data`) | UUID | Id for **udløsning** af advarslen — adskilt fra konvoluttens leverings-`event_id` | | `rule_id`, `rule_name` | UUID, streng | Reglen, der blev udløst | | `metric` | streng | `success_rate`, `failure_rate`, `avg_score`, `call_volume` eller `suite_regression` | | `comparator` | streng | `lt`, `lte`, `gt` eller `gte` | | `metric_value` | tal | Metrikkens værdi over vinduet, da reglen blev udløst | | `threshold` | tal | Den konfigurerede tærskel | | `window_hours` | heltal | Efterfølgende evalueringsvindue | | `fired_at` | tidsstempel | | Se [vejledningen til advarsler](/da/guides/alerts) for at oprette regler, metrikker, nedkølingsperioder og e-mail- / Slack-kanaler. *** ## Relateret Den blokerende payload for indgående opkald, som du skal svare på. Transskription og metrikker efter opkaldet. Abonner en URL på en delmængde af disse begivenheder. Sådan genereres `telephony.tool` / `web.tool`-begivenheder.