ഇവന്റ് കാറ്റലോഗ്

ഓരോ വെബ്ഹുക്ക് ബോഡിയിലും ഈ പേജിലെ ഇവന്റ് തരങ്ങളിൽ ഒന്നായ മൂല്യമുള്ള type ഫീൽഡ് ഉണ്ടായിരിക്കും. നിങ്ങൾ ഒരു എൻഡ്‌പോയിന്റിലേക്ക് സബ്സ്ക്രൈബ് ചെയ്യുമ്പോൾ, events അറേയിൽ നിങ്ങൾക്ക് ആവശ്യമുള്ള ഇവന്റ് തരങ്ങൾ ഉൾപ്പെടണം (അല്ലെങ്കിൽ എല്ലാത്തിലേക്കും സബ്സ്ക്രൈബ് ചെയ്യാൻ അത് ശൂന്യമായിരിക്കണം).

രണ്ട് ഡെലിവറി ശൈലികൾ ഈ ഇവന്റുകൾ കൈമാറുന്നു:

• എൻഡ്‌പോയിന്റ് ഡെലിവറികൾ എല്ലായ്പ്പോഴും തടസ്സപ്പെടുത്താത്ത റീട്രൈകളോടുകൂടിയ അറിയിപ്പുകളാണ്: ഏതെങ്കിലും 2xx ഉപയോഗിച്ച് പ്രതികരിക്കുക; ഡീഡ്യൂപ്ലിക്കേഷനായി എൻവലപ്പിൽ event_id ഉണ്ടായിരിക്കും.
• തടസ്സപ്പെടുത്തുന്ന എക്സ്ചേഞ്ചുകൾ പ്രവർത്തിക്കുന്നത് ലെഗസി സിംഗിൾ-URL വെബ്ഹുക്കിൽ മാത്രമാണ്: telephony.incoming / web.incoming കോൺഫിഗറേഷൻ അഭ്യർത്ഥന (വെബ്ഹുക്ക്-മോഡ് നമ്പറുകളും വിജറ്റ് കീകളും, 10 s ടൈംഔട്ട്), കൂടാതെ വെബ്ഹുക്ക്-മോഡ് ടൂൾ ഡിസ്പാച്ച്. നിങ്ങളുടെ പ്രതികരണം തത്സമയ കോളിന്റെ രൂപം നിർണയിക്കുന്നു.

താഴെയുള്ള ഉദാഹരണ പേലോഡുകൾ വയർ ക്രമത്തിലുള്ള എൻഡ്‌പോയിന്റ് എൻവലപ്പ് കാണിക്കുന്നു (കീകൾ അക്ഷരമാലാക്രമത്തിൽ ക്രമീകരിച്ചിരിക്കുന്നു: data, event_id, type); ലെഗസി ഡെലിവറികളിൽ event_id ഇല്ലാതെ അതേ data ഉണ്ടായിരിക്കും.

കോൾ ഇവന്റുകൾ

telephony.incoming

ഒരു ഇൻബൗണ്ട് കോൾ നിങ്ങളുടെ ഫോൺ നമ്പറുകളിലൊന്നിൽ എത്തുമ്പോൾ അയയ്ക്കുന്നു. എൻഡ്‌പോയിന്റ് ഡെലിവറികൾ ഓരോ ഇൻബൗണ്ട് കോളിനും അയയ്ക്കുന്ന ഫയർ-ആൻഡ്-ഫർഗെറ്റ് അറിയിപ്പുകളാണ്, നമ്പർ ഏജന്റ്-കോൺഫിഗർ ചെയ്തതോ വെബ്ഹുക്ക്-കോൺഫിഗർ ചെയ്തതോ ആയാലും. നിയോഗിച്ച ഏജന്റ് ഇല്ലാത്ത നമ്പറുകൾക്ക്, ലെഗസി വെബ്ഹുക്കിൽ തടയുന്ന കോൺഫിഗറേഷൻ അഭ്യർത്ഥനയും ലഭിക്കും — പൂർണ്ണ അഭ്യർത്ഥന / പ്രതികരണ സ്കീമയ്ക്കായി 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

ഒരു ഇൻബൗണ്ട് അല്ലെങ്കിൽ ഔട്ട്ബൗണ്ട് ടെലിഫോണി കോൾ അവസാനിക്കുമ്പോൾ അയയ്ക്കുന്നു. തടയാത്തതാണ്. ട്രാൻസ്ക്രിപ്റ്റ്, ലഭ്യമാണെങ്കിൽ റെക്കോർഡിങ് URL, ബില്ലിങ് സംഗ്രഹം എന്നിവ ഉൾപ്പെടുന്നു. പേലോഡ് സ്കീമയ്ക്കായി telephony.complete / web.complete കാണുക.

telephony.tool

ഒരു ടെലിഫോണി കോൾ ഒരു ഫംഗ്ഷൻ ടൂൾ വിളിച്ചശേഷം അയയ്ക്കുന്നു. തടയാത്ത ഓഡിറ്റ് അറിയിപ്പാണിത് — ഈ ഇവന്റ് ഡെലിവർ ചെയ്യുമ്പോഴേക്കും ടൂൾ പ്രവർത്തിപ്പിച്ചുകഴിഞ്ഞിരിക്കും; ഇത് നിങ്ങളുടെ സ്വന്തം ഫംഗ്ഷൻ ടൂളുകളെ മാത്രമാണ് ഉൾക്കൊള്ളുന്നത് (ബിൽറ്റ്-ഇൻ, നോളജ്-ബേസ്, ആപ്പ്-കണക്ഷൻ, അല്ലെങ്കിൽ MCP ടൂളുകളല്ല).

{
  "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 പ്രവർത്തിപ്പിച്ച ഫലമാണ്: വിജയിക്കുമ്പോൾ {"status": <http status>, "response": <your endpoint's JSON>}, അല്ലെങ്കിൽ പരാജയപ്പെടുമ്പോൾ {"status": <status>, "error": "<message>"}.

web.incoming

telephony.incoming-ന്റെ വെബ്-ചാനൽ തുല്യരൂപം; ഒരു വെബ് വിജറ്റ് സെഷനോ ബിൽഡർ മൈക്ക് ടെസ്റ്റ് കോളോ ആരംഭിക്കുമ്പോൾ അയയ്ക്കുന്നു. എൻഡ്‌പോയിന്റ് ഡെലിവറികൾ എല്ലാ വെബ് സെഷനുകൾക്കും ഫയർ-ആൻഡ്-ഫർഗെറ്റ് ആണ്. mode="webhook"-ലുള്ള പബ്ലിഷബിൾ കീസിന് ലെഗസി വെബ്ഹുക്കിൽ തടയുന്ന കോൺഫിഗറേഷൻ അഭ്യർത്ഥനയും ലഭിക്കും — ആ തടയുന്ന അഭ്യർത്ഥനയ്ക്ക് വ്യത്യസ്ത രൂപമാണ് ഉള്ളത് (origin_domain, publishable_key_prefix; ഫോൺ നമ്പറുകളില്ല). 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 എപ്പോഴും "web" എന്ന ലിറ്ററലാണ്. വെബ്ഹുക്ക്-മോഡ് വിജറ്റ് സെഷനുകൾക്ക് to_number ശൂന്യമാണ് (കോൺഫിഗറേഷനുശേഷം സെഷന്റെ ഏജന്റ് നമ്പർ നിയോഗിക്കുന്നു); ബിൽഡർ മൈക്ക് ടെസ്റ്റ് കോളുകൾക്ക് origin_domain, publishable_key_prefix എന്നിവ ശൂന്യമാണ്.

web.complete

telephony.complete-ന്റെ വെബ്-ചാനൽ തുല്യരൂപം; വെബ് വിജറ്റ് കോളുകൾ (direction: "web") കൂടാതെ ബിൽഡർ മൈക്ക് ടെസ്റ്റ് കോളുകൾ (direction: "test") എന്നിവ ഉൾക്കൊള്ളുന്നു. തടയാത്തതാണ്. telephony.complete-ന്റെ അതേ പേലോഡ് രൂപമാണ്, origin_domain അധികമായി ഉൾപ്പെടും, കൂടാതെ from_number "web" ആയി സജ്ജീകരിച്ചിരിക്കും.

web.tool

telephony.tool-ന്റെ വെബ്-ചാനൽ തുല്യരൂപം. data, from_number / to_number-ന് പകരം origin_domain ഉൾക്കൊള്ളുന്നു.

വോയ്‌സ് ഇവന്റുകൾ

ഇഷ്‌ടാനുസൃത വോയ്‌സ് സൃഷ്ടിക്കൽ അസമന്വിതമാണ്. ഈ ബ്ലോക്ക് ചെയ്യാത്ത ഇവന്റുകൾ, ക്ലോൺ വിശദാംശ എൻഡ്‌പോയിന്റ് പോൾ ചെയ്യുന്നതിന് പകരം, ഒരു അന്തിമ ഫലത്തോട് പ്രതികരിക്കാൻ നിങ്ങളെ അനുവദിക്കുന്നു.

voice.ready

ഇഷ്‌ടാനുസൃത വോയ്‌സ് പ്രോസസ്സിംഗ് പൂർത്തിയാക്കി ഒരു ഏജന്റിന് അസൈൻ ചെയ്യാനാകുമ്പോൾ അയയ്ക്കുന്നു.

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

ഇഷ്‌ടാനുസൃത വോയ്‌സ് പ്രോസസ്സിംഗ് സ്ഥിരമായ പരാജയത്തിലെത്തുമ്പോൾ അയയ്ക്കുന്നു.

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

ഗുണനിലവാര ഇവന്റുകൾ

call.graded

ഒരു കോളിനായുള്ള AI ഗ്രേഡിംഗ് റൺ പൂർത്തിയാകുമ്പോഴെല്ലാം അയയ്ക്കുന്നു. ബ്ലോക്ക് ചെയ്യാത്തത്.

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

ഒരു പ്രശ്ന റിപ്പോർട്ട് സൃഷ്ടിക്കുമ്പോൾ അയയ്ക്കുന്നു — ഡാഷ്ബോർഡിൽ നിന്ന് ഉപയോക്താവ് ഫയൽ ചെയ്തതോ (source: "user"), അല്ലെങ്കിൽ കോൾ ഗ്രേഡിംഗ് സ്വയമേവ സൃഷ്ടിച്ചതോ (source: "system"). ബ്ലോക്ക് ചെയ്യാത്തത്.

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

ടെസ്റ്റ് കോൾ ഇവന്റുകൾ

test-call.completed

ഒരു ടെസ്റ്റ്-കോൾ റൺ അന്തിമ സ്റ്റാറ്റസായ completed അല്ലെങ്കിൽ failed-ൽ എത്തുമ്പോൾ അയയ്ക്കുന്നു; ലോഞ്ചിൽ പരാജയപ്പെട്ട് ഒരിക്കലും കോൾ സൃഷ്ടിക്കാത്ത റണ്ണുകളും ഉൾപ്പെടുന്നു. ബ്ലോക്ക് ചെയ്യാത്തത്. ബാച്ച് CI റണ്ണുകൾ നിങ്ങളുടെ ചാറ്റ്/അറിയിപ്പ് സിസ്റ്റങ്ങളുമായി ബന്ധിപ്പിക്കാൻ ഉപയോഗപ്രദം.

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

അലേർട്ട് ഇവന്റുകൾ

alert.triggered

ഡെവലപ്പർ വെബ്‌ഹുക്കുകളിലേക്ക് എത്തിക്കുക ചാനൽ പ്രവർത്തനക്ഷമമാക്കിയിട്ടുള്ള ഒരു അലേർട്ട് നിയമം അതിന്റെ പരിധി കടക്കുമ്പോൾ അയയ്ക്കുന്നു. തടസ്സപ്പെടുത്താത്തത്. ഒരു നിയമം ഒരിക്കൽ പ്രവർത്തിക്കുകയും പിന്നീട് അതിന്റെ കൂൾഡൗൺ മാനിക്കുകയും ചെയ്യുന്നു, അതിനാൽ തുടർച്ചയായ ലംഘനം ഓരോ കൂൾഡൗൺ വിൻഡോയിലും ഒരു ഇവന്റ് സൃഷ്ടിക്കും.

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

നിയമങ്ങൾ, മെട്രിക്കുകൾ, കൂൾഡൗണുകൾ, ഇമെയിൽ / Slack ചാനലുകൾ എന്നിവ സൃഷ്ടിക്കുന്നതിന് അലേർട്ടുകൾ ഗൈഡ് കാണുക.

ബന്ധപ്പെട്ടവ