ThunderPhone v3 ഇപ്പോൾ ലൈവാണ്.സ്വയം തുടങ്ങാം — 2¢/മിനിറ്റ് മുതൽ.പ്രഖ്യാപനം വായിക്കുക

Webhooks

ഇവന്റുകളുടെ കാറ്റലോഗ്

ThunderPhone അയയ്ക്കുന്ന എല്ലാ webhook ഇവന്റ് തരങ്ങളും.

ഓരോ webhook ബോഡിയിലും type ഫീൽഡ് ഉണ്ടായിരിക്കും; അതിന്റെ മൂല്യം ഈ പേജിലെ ഇവന്റ് തരങ്ങളിൽ ഒന്നായിരിക്കും. നിങ്ങൾ ഒരു എൻഡ്‌പോയിന്റിലേക്ക് സബ്‌സ്‌ക്രൈബ് ചെയ്യുമ്പോൾ, events അറേയിൽ നിങ്ങൾക്ക് ആവശ്യമുള്ള ഇവന്റ് തരങ്ങൾ ഉണ്ടായിരിക്കണം (അല്ലെങ്കിൽ എല്ലാത്തിലേക്കും സബ്‌സ്‌ക്രൈബ് ചെയ്യാൻ അത് ശൂന്യമായിരിക്കാം — ഓരോ ടേണിലെയും ഇവന്റുകളായ telephony.turn / web.turn, തത്സമയ പുരോഗതി ഇവന്റായ call.status_changed എന്നിവ ഒഴികെ; ഇവയെ വ്യക്തമായി പേരുചേർക്കുന്ന എൻഡ്‌പോയിന്റുകളിലേക്ക് മാത്രമാണ് ഇവ ഡെലിവർ ചെയ്യുന്നത്).

ഈ ഇവന്റുകൾ രണ്ട് ഡെലിവറി ശൈലികളിലൂടെയാണ് ലഭിക്കുന്നത്:

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

താഴെയുള്ള ഉദാഹരണ payload-ുകൾ endpoint എൻവലപ്പ് അതിന്റെ വയർ ക്രമത്തിൽ കാണിക്കുന്നു (കീകൾ അക്ഷരമാലാക്രമത്തിൽ ക്രമീകരിച്ചിരിക്കുന്നു: 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"
}
ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
returning_callഒബ്ജക്റ്റ്കഴിഞ്ഞ 30 ദിവസത്തിനുള്ളിൽ നമ്പർ ഈ വിളിക്കുന്നയാളെ വിളിച്ചിട്ടുണ്ടെങ്കിൽ മാത്രം ലഭ്യമാകും: മുമ്പത്തെ കോളിന്റെ call_id, agent_id, started_at, outcome. കോൾബാക്കുകൾ കാണുക
sip_headersഒബ്ജക്റ്റ്X-* അല്ലെങ്കിൽ User-to-User SIP ഹെഡറുകളോടെയാണ് കോൾ എത്തിയതെങ്കിൽ മാത്രം ലഭ്യമാകും (SIP വിലാസങ്ങളും മാനുവൽ SIP കണക്ഷനുകളും): ചെറിയക്ഷരത്തിലുള്ള ഹെഡർ പേര് → മൂല്യം. SIP ഹെഡറുകൾ കാണുക

telephony.complete

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

ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്

telephony.tool

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

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

ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്

telephony.turn

ഒരു ടെലിഫോണി കോൾ പുരോഗതിയിലായിരിക്കുമ്പോൾ, സംഭാഷണമുള്ള ഓരോ ടേണിനും സംഭവിക്കുന്ന മുറയ്ക്ക് അയയ്ക്കുന്നു — ഏജന്റിന്റെ സംസാരിച്ച പൂർത്തീകരണങ്ങളും കോളറുടെ ട്രാൻസ്ക്രൈബ് ചെയ്ത ടേണുകളും. GET /v1/calls/{call_id}/transcript പോൾ ചെയ്യുന്നതിനുപകരം സാധാരണ വെബ്‌ഹുക്കുകളിലൂടെ തത്സമയ സംഭാഷണം പിന്തുടരാൻ ഇത് നിങ്ങളെ അനുവദിക്കുന്നു. ബ്ലോക്ക് ചെയ്യാത്തത്.

{
  "data": {
    "call_id": 987654321,
    "entry_type": "completion",
    "from_number": "+14155550199",
    "position": 7,
    "role": "assistant",
    "start_ms": 15200,
    "text": "How many employees does your company have?",
    "to_number": "+15551234567"
  },
  "event_id": "8d3f5a2c-7b1e-4c9a-b6d0-2e4f6a8c0d1e",
  "type": "telephony.turn"
}
ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
positionപൂർണസംഖ്യകോൾ ചരിത്രത്തിലെ ടേണിന്റെ ഇൻഡക്സ് — ക്രമപ്പെടുത്തലിനുള്ള സ്ഥിരമായ ഐഡന്റിറ്റി
roleസ്ട്രിംഗ്assistant (ഏജന്റിന്റെ സംസാരം) അല്ലെങ്കിൽ user (കോളറുടെ സംസാരം)
textസ്ട്രിംഗ്അയയ്ക്കുന്ന സമയത്ത് അറിയാവുന്ന ടേണിന്റെ ട്രാൻസ്ക്രിപ്റ്റ് ടെക്സ്റ്റ്
entry_typeസ്ട്രിംഗ്അടിസ്ഥാന ചരിത്ര എൻട്രി തരം: completion (ഏജന്റ്), അല്ലെങ്കിൽ user_turn / span (കോളർ)
start_ms, end_msപൂർണസംഖ്യകോൾ ആരംഭിച്ചതിനുശേഷമുള്ള ms-ലെ ഓഡിയോ ഓഫ്സെറ്റുകൾ; അയയ്ക്കുന്ന സമയത്ത് പ്ലേഔട്ട് ടൈമിംഗ് ഇതിനകം അറിയാമായിരുന്നാൽ മാത്രം ലഭ്യമാകും

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 എന്നിവ ശൂന്യമായിരിക്കും.

ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്

web.complete

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

ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്

web.tool

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

ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്

web.turn

വെബ് വിജറ്റ് കോളുകളും ബിൽഡർ മൈക്ക് ടെസ്റ്റ് കോളുകളും ഉൾക്കൊള്ളുന്ന telephony.turn-ന്റെ വെബ്-ചാനൽ തുല്യരൂപം. from_number / to_number-നുപകരം origin_domain ഉള്ള അതേ പേലോഡ് രൂപമാണിത്. telephony.turn പോലെ, ഇതിന് വ്യക്തമായ സബ്സ്ക്രിപ്ഷൻ ആവശ്യമാണ് — ശൂന്യമായ events അറേയിലൂടെ ഇത് ഒരിക്കലും ഡെലിവർ ചെയ്യപ്പെടില്ല.

ഫീൽഡ്തരംവിവരണം
agent_idപൂർണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്

call.transfer_completed

ഒരു കോൾ ട്രാൻസ്ഫറിന്റെ അന്തിമ ഫലത്തോടെ ഓരോ കോളിലും ഒരിക്കൽ അയയ്ക്കുന്നു: ഒരു കോൾഡ് ട്രാൻസ്ഫർ, അല്ലെങ്കിൽ ഏജന്റ് പിന്മാറിയ ശേഷം വാം ട്രാൻസ്ഫർ അവശേഷിപ്പിക്കുന്ന ആളുകൾ തമ്മിലുള്ള ബ്രിഡ്ജ്. ബ്ലോക്ക് ചെയ്യാത്തതും എൻഡ്പോയിന്റുകളിലേക്ക് മാത്രം അയയ്ക്കുന്നതുമാണ് (ലെഗസി സിംഗിൾ-URL വെബ്ഹുക്കിലേക്ക് ഒരിക്കലും അയയ്ക്കില്ല). കോളിന്റെ telephony.complete-ന് ശേഷം ഇത് എത്തുന്നു: കാരിയർ കോൾ ഏറ്റെടുത്താലോ ട്രാൻസ്ഫർ പരാജയപ്പെട്ടാലോ, അല്ലെങ്കിൽ ThunderPhone കോൾ ബ്രിഡ്ജ് ചെയ്തതാണെങ്കിൽ ബ്രിഡ്ജ് അവസാനിച്ചാലോ.

{
  "data": {
    "agent_id": 12,
    "agent_name": "Front desk",
    "bridge_kind": "cold_fallback",
    "bridge_seconds": 255,
    "bridge_total_cents": 5,
    "call_id": 987654321,
    "destination": "+15555550102",
    "sip_status": 403,
    "transfer_outcome": "bridged"
  },
  "event_id": "5b0f6c1e-9d2a-5e7b-8c4d-1a2b3c4d5e6f",
  "type": "call.transfer_completed"
}
ഫീൽഡ്തരംവിവരണം
call_idintegerട്രാൻസ്ഫർ ചെയ്ത കോൾ
agent_idinteger | nullഏൽപ്പിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_namestring | nullഏൽപ്പിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
transfer_outcomestringrefer_accepted: കാരിയർ കോൾ ഏറ്റെടുത്തു. bridged: കാരിയർ കോൾഡ് ട്രാൻസ്ഫർ നിരസിച്ചതിനാലോ വാം ട്രാൻസ്ഫറിലെ ഏജന്റ് പിന്മാറിയതിനാലോ, ThunderPhone തന്നെ കോളറെയും ലക്ഷ്യസ്ഥാനത്തെയും ബന്ധിപ്പിച്ചുനിർത്തി. bridge_unanswered: കാരിയർ കോൾഡ് ട്രാൻസ്ഫർ നിരസിച്ചു, ലക്ഷ്യസ്ഥാനം ThunderPhone-ന്റെ സ്വന്തം കോളിന് മറുപടി നൽകിയില്ല. failed: ട്രാൻസ്ഫർ നടന്നില്ല, കോൾ അവസാനിച്ചു
destinationstring | nullകോൾ ട്രാൻസ്ഫർ ചെയ്ത നമ്പർ
sip_statusinteger | nullകാരിയർ കോൾഡ് ട്രാൻസ്ഫർ നിരസിച്ചപ്പോഴുള്ള SIP സ്റ്റാറ്റസ്: 403 (ഉദാഹരണത്തിന്, കോൾ ട്രാൻസ്ഫറില്ലാത്ത Twilio ട്രങ്ക്), 405 അല്ലെങ്കിൽ 501. കാരിയർ നിരസിച്ചില്ലെങ്കിൽ null
bridge_kindstring | nullbridged-ന് മാത്രം: cold_fallback (ThunderPhone ബന്ധിപ്പിച്ച നിരസിക്കപ്പെട്ട കോൾഡ് ട്രാൻസ്ഫർ) അല്ലെങ്കിൽ warm (ഏജന്റ് പിന്മാറിയ ശേഷമുള്ള വാം ട്രാൻസ്ഫറിലെ രണ്ട് ആളുകൾ)
bridge_secondsinteger | nullbridged-ന് മാത്രം: ThunderPhone ബിൽ ചെയ്ത ബ്രിഡ്ജ് സമയം, സെക്കൻഡുകളിൽ
bridge_total_centsinteger | nullbridged-ന് മാത്രം: സൗജന്യ കോൾ ക്രെഡിറ്റ് കിഴിച്ചശേഷം ബ്രിഡ്ജിന് വന്ന USD സെന്റ് ചെലവ്, കോളിന്റെ billing_total_cents-ൽ നിന്ന് വേർതിരിച്ച് ബിൽ ചെയ്യുന്നത്

ഇതേ മൂല്യങ്ങൾ കോൾ ഒബ്ജക്റ്റിൽ transfer_outcome, transfer_destination, transfer_sip_status, transfer_bridge_kind, transfer_bridge_seconds, കൂടാതെ transfer_bridge_total_cents എന്നിങ്ങനെയും ലഭ്യമാണ്. event_id ഓരോ ഡെലിവറിയിലും ഒരേപോലെയാണ് ഒരു കോളിന്, അതിനാൽ ആവർത്തിച്ചുള്ള റിപ്പോർട്ട് രണ്ടാമത്തെ ഇവന്റ് സൃഷ്ടിക്കില്ല.

call.billed

മീറ്റർ ചെയ്ത ഉപയോഗത്തിന്റെ അടിസ്ഥാനത്തിൽ ബിൽ ചെയ്ത കോളിനായി അയയ്ക്കുന്നു: അതിന്റെ ചാർജ് സെറ്റിൽ ആകുമ്പോൾ, കോളിന് ശേഷം ഉപയോഗ വിവരം ലഭിച്ച് ഏതാനും മിനിറ്റുകൾ കഴിഞ്ഞ്, കൂടാതെ പിന്നീട് ലഭിച്ച ഉപയോഗം ചാർജ് വർധിപ്പിക്കുമ്പോഴെല്ലാം വീണ്ടും. കോളിന്റെ telephony.complete / web.complete ഇവന്റിൽ billing_pending: true, കൂടാതെ null ബില്ലിംഗ് ഫീൽഡുകളും ഉണ്ടായിരിക്കും. ഇത് തടസ്സമുണ്ടാക്കാത്തതാണ്, എൻഡ്‌പോയിന്റുകളിലേക്ക് മാത്രമാണ് ഡെലിവർ ചെയ്യുന്നത് (ലെഗസി ഒറ്റ-URL വെബ്‌ഹുക്കിലേക്ക് ഒരിക്കലും അല്ല). അവസാനിക്കുമ്പോൾ ബിൽ ചെയ്യുന്ന കോളുകളുടെ ബില്ലിംഗ് പൂർത്തീകരണ ഇവന്റിലുണ്ടാകും; അവയ്ക്ക് call.billed ലഭിക്കില്ല.

ക്രമം ഉറപ്പില്ല: സാധാരണയായി ചാർജ് പൂർത്തീകരണ ഇവന്റിനായി കാത്തിരിക്കും, എന്നാൽ അതിന് മുമ്പ് call.billed എത്താം (ഒരു പൂർത്തീകരണ ഇവന്റ് ഒരു മണിക്കൂർ വൈകിയാലോ, ഡെലിവറികൾ വ്യത്യസ്ത സമയങ്ങളിൽ വീണ്ടും ശ്രമിച്ചാലോ). രണ്ട് call.billed ഇവന്റുകളും ക്രമം തെറ്റി എത്താം. ഓരോ call_id-നും ഏറ്റവും ഉയർന്ന billing_seq ഉള്ള ഇവന്റ് സൂക്ഷിക്കുക.

{
  "data": {
    "adjustment_cents": null,
    "agent_id": 12,
    "agent_name": "Front desk",
    "billable_minutes": 3.0,
    "billing_seq": 1,
    "billing_total_cents": 10,
    "call_id": 987654321,
    "reason": "settled"
  },
  "event_id": "7c1d2e3f-4a5b-5c6d-8e7f-9a0b1c2d3e4f",
  "type": "call.billed"
}
ഫീൽഡ്തരംവിവരണം
call_idഇന്റിജർബിൽ ചെയ്ത കോൾ
agent_idഇന്റിജർ | nullഒരു ഏജന്റിനെ നിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullഒരു ഏജന്റിനെ നിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
reasonസ്ട്രിംഗ്settled: കോളിന്റെ ചാർജ്. adjusted: ചാർജിന് ശേഷം ലഭിക്കുകയും അത് വർധിപ്പിക്കുകയും ചെയ്ത ഉപയോഗം (ചാർജ് ഒരിക്കലും കുറയില്ല)
billing_seqഇന്റിജർചാർജിന് 1, തുടർന്ന് ഓരോ വർധനയ്ക്കും 2, 3, ... ലഭിച്ചതിൽ ഏറ്റവും ഉയർന്നത് കോളിന്റെ നിലവിലെ ബില്ലിംഗാണ്
billable_minutesനമ്പർബിൽ ചെയ്ത മിനിറ്റുകൾ, ഏറ്റവും അടുത്ത കാൽ മിനിറ്റിലേക്ക് റൗണ്ട് ചെയ്തത്
billing_total_centsഇന്റിജർഏതെങ്കിലും സൗജന്യ കോൾ ക്രെഡിറ്റിന് ശേഷം, adjusted വർധനകൾ ഉൾപ്പെടെ, ഇതുവരെ കോളിന് ഈടാക്കിയ ആകെ USD സെന്റുകൾ
adjustment_centsഇന്റിജർ | nulladjusted-ന് മാത്രം: ഏതെങ്കിലും സൗജന്യ കോൾ ക്രെഡിറ്റിന് ശേഷം, ഈ വർധനയുടെ USD സെന്റുകൾ

അതേ ആകെ തുകകൾ കോൾ ഒബ്ജക്റ്റിൽ billable_minutes, billing_total_cents എന്നിങ്ങനെയും ലഭ്യമാണ്. ഒരു billing_seq-ന്റെ ഓരോ ഡെലിവറിയിലും event_id ഒന്നുതന്നെയാണ്, അതിനാൽ ആവർത്തിച്ച റിപ്പോർട്ട് രണ്ടാമത്തെ ഇവന്റ് സൃഷ്ടിക്കില്ല.

call.status_changed

ഒരു കോൾ പുരോഗതിയിലായിരിക്കുമ്പോൾ, അത് ഓരോ പുതിയ ഘട്ടത്തിലെത്തുമ്പോഴും അയയ്ക്കുന്നു: ThunderPhone ഡയൽ ചെയ്യാൻ തുടങ്ങുമ്പോൾ, വ്യക്തിയോ അവരുടെ ഫോണോ മറുപടി നൽകുമ്പോൾ, ഏജന്റ് വോയ്‌സ്‌മെയിലിലെത്തുമ്പോൾ, അല്ലെങ്കിൽ ഏജന്റിനെ ഹോൾഡിൽ ഇടുകയും അതിൽനിന്ന് മാറ്റുകയും ചെയ്യുമ്പോൾ. കോൾ പിന്തുടരുന്ന ചാറ്റ് ത്രെഡിൽ, ഉദാഹരണത്തിന് "ഡയൽ ചെയ്യുന്നു…", "മറുപടി ലഭിച്ചു", "ഹോൾഡിൽ" എന്നിവയും "4 മിനിറ്റിന് ശേഷം ഹോൾഡിൽനിന്ന് മാറ്റി" എന്നതും ഉപയോഗിച്ച് തത്സമയ കോളിന്റെ പുരോഗതി കാണിക്കാൻ ഇത് ഉപയോഗിക്കുക. തടസ്സമില്ലാത്തതും എൻഡ്‌പോയിന്റുകളിലേക്ക് മാത്രം ഡെലിവർ ചെയ്യപ്പെടുന്നതുമാണ് (ലെഗസി ഒറ്റ-URL വെബ്‌ഹുക്കിലേക്ക് ഒരിക്കലും അല്ല).

{
  "data": {
    "agent_id": 12,
    "agent_name": "Front desk",
    "call_id": 987654321,
    "direction": "outbound",
    "hold_seconds": 240,
    "occurred_at": "2026-11-07T17:04:12.418Z",
    "status": "off_hold"
  },
  "event_id": "2f6a1c9e-3b7d-5e8f-9a0b-4c5d6e7f8a9b",
  "type": "call.status_changed"
}
ഫീൽഡ്തരംവിവരണം
call_idപൂർണസംഖ്യകോൾ
agent_idപൂർണസംഖ്യ | nullഒരു ഏജന്റിനെ നിയോഗിച്ചിരുന്നെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullഒരു ഏജന്റിനെ നിയോഗിച്ചിരുന്നെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
directionസ്ട്രിംഗ്കോൾ ഒബ്‌ജക്റ്റിൽ ഉള്ളതുപോലെ കോളിന്റെ ദിശ
statusസ്ട്രിംഗ്കോൾ എത്തിയ ഘട്ടം; താഴെയുള്ള പട്ടിക കാണുക
occurred_atടൈംസ്റ്റാമ്പ്അത് സംഭവിച്ച സമയം
hold_secondsപൂർണസംഖ്യ | nulloff_hold-ന് മാത്രം: ഹോൾഡ് നീണ്ടുനിന്ന സമയം, സെക്കൻഡിൽ. മറ്റെല്ലാ സ്റ്റാറ്റസുകൾക്കും null
statusഅയയ്ക്കുന്ന സമയം
dialingഔട്ട്‌ബൗണ്ട് കോളുകൾ: ThunderPhone കോൾ സ്ഥാപിക്കുകയാണ്. കോൾ നിരസിക്കാൻ കഴിയുന്ന എല്ലാ പരിശോധനകളും വിജയിച്ചതിന് ശേഷം, ഡയൽ കാരിയറിലേക്ക് പോകുന്നതിന് തൊട്ടുമുമ്പ് അയയ്ക്കുന്നു. ഡാഷ്ബോർഡിൽനിന്ന് ആരംഭിക്കുന്ന ടെസ്റ്റ് കോളുകൾ ഇത് അയയ്ക്കില്ല
answeredഔട്ട്‌ബൗണ്ട് കോളുകൾ: കോളിന് മറുപടി ലഭിച്ചതായി കാരിയർ റിപ്പോർട്ട് ചെയ്തു. വോയ്‌സ്‌മെയിൽ ബോക്സോ കോൾ സ്ക്രീനറോ മറുപടി നൽകുന്നതും ഇതിൽ ഉൾപ്പെടും, അതിനാൽ തുടർന്ന് voicemail വരാം. കോൾ അവസാനിച്ചതിന് ശേഷമുള്ള റിപ്പോർട്ടിൽനിന്ന് മാത്രമാണ് ThunderPhone മറുപടിയെക്കുറിച്ച് അറിയുന്നതെങ്കിൽ, കോൾ അവസാനിക്കുമ്പോൾ answered അയയ്ക്കുന്നു
voicemailഔട്ട്‌ബൗണ്ട് കോളുകൾ: ഏജന്റ് ഒരു വോയ്‌സ്‌മെയിൽ ബോക്സിലെത്തി, ഏജന്റിന്റെ voicemail_action സൂചിപ്പിക്കുന്നതനുസരിച്ച് സന്ദേശം നൽകുകയോ കോൾ വിച്ഛേദിക്കുകയോ ചെയ്യുന്നു. മെയിൽബോക്സ് സ്ഥിരീകരിക്കുമ്പോൾ (അതിന്റെ ബീപ്പിലൂടെയോ മറുപടി ഇല്ലാത്തതിലൂടെയോ) അയയ്ക്കുന്നു; ആദ്യ അനുമാനത്തിൽ അല്ല
on_holdഏജന്റിനെ ഹോൾഡിൽ ഇടുകയും നിശ്ശബ്ദമായി കാത്തിരിക്കുകയും ചെയ്യുന്നു (wait_on_hold ടൂൾ)
off_holdഒരു വ്യക്തി ലൈനിലേക്ക് തിരിച്ചെത്തി, ഏജന്റ് വീണ്ടും സംസാരിക്കുകയാണ്. ഹോൾഡ് എത്രനേരം നീണ്ടുനിന്നെന്ന് hold_seconds വ്യക്തമാക്കുന്നു

ഓരോ കോളും ഓരോ സ്റ്റാറ്റസും പരമാവധി ഒരിക്കൽ മാത്രമേ അയയ്ക്കൂ; on_hold, off_hold എന്നിവ ഒഴികെ, അവ ഓരോ ഹോൾഡിനും ഒരിക്കൽ അയയ്ക്കും. ഹോൾഡിൽ കാത്തിരിക്കുന്ന ഒരു സാധാരണ ഔട്ട്‌ബൗണ്ട് കോൾ dialing, answered, on_hold, off_hold എന്നിവയും തുടർന്ന് അവസാനിക്കുമ്പോൾ telephony.complete-ഉം അയയ്ക്കും.

റിംഗിംഗ് റിപ്പോർട്ട് ചെയ്യില്ല: ഒരു കാരിയർ റിംഗിംഗ് സിഗ്നൽ ചെയ്യുമോ എന്നത് വിശ്വസിക്കാൻ കഴിയാത്തത്ര വ്യത്യാസപ്പെടുന്നു. ഏജന്റിന്റെ prompt ആണ്, ThunderPhone അല്ലാതെ, ഒരു മെയിൽബോക്സിൽ എന്ത് ചെയ്യണമെന്ന് തീരുമാനിക്കുന്ന അപൂർവമായ voicemail_action: "prompt" കോളുകളിൽ, voicemail സ്റ്റാറ്റസ് അയയ്ക്കില്ല; telephony.complete-ലെ answered_by ഇപ്പോഴും voicemail എന്നാണ് കാണിക്കുന്നത്. പേലോഡുകളിൽ ട്രാൻസ്ക്രിപ്റ്റോ ഫോൺ നമ്പറുകളോ വേരിയബിളുകളോ ഉൾപ്പെടില്ല, അതിനാൽ റെക്കോർഡിംഗ് ഓഫായിരിക്കുന്ന കോളുകൾക്കുപോലും call.status_changed അയയ്ക്കപ്പെടുന്നു.


SMS ഇവന്റുകൾ

സ്ഥാപനത്തിന്റെ കണക്റ്റ് ചെയ്ത Twilio അല്ലെങ്കിൽ Telnyx അക്കൗണ്ട് വഴി അയക്കുന്ന സന്ദേശങ്ങളെയാണ് SMS ഇവന്റുകൾ വിവരിക്കുന്നത്. സന്ദേശത്തിന്റെ ഉള്ളടക്കം ഒഴിവാക്കിയിരിക്കുന്നു, കൂടാതെ to മറച്ചിരിക്കുന്നു. ഉള്ളടക്കമോ സ്വീകർത്താവോ ആവശ്യമുള്ളപ്പോൾ സ്ഥാപന-സ്കോപ്പിലുള്ള സന്ദേശം GET /v1/sms/{message_id} വഴി നേടുക. സന്ദേശ ഒബ്ജക്റ്റിൽ ഉള്ളതുപോലെ source എന്നത് api, agent_tool, followup അല്ലെങ്കിൽ pre_call (വിളിക്കുന്നതിന് മുമ്പുള്ള ഒരു ക്യാമ്പെയ്‌നിന്റെ ടെക്സ്റ്റ്) ആയിരിക്കും.

ഓരോ SMS ഇവന്റിലും scheduled_send_id ഉണ്ടായിരിക്കും: ടെക്സ്റ്റ് അയച്ച ഷെഡ്യൂൾ ചെയ്ത അയക്കലിന്റെ id, അല്ലെങ്കിൽ ഷെഡ്യൂൾ ചെയ്യാത്ത ടെക്സ്റ്റിനായി null। ഷെഡ്യൂൾ ചെയ്ത ടെക്സ്റ്റുകൾക്ക് source ആയി "scheduled" ഉണ്ടായിരിക്കും.

sms.sent

ഉപഭോക്താവിന്റെ കാരിയർ ഔട്ട്‌ബൗണ്ട് SMS അഭ്യർത്ഥന സ്വീകരിക്കുമ്പോൾ അയയ്ക്കുന്നു. ഇത് ഹാൻഡ്‌സെറ്റ് ഡെലിവറി രസീതല്ല.

{
  "data": {
    "accepted_at": "2026-09-19T15:42:10.113Z",
    "agent_id": 12,
    "call_id": 987654321,
    "created_at": "2026-09-19T15:42:09.901Z",
    "direction": "outbound",
    "error_code": null,
    "error_message": null,
    "from_number": "+15551234567",
    "id": "313a3117-827b-46e9-a01a-ac1493838724",
    "provider": "twilio",
    "provider_id": "SM0123456789abcdef0123456789abcdef",
    "scheduled_send_id": null,
    "segment_count": 1,
    "source": "agent_tool",
    "status": "accepted",
    "to": "[REDACTED]"
  },
  "event_id": "0ae347b4-1716-45bb-9a0e-b52373586e37",
  "type": "sms.sent"
}

sms.failed

സ്ഥിരമായ കാരിയർ നിരസിക്കലിന് ശേഷം, താൽക്കാലിക പുനർശ്രമങ്ങൾ തീർന്നതിന് ശേഷം, ഫലം അന്തിമമായി അജ്ഞാതമായിരിക്കുമ്പോൾ, അല്ലെങ്കിൽ Twilio സ്വീകരിച്ച സന്ദേശം കൈമാറപ്പെട്ടില്ലെന്നോ പരാജയപ്പെട്ടെന്നോ റിപ്പോർട്ട് ചെയ്യുമ്പോൾ അയയ്ക്കുന്നു. അവസാന സാഹചര്യത്തിൽ സന്ദേശത്തിന്റെ sms.sent ഇതിനകം അയച്ചിട്ടുണ്ടാകും, കൂടാതെ status "accepted" ആയി തുടരും. error_code സ്ഥിരതയുള്ള ThunderPhone കോഡാണ്, ലഭ്യമാകുമ്പോൾ error_message ഉപഭോക്താവ് ചെയ്യേണ്ട നടപടിയെ വ്യക്തമാക്കുന്നു. status: "unknown" എന്നത് കാരിയർ SMS സ്വീകരിച്ചിരിക്കാമെന്നാണ് അർത്ഥം; ThunderPhone അത് സ്വയമേവ വീണ്ടും അയയ്ക്കില്ലാത്തതിനാൽ, കാരിയർ ലോഗിൽ അത് പൊരുത്തപ്പെടുത്തുക.

sms.received

ഇൻബൗണ്ട് SMS പിന്തുണയ്ക്കായി സംവരണം ചെയ്തിരിക്കുന്നു. നിലവിലെ റിലീസിൽ sms.received ഇവന്റുകളൊന്നും പുറപ്പെടുവിക്കുന്നില്ല. ഇൻബൗണ്ട് കാരിയർ വെബ്‌ഹുക്ക് കോൺഫിഗറേഷനും സിഗ്നേച്ചർ പരിശോധനയും പ്രത്യേകം ലഭ്യമാക്കും.


ഷെഡ്യൂൾ ചെയ്ത ഇവന്റുകൾ

അയക്കപ്പെടാത്ത ഷെഡ്യൂൾ ചെയ്ത അയയ്ക്കലുകൾ ഈ ഇവന്റുകളിൽ ഒന്ന് ട്രിഗർ ചെയ്യും. അയക്കപ്പെടുന്ന ഒരു അയയ്ക്കൽ സാധാരണ ഇവന്റുകളാണ് ട്രിഗർ ചെയ്യുന്നത്: ടെക്സ്റ്റിനായി scheduled_send_id സജ്ജമാക്കിയ sms.* ഇവന്റുകൾ, കോളിനായി കോൾ ഇവന്റുകൾ, അതിന്റെ telephony.complete-ൽ scheduled_send_id സഹിതം. രണ്ടും തടസ്സമില്ലാത്തവയാണ്. അയയ്ക്കലിന് ഒരു ഏജന്റ് ഉണ്ടെങ്കിൽ, ആ ഏജന്റിനായുള്ള ഏജന്റ്-സ്കോപ്പ് ചെയ്ത എൻഡ്‌പോയിന്റുകൾക്കും അവ ലഭിക്കും.

പേലോഡിൽ ഐഡികൾ, സ്റ്റാറ്റസ്, സമയങ്ങൾ എന്നിവ മാത്രം ഉൾപ്പെടും: ടെക്സ്റ്റിന്റെ ബോഡിയോ കോളിന്റെ വേരിയബിളുകളോ കോൺടെക്സ്റ്റോ ഒരിക്കലും ഉൾപ്പെടില്ല, കൂടാതെ to റെഡാക്റ്റ് ചെയ്തിരിക്കും. ശേഷിക്കുന്നതിനായി GET /v1/scheduled/{id} ഫെച്ച് ചെയ്യുക.

scheduled.skipped

ഒരു അയയ്ക്കൽ മനഃപൂർവം അയക്കാത്തപ്പോൾ അയയ്ക്കുന്നു. reason എന്നത് expired (expires_at-ന് മുമ്പ് അയയ്ക്കാനായില്ല), opted_out (അയയ്ക്കൽ സൃഷ്ടിച്ചതിന് ശേഷം ചേർത്തതും ഉൾപ്പെടെ, നമ്പർ ഒഴിവാക്കൽ പട്ടികയിൽ ഉണ്ട്), quiet_hours (സ്വീകർത്താവിന്റെ സമയ മേഖലയിൽ രാവിലെ 8 മുതൽ രാത്രി 9 വരെയുള്ള സമയത്തിന് പുറത്താണ് അത് നിശ്ചിതസമയമായത്), sender_not_ready (ടെക്സ്റ്റിന്റെ നമ്പറിന് ഇനി അയയ്ക്കാൻ കഴിയില്ല) അല്ലെങ്കിൽ outbound_tcpa_unconfirmed (ഓർഗനൈസേഷന്റെ TCPA സ്ഥിരീകരണം രേഖപ്പെടുത്തുന്നതിന് മുമ്പ് ഒരു കോൾ നിശ്ചിതസമയമായി) ആയിരിക്കും.

{
  "data": {
    "agent_id": null,
    "created_at": "2026-11-01T18:02:11.204Z",
    "detail": "The send could not go out before its expires_at, so it was not sent late.",
    "expires_at": "2026-11-03T17:30:00Z",
    "external_id": "appointment-4815",
    "from_number": "+15551234567",
    "id": "6f1c0b8e-3a52-4c1f-9a0b-2f4f7d8a91c3",
    "reason": "expired",
    "send_at": "2026-11-03T17:00:00Z",
    "source": "api",
    "status": "skipped",
    "to": "[REDACTED]",
    "type": "sms"
  },
  "event_id": "2b0f6c43-74c9-4d43-a1f4-0d6a2f8e51a7",
  "type": "scheduled.skipped"
}

scheduled.failed

ThunderPhone അയയ്ക്കാൻ ശ്രമിച്ചെങ്കിലും അത് പുറത്തുപോയില്ലെങ്കിൽ അയയ്ക്കുന്നു. reason എന്നത് അയയ്ക്കലിന്റെ സ്വന്തം പിശകാണ്: ഒരു ടെക്സ്റ്റിനുള്ള carrier_rejected പോലുള്ള ഒരു SMS പിശക് കോഡ്, അല്ലെങ്കിൽ ബ്ലോക്ക് ചെയ്ത ലക്ഷ്യസ്ഥാന നിയമം (premium_rate, ഉദാഹരണത്തിന്) അല്ലെങ്കിൽ agent_deleted പോലുള്ള കോളിന്റെ നിരസിക്കൽ അല്ലെങ്കിൽ പരാജയ കാരണം. പേലോഡിൽ scheduled.skipped-ന്റെ അതേ ഫീൽഡുകളുണ്ട്.

ഫീൽഡ്തരംവിവരണം
idസ്ട്രിംഗ്ഷെഡ്യൂൾ ചെയ്ത അയയ്ക്കലിന്റെ id
typeസ്ട്രിംഗ്sms അല്ലെങ്കിൽ call
statusസ്ട്രിംഗ്skipped അല്ലെങ്കിൽ failed
reasonസ്ട്രിംഗ്മുകളിൽ പറഞ്ഞ കാരണം; അയയ്ക്കലിന്റെ status_reason-ന് തുല്യമായ മൂല്യം
detailസ്ട്രിംഗ്വായിക്കാവുന്ന വിശദീകരണം
sourceസ്ട്രിംഗ്അയയ്ക്കൽ സൃഷ്ടിച്ചത്: api
external_idസ്ട്രിംഗ് | nullഅയയ്ക്കലിനുള്ള നിങ്ങളുടെ കീ, അല്ലെങ്കിൽ null
from_numberസ്ട്രിംഗ്അയയ്ക്കുന്ന നമ്പർ
toസ്ട്രിംഗ്എപ്പോഴും "[REDACTED]"
agent_idഇന്റീജർ | nullകോളുകൾ: ഏജന്റ്; ടെക്സ്റ്റുകൾ: null
send_at, expires_at, created_atടൈംസ്റ്റാമ്പ്ISO 8601

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

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

voice.ready, voice.failed എന്നിവ events: [] ഉള്ള സ്ഥാപനവ്യാപക എൻഡ്‌പോയിന്റിലേക്കു മാത്രം കൈമാറപ്പെടും. അവയെ വ്യക്തമായ ഇവന്റ് ഫിൽട്ടറുകളായി തിരഞ്ഞെടുക്കാനാകില്ല.

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"
}
ഫീൽഡ്തരംവിവരണം
voice.idstringഇഷ്ടാനുസൃത വോയ്‌സിന്റെ പൊതു ഐഡി
voice.namestringcustom:<public_id> രൂപത്തിലുള്ള ഏജന്റ് വോയ്‌സ് മൂല്യം
voice.display_namestringസ്ഥാപനത്തിന് ദൃശ്യമാകുന്ന വോയ്‌സ് പേര്
voice.languagestringക്ലോണിന്റെ ഏക ഭാഷാ കോഡ്
voice.genderstringmale, female, അല്ലെങ്കിൽ ശൂന്യ സ്ട്രിംഗ്
voice.statusstringvoice.ready-ന് ready; voice.failed-ന് failed
voice.failure_reasonstringവിജയത്തിൽ ശൂന്യം; പരാജയത്തിൽ പ്രോസസ്സിംഗ് പരാജയത്തിന്റെ വിശദാംശം
voice.created_at, voice.updated_attimestampISO 8601 ടൈംസ്റ്റാമ്പുകൾ
reasonstringപരാജയ വിശദാംശം; 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…"
    },
    "report": null
  },
  "event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "type": "call.graded"
}
ഫീൽഡ്തരംവിവരണം
agent_idinteger | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_namestring | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
grade.idintegerഗ്രേഡ് ഐഡി
grade.scoreinteger | null0–100
grade.call_outcomestringsuccess, failure, unknown, അല്ലെങ്കിൽ no_conversation
grade.summarystringഒരു ഖണ്ഡികയിലുള്ള സംഗ്രഹം
grade.detected_issuesarrayഗ്രേഡർ കണ്ടെത്തിയ പ്രശ്ന സ്ട്രിംഗുകൾ
grade.statusstringഎപ്പോഴും completed — പൂർത്തിയായ റണ്ണുകൾ മാത്രം ഇവന്റ് പുറപ്പെടുവിക്കുന്നു
grade.grader_modelstringഫലം സൃഷ്ടിച്ച ഗ്രേഡർ: വേഗത്തിലുള്ള താൽക്കാലിക ഗ്രേഡിനായി heuristic-v1 (അല്ലെങ്കിൽ മറ്റൊരു ThunderPhone നിയമാധിഷ്ഠിത ഗ്രേഡർ), പൂർണ്ണ ഗ്രേഡിനായി thunderphone-grader. ഇത് ThunderPhone ലേബലാണ്, AI മോഡലിന്റെ പേരല്ല
grade.graded_at, grade.created_attimestamp
reportobject | nullഉപഭോക്താവിന് കാണിക്കുന്ന കോൾ റിപ്പോർട്ട്: ഫല ലേബൽ, ശ്രദ്ധ ആവശ്യമുള്ള ഫ്ലാഗും കാരണവും, കോളർ, ഒറ്റവരി സംഗ്രഹം, കോളർ അനുഭവം. ആദ്യകാല ഹ്യൂറിസ്റ്റിക് ഗ്രേഡിൽ ഇത് null ആയിരിക്കാം അല്ലെങ്കിൽ ഫീൽഡുകൾ പ്ലേസ്‌ഹോൾഡറുകളായ pending റിപ്പോർട്ടായിരിക്കാം; പൂർണ്ണ ഗ്രേഡിന്റെ ഇവന്റിൽ പൂർത്തിയായത് ഉൾപ്പെടും

call.data_extracted

ഘടനാപരമായ ഡാറ്റ എക്സ്ട്രാക്ഷൻ വിജയകരമായി പൂർത്തിയാകുമ്പോഴെല്ലാം അയയ്ക്കുന്നു, telephony.complete / web.complete-നുശേഷമുള്ള വൈകിയുള്ള റീട്രൈയോ POST /v1/calls/{call_id}/extract വഴിയുള്ള മാനുവൽ റീറണോ ഉൾപ്പെടെ. തടസ്സപ്പെടുത്തുന്നതല്ല.

തടസ്സപ്പെടുത്തുന്ന എക്സ്ട്രാക്ഷൻ മോഡിൽ, പൂർത്തീകരണ ഇവന്റ് സാധാരണയായി 75-സെക്കൻഡ് എക്സ്ട്രാക്ഷൻ ബജറ്റിനേക്കാൾ കൂടുതൽ കാത്തിരിക്കില്ല. എക്സ്ട്രാക്ഷൻ വർക്കർ പ്രോസസ്സ് നഷ്ടപ്പെട്ടാൽ, പ്രൊഡക്ഷൻ ഫൈനലൈസേഷൻ ഡ്രെയിൻ (ഓരോ അഞ്ച് മിനിറ്റിലും) മറ്റൊരു എക്സ്ട്രാക്ഷൻ ശ്രമം ആരംഭിക്കുന്നതിന് മുമ്പ് blocking_deadline_at കഴിഞ്ഞ പൂർത്തീകരണം റിലീസ് ചെയ്യും. പിന്നീടുള്ള വിജയം ഈ ഇവന്റായി പ്രത്യേകം അയയ്ക്കപ്പെടും.

{
  "data": {
    "call_id": 987654321,
    "agent_id": 12,
    "agent_name": "Acme intake",
    "extracted_data": {
      "status": "completed",
      "fields": {
        "customer_name": "Alex Morgan",
        "appointment_date": "2026-04-23"
      },
      "evidence": {
        "customer_name": {
          "quote": "My name is Alex Morgan",
          "speaker_role": "caller",
          "turn_index": 4
        },
        "appointment_date": {
          "quote": "April 23 works for me",
          "speaker_role": "caller",
          "turn_index": 7
        }
      },
      "verification": "verified",
      "field_reasons": {},
      "schema_version": "92850758e231a3c95a..."
    },
    "extracted_at": "2026-04-20T18:25:11.002Z",
    "model": "thunderphone-extractor",
    "summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23."
  },
  "event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
  "type": "call.data_extracted"
}
ഫീൽഡ്തരംവിവരണം
agent_idപൂർണ്ണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
summaryസ്ട്രിംഗ് | nullഏജന്റിൽ കോൾ സംഗ്രഹം സൃഷ്ടിക്കുക ഓണായിരിക്കുമ്പോഴുള്ള പൂർത്തിയായ കോൾ സംഗ്രഹം; അതിനാൽ വൈകിയ എക്സ്ട്രാക്ഷൻ ഇവന്റ് പൂർത്തീകരണ വിൻഡോ നഷ്ടമായ ഒരു സംഗ്രഹവും നൽകുന്നു; അല്ലാത്തപക്ഷം null. സംഗ്രഹമുണ്ടെങ്കിലും എക്സ്ട്രാക്ഷൻ ഫീൽഡുകളില്ലാത്ത ഏജന്റുകൾ ഈ ഇവന്റ് ഒരിക്കലും അയയ്ക്കില്ല: വൈകിയ സംഗ്രഹം GET /v1/calls/{call_id}-ൽ നിന്ന് വായിക്കുക
extracted_data.statusസ്ട്രിംഗ്ഈ ഇവന്റിന് എപ്പോഴും completed
extracted_data.fieldsഒബ്ജക്റ്റ്കോൺഫിഗർ ചെയ്ത എക്സ്ട്രാക്ഷൻ ഫീൽഡ് കീകളാൽ സൂചികപ്പെടുത്തിയ മൂല്യങ്ങൾ; ലഭ്യമല്ലാത്ത മൂല്യങ്ങൾ null ആണ്
extracted_data.evidenceഒബ്ജക്റ്റ്എക്സ്ട്രാക്ഷൻ ഫീൽഡ് അനുസരിച്ച് സൂചികപ്പെടുത്തിയ തെളിവ്. null അല്ലാത്ത മൂല്യത്തിൽ കൃത്യമായ ഘടനാപരമായി പരിശോധിച്ച ഉദ്ധരണി (പരമാവധി 1,000 പ്രതീകങ്ങൾ), speaker_role (caller അല്ലെങ്കിൽ agent), കൂടാതെ turn_index ഉണ്ടായിരിക്കും; മോഡൽ നൽകിയ ദൈർഘ്യമേറിയ ഉദ്ധരണികൾ വെട്ടിച്ചുരുക്കുന്നതിന് പകരം നിരസിക്കും, കൂടാതെ അതിന്റെ ഫീൽഡ് null ആയിരിക്കുമ്പോഴെല്ലാം തെളിവും null ആയിരിക്കും
extracted_data.verificationസ്ട്രിംഗ്ഓരോ കാൻഡിഡേറ്റ് ഫീൽഡിനും സ്വതന്ത്ര തെളിവ് പാസ് കൃത്യമായി ഒരു സാധുവായ വിധി നൽകിയാൽ മാത്രം verified. പാസ് പരാജയപ്പെട്ടതോ, സമയപരിധി കഴിഞ്ഞതോ, മതിയായ ബജറ്റ് ഇല്ലാതിരുന്നതോ, അല്ലെങ്കിൽ വികലമായതോ ഭാഗികമായതോ ആയ ഔട്ട്പുട്ട് നൽകിയതോ ആണെങ്കിൽ unavailable എന്നാണ് അർത്ഥം. പൂർണമായും ലഭ്യമല്ലാത്ത ഒരു പാസ് ഉപഭോക്തൃ അവലോകനത്തിനായി ഘടനാപരമായി അടിസ്ഥാനപ്പെടുത്തിയ മൂല്യങ്ങൾ നിലനിർത്തും. ഭാഗിക ഔട്ട്പുട്ടിന്, സാധുവായ വിധികൾ പ്രയോഗിക്കുകയും കൃത്യമായി ഒരു സാധുവായ വിധിയില്ലാത്ത ഓരോ കാൻഡിഡേറ്റും null ആക്കുകയും ചെയ്യും
extracted_data.field_reasonsഒബ്ജക്റ്റ്ഘടനാപരമായ അടിസ്ഥാനപ്പെടുത്തൽ അല്ലെങ്കിൽ സ്വതന്ത്ര വെരിഫയർ കാരണം null ആക്കപ്പെട്ട ഫീൽഡുകൾ അനുസരിച്ച് സൂചികപ്പെടുത്തിയ കാരണങ്ങൾ
extracted_data.schema_versionസ്ട്രിംഗ്ഈ എക്സ്ട്രാക്ഷനായി ഉപയോഗിച്ച കൃത്യമായ ഫീൽഡ് സ്കീമയുടെ ഹാഷ്
extracted_atടൈംസ്റ്റാമ്പ്ISO 8601 പൂർത്തീകരണ സമയം
modelസ്ട്രിംഗ്എപ്പോഴും thunderphone-extractor: എക്സ്ട്രാക്ഷൻ മോഡലിനുള്ള ThunderPhone ലേബൽ, AI മോഡലിന്റെ പേരല്ല

campaign.completed

ഒരു കാമ്പെയ്ൻ running-ൽ നിന്ന് completed-ലേക്ക് മാറുമ്പോൾ, അതിന്റെ ഷെഡ്യൂൾ അവസാനിച്ചാലും അല്ലെങ്കിൽ എല്ലാ കോൺടാക്ടുകളും ടെർമിനൽ സ്റ്റേറ്റുകളിൽ എത്തിയാലും, ഒരിക്കൽ അയയ്ക്കുന്നു. റണ്ണർ റീട്രൈകൾ മറ്റൊരു ഇവന്റ് അയയ്ക്കില്ല. ഈ ഓർഗനൈസേഷൻ-തല ലൈഫ്‌സൈക്കിൾ ഇവന്റ് ഓർഗനൈസേഷൻ-സ്കോപ്പുള്ള എൻഡ്പോയിന്റുകളിലേക്ക് മാത്രമാണ് അയയ്ക്കുന്നത്, ഏജന്റ്-സ്കോപ്പുള്ള എൻഡ്പോയിന്റുകളിലേക്ക് അല്ല. തടസ്സപ്പെടുത്തുന്നതല്ല.

{
  "data": {
    "campaign_id": "3f6b2c9e-2a0d-4c63-b6d6-a708dc98f403",
    "name": "May win-back",
    "agent_id": 12,
    "status": "completed",
    "started_at": "2026-04-20T17:00:00Z",
    "completed_at": "2026-04-20T18:25:11Z",
    "counts": {
      "contacts_total": 150,
      "completed": 121,
      "failed": 11,
      "no_answer": 18,
      "skipped": 4,
      "remaining": 0
    }
  },
  "event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
  "type": "campaign.completed"
}

നാല് ഫല എണ്ണങ്ങളും പരസ്പരം വേറിട്ടവയാണ്, അവയുടെ ആകെ contacts_total ന് തുല്യമാണ്: completed വിജയകരമായ കോൺടാക്ടുകളെ ഉൾക്കൊള്ളുന്നു; no_answer അന്തിമ ഫലം മറുപടി ലഭിക്കാത്തതായിരുന്ന അവസാനമായി പരാജയപ്പെട്ടതോ ശ്രമങ്ങൾ തീർന്നതോ ആയ കോൺടാക്ടുകളെ ഉൾക്കൊള്ളുന്നു; failed മറ്റെല്ലാ അവസാനമായി പരാജയപ്പെട്ടതോ ശ്രമങ്ങൾ തീർന്നതോ ആയ കോൺടാക്ടുകളെ ഉൾക്കൊള്ളുന്നു; remaining ശേഷിക്കുന്നതോ ഷെഡ്യൂൾ ചെയ്തതോ നിലവിൽ വിളിച്ചുകൊണ്ടിരിക്കുന്നതോ ആയ കോൺടാക്ടുകളെ ഉൾക്കൊള്ളുന്നു. പുനഃശ്രമത്തിനായി കാത്തിരിക്കുന്ന ഒരു കോൺടാക്ട്, അതിന്റെ ഏറ്റവും പുതിയ ശ്രമത്തിൽ മറുപടി ലഭിച്ചില്ലെങ്കിലും, remaining ആണ്. ഒരുതവണ മാത്രമുള്ള പൂർത്തീകരണ സ്‌നാപ്ഷോട്ടിന് മുമ്പ് പുരോഗതിയിലുള്ള കോളുകൾ പൊരുത്തപ്പെടുത്തുന്നു. started_at കോൺഫിഗർ ചെയ്ത ക്യാമ്പെയ്ൻ ആരംഭസമയമാണ്, അല്ലെങ്കിൽ ആരംഭസമയം കോൺഫിഗർ ചെയ്തിട്ടില്ലെങ്കിൽ ക്യാമ്പെയ്ൻ സൃഷ്ടിച്ച സമയമാണ്. skipped അഞ്ചാമത്തെ ബക്കറ്റ് അല്ല: കോളില്ലാതെ അവസാനിപ്പിച്ച നമ്പർ-തരം ഫിൽട്ടർ പ്രകാരമുള്ള failed-ലുള്ള കോൺടാക്ടുകളെയാണ് അത് എണ്ണുന്നത്.

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"
}
ഫീൽഡ്തരംവിവരണം
agent_idinteger | nullഒരു ഏജന്റിനെ നിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_namestring | nullഒരു ഏജന്റിനെ നിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
issue_report.severitystringcritical, warning, അല്ലെങ്കിൽ info
issue_report.statusstringopen അല്ലെങ്കിൽ resolved
issue_report.sourcestringuser (ഡാഷ്ബോർഡിൽനിന്ന് ഫയൽ ചെയ്തത്) അല്ലെങ്കിൽ system (ഗ്രേഡിംഗ് സൃഷ്ടിച്ചത്)

issue.escalated

ഒരു പ്രശ്ന പാറ്റേൺ സ്റ്റാഫ് അവലോകനത്തിനായി ThunderPhone-ലേക്ക് അയയ്ക്കുമ്പോൾ: ThunderPhone-ലേക്ക് റിപ്പോർട്ട് ചെയ്യുക എന്നതിന് ശേഷം, അല്ലെങ്കിൽ Fix with AI-ക്ക് ഉപഭോക്തൃ-വശത്തെ പരിഹാരം സ്ഥിരീകരിക്കാൻ കഴിയാതിരിക്കുകയും പ്രശ്നം സ്വയമേവ റൂട്ട് ചെയ്യുകയും ചെയ്യുമ്പോൾ. ഓർഗനൈസേഷൻ-വ്യാപക എൻഡ്പോയിന്റുകൾക്ക് മാത്രമേ ഈ ഇവന്റ് ലഭിക്കൂ.

{
  "data": {
    "automatic": false,
    "cluster_id": "7ac2844c-2df0-4fa8-a560-7378da649e19",
    "escalation_id": "ec99f52b-c8c0-41dd-a4f2-dd8a07b10894",
    "status": "open"
  },
  "event_id": "d8f8f420-7a42-45ba-bcf1-b747f9bbecda",
  "type": "issue.escalated"
}
ഫീൽഡ്തരംവിവരണം
automaticbooleanസ്വയമേവയുള്ള എസ്കലേഷനായി true; മാനുവൽ എസ്കലേഷനായി false
cluster_idUUIDഎസ്കലേറ്റ് ചെയ്ത പ്രശ്ന പാറ്റേൺ
escalation_idUUIDഎസ്കലേഷൻ റെക്കോർഡ്
statusstringഇവന്റ് അയയ്ക്കുമ്പോൾ open

ഇത് ഒരു അറിയിപ്പാണ്, എവിഡൻസ് ബണ്ടിൽ അല്ല. പ്രശ്ന പാറ്റേണുമായി ഇതിനെ ബന്ധിപ്പിക്കാൻ cluster_id ഉപയോഗിക്കുക. ThunderPhone-ലേക്ക് റിപ്പോർട്ട് ചെയ്യുക കാണുക.


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

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"
}
ഫീൽഡ്തരംവിവരണം
agent_idinteger | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_namestring | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
test_call_run.target_typestringagent അല്ലെങ്കിൽ phone_number
test_call_run.target_idintegertarget_type-ന് യോജിക്കുന്ന, റൺ ലക്ഷ്യമിട്ട ഏജന്റ് ഐഡി അല്ലെങ്കിൽ ഫോൺ-നമ്പർ ഐഡി
test_call_run.statusstringcompleted അല്ലെങ്കിൽ failed
test_call_run.call_idinteger | nullകോൾ ആരംഭിക്കുന്നതിന് മുമ്പ് റൺ പരാജയപ്പെട്ടാൽ null
test_call_run.error_messagestringവിജയിക്കുമ്പോൾ ശൂന്യം

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

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"
}
ഫീൽഡ്തരംവിവരണം
event_id (in data)UUIDഅലേർട്ട് പ്രവർത്തന ഐഡി — എൻവലപ്പിന്റെ ഡെലിവറി event_id-ൽ നിന്ന് വ്യത്യസ്തം
rule_id, rule_nameUUID, stringപ്രവർത്തിച്ച റൂൾ
metricstringsuccess_rate, failure_rate, avg_score, call_volume, അല്ലെങ്കിൽ suite_regression
comparatorstringlt, lte, gt, അല്ലെങ്കിൽ gte
metric_valuenumberറൂൾ പ്രവർത്തിച്ചപ്പോൾ വിൻഡോയിലെ മെട്രിക്കിന്റെ മൂല്യം
thresholdnumberകോൺഫിഗർ ചെയ്ത ത്രെഷോൾഡ്
window_hoursintegerഅവസാനിക്കുന്ന മൂല്യനിർണയ വിൻഡോ
fired_attimestamp

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


ഫോൺ നമ്പർ ഇവന്റുകൾ

phone_number.spam_risk_changed

സ്പാം-ലേബൽ നിരീക്ഷണം (പണമടച്ച് ഉപയോഗിക്കാവുന്ന ഒരു ആഡ്-ഓൺ; സപ്പോർട്ട് മുഖേന അഭ്യർഥിച്ചാൽ ലഭ്യം) നിരീക്ഷിക്കുന്ന ഒരു നമ്പറിന്റെ സ്പാം റിസ്ക് medium അല്ലെങ്കിൽ high ആയി ഉയരുന്നത് കണ്ടെത്തുമ്പോൾ അയയ്ക്കുന്നു (low-ൽ നിന്ന്, ഇതുവരെ റീഡിംഗ് ഇല്ലാത്ത അവസ്ഥയിൽ നിന്ന്, അല്ലെങ്കിൽ medium-ൽ നിന്ന് high-ലേക്ക്). തടസ്സമുണ്ടാക്കുന്നതല്ല. ഫ്ലാഗ് ചെയ്ത നിലയിൽ തുടരുന്ന നമ്പറിന് വീണ്ടും അയയ്ക്കില്ല; low-ലേക്ക് വീണ്ടെടുക്കുകയും പിന്നീട് ഫ്ലാഗ് ചെയ്യപ്പെടുകയും ചെയ്യുന്ന നമ്പറിന് അയയ്ക്കും.
ഈ ഇവന്റിന് ഏജന്റ് കോൺടെക്സ്റ്റ് ഇല്ലാത്തതിനാൽ, ഓർഗനൈസേഷൻ-തല എൻഡ്‌പോയിന്റുകൾക്ക് മാത്രമാണ് ഇത് ലഭിക്കുക. ഓർഗനൈസേഷന്റെ ഉടമകൾക്കും അഡ്മിൻമാർക്കും ഒരു ഇമെയിലും ലഭിക്കും.

{
  "data": {
    "checked_at": "2026-10-21T14:41:07+00:00",
    "phone_number": "+13125550100",
    "phone_number_id": 412,
    "previous_spam_risk": "low",
    "scores": {
      "connection": 31,
      "engagement": 40,
      "maturity": 82,
      "sentiment": 22
    },
    "spam_category": "Telemarketer",
    "spam_risk": "high"
  },
  "event_id": "6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
  "type": "phone_number.spam_risk_changed"
}
ഫീൽഡ്തരംവിവരണം
phone_numberstringE.164 ഫോർമാറ്റിലുള്ള നമ്പർ
phone_number_idinteger | nullPhone Numbers-ലെ അതിന്റെ id
spam_riskstringmedium അല്ലെങ്കിൽ high
previous_spam_riskstring | nullകഴിഞ്ഞ റീഡിംഗിലെ റിസ്ക്; ആദ്യ റീഡിംഗിന് മുമ്പ് null
spam_categorystring | nullTelemarketer അല്ലെങ്കിൽ Survey പോലുള്ള, കാരിയർമാർ കാണിച്ചേക്കാവുന്ന ലേബൽ. ഇത് സ്വതന്ത്ര ടെക്സ്റ്റായി പരിഗണിക്കുക
scoresobjectഓരോന്നും 0 മുതൽ 100 വരെ, അല്ലെങ്കിൽ മതിയായ കോൾ വോളിയം ലഭിക്കുന്നതുവരെ null: maturity (നമ്പർ എത്രത്തോളം സ്ഥാപിതമാണ്), connection (ആളുകൾ കോൾ എടുക്കുന്നുണ്ടോ), engagement (അവർ ലൈനിൽ തുടരുന്നുണ്ടോ), sentiment (അവർ ബ്ലോക്ക് ചെയ്യുകയോ റിപ്പോർട്ട് ചെയ്യുകയോ ചെയ്യുന്നുണ്ടോ)
checked_attimestampThunderPhone ഫലം വായിച്ച സമയം

മൈഗ്രേഷൻ ഇവന്റുകൾ

migration.call.complete

ഒരു കോൾ അവസാനിക്കുമ്പോൾ POST /v1/migrations/{id}/calls മുഖേന നടത്തിയതാണെങ്കിൽ ഇത് അയയ്ക്കപ്പെടുന്നു, അത് ഏത് പ്ലാറ്റ്ഫോമാണ് കൈകാര്യം ചെയ്തതെന്നത് പരിഗണിക്കാതെ. ഇത് തടസ്സപ്പെടുത്തുന്നതല്ല. കോൾ അവസാനിച്ചതിന് ശേഷം ഏകദേശം 5 മിനിറ്റ് വരെ സമയത്തിനുള്ളിൽ ഇത് ലഭിക്കും. data-യിൽ telephony.complete-ലെ എല്ലാ ഫീൽഡുകൾക്കും പുറമെ ഒരു migration ബ്ലോക്കും ഉണ്ടായിരിക്കും. ThunderPhone നടത്തിയ കോൾ സാധാരണപോലെ അതേ call_id ഉപയോഗിച്ച് telephony.complete-ഉം അയയ്ക്കും. മറ്റേ പ്ലാറ്റ്ഫോം കൈകാര്യം ചെയ്ത കോളിന് answered_by null ആയിരിക്കും. മറ്റേ പ്ലാറ്റ്ഫോമിലെ ഒരു കോൾ 2 മണിക്കൂറിന് ശേഷവും അവസാനിച്ചിട്ടില്ലെങ്കിലോ, അതിന്റെ മൈഗ്രേഷൻ പൂർത്തിയാകുകയോ കീ നഷ്ടപ്പെടുകയോ ആദ്യം സംഭവിച്ചാലോ, status: "unknown" എന്നതോടെയും ട്രാൻസ്ക്രിപ്റ്റ് ഇല്ലാതെയും അയയ്ക്കപ്പെടും.

{
  "data": {
    "agent_id": 42,
    "agent_name": "Front desk",
    "answered_by": null,
    "billable_minutes": null,
    "billing_total_cents": null,
    "call_id": null,
    "direction": "outbound",
    "duration_seconds": 94,
    "end_reason": "user_hangup",
    "end_time": "2026-10-06T17:01:34+00:00",
    "extracted_data": null,
    "from_number": "+15551234567",
    "migration": {
      "arm": "vendor",
      "id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
      "metadata": {
        "lead_id": "8812"
      },
      "routing_id": "9b2f8c1e-4d3a-4f6b-8e2d-1a7c5b9e0f34",
      "vendor": "retell",
      "vendor_call_id": "call_6a1f0e",
      "vendor_cost_usd": "0.1240"
    },
    "product": "",
    "recording_mode": "vendor",
    "recording_url": "https://…",
    "start_time": "2026-10-06T17:00:00+00:00",
    "status": "completed",
    "summary": "The callee booked a table for two on Thursday.",
    "thunderphone_retained_call_content": true,
    "to_number": "+14155552671",
    "transcripts": [
      {
        "content": "Hi Ada, this is Rosa's calling about your booking.",
        "role": "agent"
      },
      {
        "content": "Yes, Thursday works.",
        "role": "user"
      }
    ],
    "transfer_number": null,
    "unresolved_variables": [],
    "variables": {
      "first_name": "Ada"
    },
    "voice": ""
  },
  "event_id": "7c1e2f3a-4b5c-4d6e-8f7a-9b0c1d2e3f4a",
  "type": "migration.call.complete"
}
ഫീൽഡ്തരംവിവരണം
migration.idUUIDമൈഗ്രേഷൻ
migration.routing_idUUIDനിങ്ങൾ കോൾ നടത്തിയപ്പോൾ ലഭിച്ചതുപോലെ റൂട്ട് ചെയ്ത കോൾ
migration.armstringours (ThunderPhone കോൾ നടത്തി) അല്ലെങ്കിൽ vendor (മറ്റേ പ്ലാറ്റ്ഫോം നടത്തി)
migration.vendorstringretell, vapi, elevenlabs, അല്ലെങ്കിൽ bland
migration.vendor_call_idstring | nullമറ്റേ പ്ലാറ്റ്ഫോമിന്റെ കോൾ ഐഡി; ours-ന് null
migration.metadataobjectകോൾ നടത്തുമ്പോൾ നിങ്ങൾ അയച്ച metadata
migration.vendor_cost_usdstring | nullമറ്റേ പ്ലാറ്റ്ഫോം റിപ്പോർട്ട് ചെയ്ത കോൾ ചെലവ്, അത് റിപ്പോർട്ട് ചെയ്തിട്ടുണ്ടെങ്കിൽ
call_idinteger | nullThunderPhone കോൾ ഐഡി; vendor-ന് null
statusstringvendor-ന്: വിളിക്കപ്പെട്ട വ്യക്തി സംസാരിച്ചാൽ completed, സംസാരിച്ചില്ലെങ്കിൽ failed, മുകളിൽ പറഞ്ഞതുപോലെ unknown. ours-ന്: telephony.complete-ലേതുപോലെ

ഒരു vendor കോളിന് ThunderPhone-ൽ ബില്ലിംഗ് അല്ലെങ്കിൽ എക്സ്ട്രാക്ഷൻ ഡാറ്റ ഉണ്ടായിരിക്കില്ല: billable_minutes, billing_total_cents, extracted_data എന്നിവ null ആയിരിക്കും, product, voice എന്നിവ ശൂന്യമായിരിക്കും, recording_mode vendor ആയിരിക്കും, കൂടാതെ recording_url മറ്റേ പ്ലാറ്റ്ഫോം നൽകിയിട്ടുണ്ടെങ്കിൽ അതിന്റെ ലിങ്കായിരിക്കും.

migration.rollback

ഒരു മൈഗ്രേഷന്റെ ക്രമാനുഗത സ്വിച്ച് എല്ലാ കോളുകളും സ്വയമേവ മറ്റേ പ്ലാറ്റ്ഫോമിലേക്ക് തിരിച്ചുവിടുമ്പോൾ അയക്കുന്നു: 15 മിനിറ്റിനുള്ളിൽ 3 കോളുകൾക്ക് ThunderPhone-ലേക്ക് കണക്റ്റ് ചെയ്യാനായില്ല, ThunderPhone-ലേക്ക് അയച്ച 2 കോളുകൾ ഏജന്റ് മറുപടി നൽകുന്നതിന് മുമ്പ് അവസാനിച്ചു, അല്ലെങ്കിൽ ThunderPhone-ന്റെ ടാസ്‌ക് ഫലനിരക്ക് മറ്റേ പ്ലാറ്റ്ഫോമിന്റേതിനെക്കാൾ കോൺഫിഗർ ചെയ്ത വിടവിനെ മറികടക്കുന്ന അളവിൽ താഴ്ന്നു. തടസ്സമില്ലാത്തത്, ഓരോ റോൾബാക്കിനും ഒരിക്കൽ. ഇതിനുശേഷം ThunderPhone-ന്റെ പങ്ക് 0% ആയിരിക്കും; ഏജന്റിന്റെ മൈഗ്രേഷൻ ടാബിൽ ആരെങ്കിലും അത് പുനരാരംഭിക്കുന്നതുവരെ മൈഗ്രേഷൻ താൽക്കാലികമായി നിർത്തിവെക്കും. പേലോഡിൽ ഫോൺ നമ്പറുകളോ, ട്രാൻസ്ക്രിപ്റ്റുകളോ, കോൾ ID-കളോ ഉൾപ്പെടില്ല.

{
  "data": {
    "agent_id": 42,
    "agent_name": "Front desk",
    "dropped": 0,
    "migration_id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
    "ours": {
      "graded": 20,
      "success_rate": 0.8
    },
    "ours_failed": 3,
    "ours_percent": 0,
    "previous_percent": 25,
    "reason": "ours_failed_burst",
    "rolled_back_at": "2026-10-10T12:05:00+00:00",
    "step": 1,
    "theirs": {
      "graded": 20,
      "success_rate": 0.8
    },
    "vendor": "retell"
  },
  "event_id": "3d1f6b2a-8c4e-5a7b-9d0e-2f1a3b4c5d6e",
  "type": "migration.rollback"
}
ഫീൽഡ്തരംവിവരണം
migration_idUUIDമൈഗ്രേഷൻ
vendorstringretell, vapi, elevenlabs, അല്ലെങ്കിൽ bland
reasonstringours_failed_burst (15 മിനിറ്റിനുള്ളിൽ 3 പരാജയപ്പെട്ട കണക്ഷനുകൾ), dropped_calls (30 മിനിറ്റിനുള്ളിൽ ഏജന്റ് മറുപടി നൽകുന്നതിന് മുമ്പ് അവസാനിച്ച 2 കോളുകൾ), അല്ലെങ്കിൽ rate_gap (ഓരോ ഭാഗത്തിനും കുറഞ്ഞത് rollback_min_calls ഗ്രേഡ് ചെയ്ത കോളുകളിൽ ടാസ്‌ക് ഫലനിരക്കിലെ വിടവ്)
previous_percentintegerറോൾബാക്കിന് മുമ്പുള്ള ThunderPhone-ന്റെ കോൾ പങ്ക്
ours_percentintegerഎപ്പോഴും 0
stepinteger | nullഅത് ഉണ്ടായിരുന്ന ഷെഡ്യൂൾ സ്റ്റെപ്പ് (0-അടിസ്ഥാനത്തിൽ)
ours / theirsobject | nullനിലവിലെ സ്റ്റെപ്പിലെ ഗ്രേഡ് ചെയ്ത കോളുകളും അവയുടെ വിജയനിരക്കും; സ്റ്റെപ്പിൽ കോളുകൾ വളരെ കുറവാണെങ്കിൽ theirs കഴിഞ്ഞ 30 ദിവസത്തേതായിരിക്കാം. ഒന്നുമില്ലാത്തപ്പോൾ null
ours_failedintegerകഴിഞ്ഞ 15 മിനിറ്റിൽ കണക്കാക്കിയ പരാജയപ്പെട്ട കണക്ഷനുകൾ
droppedintegerകഴിഞ്ഞ 30 മിനിറ്റിൽ ഡ്രോപ്പ് ആയതായി കണക്കാക്കിയ കോളുകൾ
rolled_back_attimestamp

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