Hendelseskatalog

Hver webhook-forespørselskropp har et type-felt med en verdi som er én av hendelsestypene på denne siden. Når du abonnerer på et endepunkt, må events-matrisen inneholde hendelsestypene du ønsker (eller være tom for å abonnere på alt). Disse hendelsene leveres på to måter:

Endepunktleveringer er alltid ikke-blokkerende varsler med nye forsøk: svar med en hvilken som helst 2xx; konvolutten inneholder en event_id for deduplisering.
Blokkerende utvekslinger kjøres kun på eldre webhook med én URL: konfigurasjonsforespørselen telephony.incoming / web.incoming (numre i webhook-modus og widgetnøkler, tidsavbrudd på 10 s) og verktøydistribusjon i webhook-modus verktøydistribusjon. Svaret ditt former den pågående samtalen.

Eksempelnedlastingene nedenfor viser endepunktkonvolutten i overføringsrekkefølge (nøkler sortert alfabetisk: data, event_id, type); eldre leveringer inneholder samme data uten event_id.

Anropshendelser

`telephony.incoming`

Sendes når et innkommende anrop når et av telefonnumrene dine. Leveringer til endepunkt er send-og-glem-varsler som sendes for hvert innkommende anrop, enten nummeret er konfigurert for en agent eller en webhook. Numre uten en tilordnet agent mottar i tillegg den blokkerende konfigurasjonsforespørselen på den eldre webhooken — se telephony.incoming / web.incoming for hele forespørsels-/svarskjemaet.

{
  "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 innkommende eller utgående telefoni-anrop avsluttes. Ikke-blokkerende. Inkluderer transkripsjonen, URL for opptak når den er tilgjengelig, og en faktureringsoppsummering. Se telephony.complete / web.complete for payload-skjemaet.

`telephony.tool`

Sendes etter at et telefoni-anrop har kalt et funksjonsverktøy. Ikke-blokkerende revisjonsvarsel — verktøyet er allerede kjørt når denne hendelsen leveres; den dekker dine egne funksjonsverktøy (ikke innebygde verktøy, kunnskapsbaseverktøy, app-tilkoblingsverktøy eller MCP-verktøy).

{
  "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 resultatet som ble kjørt: {"status": <http status>, "response": <your endpoint's JSON>} ved suksess, eller {"status": <status>, "error": "<message>"} ved feil.

`web.incoming`

Netkanalekvivalenten til telephony.incoming, sendt når en nettwidget-økt eller et mikrofontestanrop i byggeren starter. Leveringer til endepunkt er send-og-glem for hver nettøkt. Publiserbare nøkler i mode="webhook" mottar i tillegg den blokkerende konfigurasjonsforespørselen på den eldre webhooken — denne blokkerende forespørselen har en annen form (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 alltid den bokstavelige verdien "web". For widgetøkter i webhook-modus er to_number tomt (øktens agentnummer tilordnes etter konfigurasjon); for mikrofontestanrop i byggeren er origin_domain og publishable_key_prefix tomme.

`web.complete`

Netkanalekvivalenten til telephony.complete, som dekker anrop fra nettwidgeten (direction: "web") og mikrofontestanrop i byggeren (direction: "test"). Ikke-blokkerende. Samme payload-form som telephony.complete, i tillegg til origin_domain, med from_number satt til "web".

På den eldre webhooken med én URL rapporteres mikrofontestanrop i byggeren historisk som telephony.complete — bare anrop med direction: "web" bruker typen web.complete der. Endepunktssystemet tilordner både nett- og testanrop til web.*. Historiske payload-er kan inneholde de eldre direction-verdiene widget eller mic.

`web.tool`

Netkanalekvivalenten til telephony.tool. data inneholder origin_domain i stedet for from_number / to_number.

Stemmehendinger

Opprettelse av egendefinerte stemmer er asynkron. Disse ikke-blokkerende hendelsene lar deg reagere på et endelig resultat i stedet for å spørre etter status fra klonedetaljendepunktet.

`voice.ready`

Sendes når en egendefinert stemme er ferdig behandlet og kan tilordnes til en agent.

{
  "data": {
    "voice": {
      "created_at": "2026-07-30T14:12:08.317Z",
      "display_name": "Support voice",
      "failure_reason": "",
      "gender": "female",
      "id": "cv_2f6f90b0e9a34ee8b39be7d1",
      "language": "en",
      "name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
      "status": "ready",
      "updated_at": "2026-07-30T14:13:31.605Z"
    }
  },
  "event_id": "2d5f0a61-e9b5-4a3c-b684-29d7d9e4b214",
  "type": "voice.ready"
}

`voice.failed`

Sendes når behandlingen av en egendefinert stemme ender i en permanent feil.

{
  "data": {
    "reason": "audio sample could not be processed",
    "voice": {
      "created_at": "2026-07-30T14:12:08.317Z",
      "display_name": "Support voice",
      "failure_reason": "audio sample could not be processed",
      "gender": "female",
      "id": "cv_2f6f90b0e9a34ee8b39be7d1",
      "language": "en",
      "name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
      "status": "failed",
      "updated_at": "2026-07-30T14:13:31.605Z"
    }
  },
  "event_id": "3493e985-1a75-4f77-a10a-e74af440cd31",
  "type": "voice.failed"
}

Felt	Type	Beskrivelse
`voice.id`	string	Offentlig ID for egendefinert stemme
`voice.name`	string	Stemmeverdi for agenten på formen `custom:<public_id>`
`voice.display_name`	string	Organisasjonsrettet stemmenavn
`voice.language`	string	Klonens språkkode
`voice.gender`	string	`male`, `female` eller en tom streng
`voice.status`	string	`ready` for `voice.ready`; `failed` for `voice.failed`
`voice.failure_reason`	string	Tom ved suksess; detaljer om behandlingsfeil ved feil
`voice.created_at`, `voice.updated_at`	timestamp	ISO 8601-tidsstempler
`reason`	string	Feildetaljer; finnes bare på `voice.failed`

Kvalitetshendelser

`call.graded`

Sendes hver gang en AI-vurderingskjøring fullføres for et anrop. Ikke-blokkerende.

{
  "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`	heltall	Vurderings-ID
`grade.score`	heltall \| null	0–100
`grade.call_outcome`	streng	`success`, `failure`, `unknown` eller `no_conversation`
`grade.summary`	streng	Sammendrag på ett avsnitt
`grade.detected_issues`	array	Problemstrenger funnet av vurdereren
`grade.status`	streng	Alltid `completed` — bare fullførte kjøringer sender hendelser
`grade.grader_model`	streng	Hvilken vurderingsmodell som produserte resultatet (f.eks. `heuristic-v1`)
`grade.graded_at`, `grade.created_at`	tidsstempel

Et anrop kan vurderes mer enn én gang — en rask heuristisk vurdering etterfølges ofte av en full modellvurdering når opptaket er tilgjengelig, og manuelle revurderinger er mulige. Hver fullførte kjøring sender sin egen call.graded-hendelse; behandle den nyeste graded_at som autoritativ.

`issue.reported`

Sendes når en problemrapport opprettes — enten sendt inn av en bruker fra dashbordet (source: "user") eller automatisk av anropsvurdering (source: "system"). Ikke-blokkerende.

{
  "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`	streng	`critical`, `warning` eller `info`
`issue_report.status`	streng	`open` eller `resolved`
`issue_report.source`	streng	`user` (sendt inn fra dashbordet) eller `system` (opprettet av vurdering)

Revurdering av et anrop bygger opp systemgenererte problemrapporter på nytt, noe som sender issue.reported på nytt for de gjenskapte rapportene. Dedupliser på call_id + title hvis du bare vil ha ett varsel per underliggende problem.

Testanrophendelser

`test-call.completed`

Sendes når en testanropskjøring når en endelig status — completed eller failed, inkludert kjøringer som mislyktes ved oppstart og aldri opprettet et anrop. Ikke-blokkerende. Nyttig for å koble CI-kjøringer i batch til chat- og varslingssystemene dine.

{
  "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`	streng	`agent` eller `phone_number`
`test_call_run.target_id`	heltall	Agent-ID-en eller telefonnummer-ID-en som kjøringen var rettet mot, i samsvar med `target_type`
`test_call_run.status`	streng	`completed` eller `failed`
`test_call_run.call_id`	heltall \| null	`null` når kjøringen mislyktes før et anrop ble foretatt
`test_call_run.error_message`	streng	Tom ved suksess

Varselhendelser

`alert.triggered`

Sendes når en varselregel med kanalen Lever til utviklerwebhooker aktivert overskrider terskelen sin. Ikke-blokkerende. En regel utløses én gang og respekterer deretter nedkjølingsperioden, så et vedvarende brudd gir én hendelse per nedkjølingsvindu.

{
  "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	Varsel-utløsnings-ID-en — forskjellig fra konvoluttens `event_id` for levering
`rule_id`, `rule_name`	UUID, streng	Regelen som ble utløst
`metric`	streng	`success_rate`, `failure_rate`, `avg_score`, `call_volume` eller `suite_regression`
`comparator`	streng	`lt`, `lte`, `gt` eller `gte`
`metric_value`	tall	Metrikkens verdi i vinduet da regelen ble utløst
`threshold`	tall	Den konfigurerte terskelen
`window_hours`	heltall	Etterfølgende evalueringsvindu
`fired_at`	tidsstempel

Se veiledningen for varsler for å opprette regler, målinger, nedkjølingsperioder og e-post- / Slack-kanalene.

Relatert

telephony.incoming / web.incoming

Den blokkerende nyttelasten for innkommende anrop som du må svare på.

telephony.complete / web.complete

Transkripsjon og målinger etter anropet.

Webhook-endepunkter

Abonner en URL på et delsett av disse hendelsene.

Funksjonsverktøy

Slik genereres hendelser for telephony.tool / web.tool.

Webhooks

Function Tools

Anropshendelser

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Stemmehendinger

`voice.ready`

`voice.failed`

Kvalitetshendelser

`call.graded`

`issue.reported`

Testanrophendelser

`test-call.completed`

Varselhendelser

`alert.triggered`

Relatert

telephony.incoming / web.incoming

telephony.complete / web.complete

Webhook-endepunkter

Funksjonsverktøy

​Anropshendelser

​telephony.incoming

​telephony.complete

​telephony.tool

​web.incoming

​web.complete

​web.tool

​Stemmehendinger

​voice.ready

​voice.failed

​Kvalitetshendelser

​call.graded

​issue.reported

​Testanrophendelser

​test-call.completed

​Varselhendelser

​alert.triggered

​Relatert

telephony.incoming / web.incoming

telephony.complete / web.complete

Webhook-endepunkter

Funksjonsverktøy

Anropshendelser

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Stemmehendinger

`voice.ready`

`voice.failed`

Kvalitetshendelser

`call.graded`

`issue.reported`

Testanrophendelser

`test-call.completed`

Varselhendelser

`alert.triggered`

Relatert