Notikumu katalogs

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, 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: 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ē: konfigurācijas pieprasījums telephony.incoming / web.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. 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. 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.

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

`telephony.tool`

Nosūta pēc tam, kad telefonijas zvans izsauc funkcijas rīku. 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).

{
  "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": <http status>, "response": <your endpoint's JSON>} veiksmes gadījumā vai {"status": <status>, "error": "<message>"} 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 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.

{
  "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, 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. Nebloķējošs.

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

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

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

{
  "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, lai izveidotu kārtulas, konfigurētu metrikas, atdzišanas periodus un e-pasta / Slack kanālus.

Saistītie

telephony.incoming / web.incoming

Bloķējošā ienākošā zvana slodze, uz kuru jums jāatbild.

telephony.complete / web.complete

Pēczvana transkripts un metrikas.

Tīmekļa aizķeru galapunkti

Reģistrējiet URL adresi, lai saņemtu šo notikumu apakškopu.

Funkciju rīki

Kā tiek ģenerēti telephony.tool / web.tool notikumi.

Webhooks

Function Tools

Zvanu notikumi

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Kvalitātes notikumi

`call.graded`

`issue.reported`

Testa zvanu notikumi

`test-call.completed`

Brīdinājumu notikumi

`alert.triggered`

Saistītie

telephony.incoming / web.incoming

telephony.complete / web.complete

Tīmekļa aizķeru galapunkti

Funkciju rīki

​Zvanu notikumi

​telephony.incoming

​telephony.complete

​telephony.tool

​web.incoming

​web.complete

​web.tool

​Kvalitātes notikumi

​call.graded

​issue.reported

​Testa zvanu notikumi

​test-call.completed

​Brīdinājumu notikumi

​alert.triggered

​Saistītie

telephony.incoming / web.incoming

telephony.complete / web.complete

Tīmekļa aizķeru galapunkti

Funkciju rīki

Zvanu notikumi

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

Kvalitātes notikumi

`call.graded`

`issue.reported`

Testa zvanu notikumi

`test-call.completed`

Brīdinājumu notikumi

`alert.triggered`

Saistītie