Hændelseskatalog

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, 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: 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: konfigurationsanmodningen telephony.incoming / web.incoming (numre i webhook-tilstand og widgetnøgler, timeout på 10 s) og værktøjsdistribuering 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. 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 for det fulde anmodnings- / svarskema.

{
  "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 for payloadskemaet.

`telephony.tool`

Sendes, efter et telefoniopkald kalder et funktionsværktøj. 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).

{
  "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": <http status>, "response": <your endpoint's JSON>} ved succes eller {"status": <status>, "error": "<message>"} ved fejl.

`web.incoming`

Webkanalens pendant til telephony.incoming, som sendes, når en webwidget-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.

{
  "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, 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 afsluttes for et opkald. Blokerer ikke.

{
  "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 oprettes — enten indsendt af en bruger fra dashboardet (source: "user") eller automatisk af opkaldsvurdering (source: "system"). Blokerer ikke.

{
  "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 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.

{
  "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 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.

{
  "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 for at oprette regler, metrikker, nedkølingsperioder og e-mail- / Slack-kanaler.

Relateret

telephony.incoming / web.incoming

Den blokerende payload for indgående opkald, som du skal svare på.

telephony.complete / web.complete

Transskription og metrikker efter opkaldet.

Webhook-slutpunkter

Abonner en URL på en delmængde af disse begivenheder.

Funktionsværktøjer

Sådan genereres telephony.tool / web.tool-begivenheder.

Webhooks

Function Tools

Opkaldshændelser

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Kvalitetshændelser

`call.graded`

`issue.reported`

Hændelser for testopkald

`test-call.completed`

Advarselsbegivenheder

`alert.triggered`

Relateret

telephony.incoming / web.incoming

telephony.complete / web.complete

Webhook-slutpunkter

Funktionsværktøjer

​Opkaldshændelser

​telephony.incoming

​telephony.complete

​telephony.tool

​web.incoming

​web.complete

​web.tool

​Kvalitetshændelser

​call.graded

​issue.reported

​Hændelser for testopkald

​test-call.completed

​Advarselsbegivenheder

​alert.triggered

​Relateret

telephony.incoming / web.incoming

telephony.complete / web.complete

Webhook-slutpunkter

Funktionsværktøjer

Opkaldshændelser

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Kvalitetshændelser

`call.graded`

`issue.reported`

Hændelser for testopkald

`test-call.completed`

Advarselsbegivenheder

`alert.triggered`

Relateret