Įvykių katalogas

Kiekviename žiniatinklio kablio turinyje yra type laukas, kurio reikšmė yra vienas iš šiame puslapyje nurodytų įvykių tipų. Kai užsiprenumeruojate galinį tašką, events masyve turi būti norimi įvykių tipai (arba jis turi būti tuščias, jei norite prenumeruoti visus).

Šie įvykiai perduodami dviem būdais:

• Pristatymai į galinį tašką visada yra neblokuojantys pranešimai su pakartotiniais bandymais: atsakykite bet kuriuo 2xx kodu; voke pateikiamas event_id, skirtas dubliavimui pašalinti.
• Blokuojantys apsikeitimai vykdomi tik naudojant senąjį vieno URL žiniatinklio kablį: telephony.incoming / web.incoming konfigūracijos užklausą (žiniatinklio kablio režimo numeriai ir valdiklio raktai, 10 s laukimo laikas) ir žiniatinklio kablio režimo įrankio siuntimą. Jūsų atsakymas formuoja tiesioginį skambutį.

Toliau pateikti pavyzdiniai duomenų paketai rodo galinio taško voką perdavimo tvarka (raktai surikiuoti abėcėlės tvarka: data, event_id, type); senuosiuose pristatymuose pateikiami tie patys data be event_id.

Skambučių įvykiai

telephony.incoming

Siunčiamas, kai į vieną iš jūsų telefono numerių gaunamas įeinantis skambutis. Pristatymai į galinį tašką yra pranešimai, siunčiami nebelaukiant atsakymo, apie kiekvieną įeinantį skambutį, nesvarbu, ar numeris sukonfigūruotas agentui, ar webhook. Numeriai be priskirto agento papildomai gauna blokuojančią konfigūracijos užklausą senajame webhook — visą užklausos / atsakymo schemą žr. 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

Siunčiamas, kai baigiasi įeinantis arba išeinantis telefonijos skambutis. Neblokuojantis. Apima transkripciją, įrašo URL, kai jis pasiekiamas, ir atsiskaitymo suvestinę. Duomenų struktūros schemą žr. telephony.complete / web.complete.

telephony.tool

Siunčiamas, kai telefonijos skambučio metu iškviečiamas funkcijos įrankis. Neblokuojantis audito pranešimas — įrankis jau įvykdytas, kai pristatomas šis įvykis; jis apima jūsų pačių funkcijų įrankius (ne integruotus, žinių bazės, programos ryšio ar MCP įrankius).

{
  "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 yra įvykdymo rezultatas: sėkmės atveju {"status": <http status>, "response": <your endpoint's JSON>}, o nesėkmės atveju — {"status": <status>, "error": "<message>"}.

web.incoming

telephony.incoming atitikmuo žiniatinklio kanale, siunčiamas, kai prasideda žiniatinklio valdiklio sesija arba kūrimo priemonės mikrofono bandomasis skambutis. Pristatymai į galinį tašką siunčiami nebelaukiant atsakymo apie kiekvieną žiniatinklio sesiją. Viešieji raktai, kurių mode="webhook", papildomai gauna blokuojančią konfigūracijos užklausą senajame webhook — ši blokuojanti užklausa turi kitokią struktūrą (origin_domain, publishable_key_prefix; nėra telefono numerių). Žr. 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 visada yra tiesiog "web". Valdiklio sesijose webhook režimu to_number yra tuščias (sesijos agento numeris priskiriamas po konfigūracijos); kūrimo priemonės mikrofono bandomuosiuose skambučiuose origin_domain ir publishable_key_prefix yra tušti.

web.complete

telephony.complete atitikmuo žiniatinklio kanale, apimantis žiniatinklio valdiklio skambučius (direction: "web") ir kūrimo priemonės mikrofono bandomuosius skambučius (direction: "test"). Neblokuojantis. Duomenų struktūra tokia pati kaip telephony.complete, papildomai įtraukiant origin_domain, o from_number nustatomas kaip "web".

web.tool

telephony.tool atitikmuo žiniatinklio kanale. data pateikia origin_domain vietoje from_number / to_number.

Balso įvykiai

Pasirinktinio balso kūrimas yra asinchroninis. Šie neblokuojantys įvykiai leidžia jums reaguoti į galutinį rezultatą, užuot vykdžius apklausą balso klono išsamios informacijos galiniame taške.

voice.ready

Siunčiamas, kai pasirinktinis balsas baigia apdorojimą ir gali būti priskirtas agentui.

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

Siunčiamas, kai pasirinktinio balso apdorojimas baigiasi negrįžtama klaida.

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

Kokybės įvykiai

call.graded

Siunčiamas, kai užbaigiamas skambučio DI vertinimo vykdymas. Nevykdomas blokuojant.

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

issue.reported

Siunčiamas, kai sukuriama problemos ataskaita — ją naudotojas pateikia iš valdymo skydelio (source: "user") arba ji sukuriama automatiškai vertinant skambutį (source: "system"). Nevykdomas blokuojant.

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

Bandomųjų skambučių įvykiai

test-call.completed

Siunčiamas, kai bandomojo skambučio vykdymas pasiekia galutinę būseną — completed arba failed, įskaitant vykdymus, kurie nepavyko paleidimo metu ir niekada nesukūrė skambučio. Nevykdomas blokuojant. Naudinga susiejant paketinius CI vykdymus su pokalbių ir pranešimų sistemomis.

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

Įspėjimų įvykiai

alert.triggered

Siunčiamas, kai įspėjimo taisyklė, kuriai įjungtas kanalas Pristatyti į kūrėjo žiniatinklio kablius, pasiekia savo ribinę reikšmę. Neblokuojantis. Taisyklė suveikia vieną kartą ir tada laikosi savo atvėsimo laikotarpio, todėl tęstinis pažeidimas sukuria vieną įvykį per kiekvieną atvėsimo laikotarpio langą.

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

Taisyklių, metrikų, atvėsimo laikotarpių ir el. pašto / Slack kanalų kūrimą rasite Įspėjimų vadove.

Susiję