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

Webhooks

telephony.complete / web.complete

ട്രാൻസ്ക്രിപ്റ്റ്, റെക്കോർഡിംഗ് URL, മെട്രിക്‌സ് എന്നിവയോടെ ഒരു കോൾ അവസാനിക്കുമ്പോൾ കൈമാറുന്ന നോൺ-ബ്ലോക്കിംഗ് വെബ്ഹുക്ക്.

ഓരോ കോൾ അവസാനിച്ചതിന് ശേഷവും ഒരു completion ഇവന്റ് പ്രവർത്തിക്കും — ഇൻബൗണ്ട് ടെലിഫോണി, ഔട്ട്‌ബൗണ്ട് ടെലിഫോണി, വെബ് കോൾ, അല്ലെങ്കിൽ ടെസ്റ്റ് കോൾ (builder mic സെഷൻ). ഇത് തടസ്സമില്ലാത്തതാണ്: ഏതെങ്കിലും 2xx ഉപയോഗിച്ച് പ്രതികരിക്കുക.

ഇവന്റ് രണ്ട് പാതകളിലും ഡെലിവർ ചെയ്യപ്പെടുന്നു:

  • Webhook endpoints ന് telephony.complete (ഫോൺ കോളുകൾ) അല്ലെങ്കിൽ web.complete (വെബ് കോളുകളും builder mic ടെസ്റ്റ് കോളുകളും) ലഭിക്കും. ഇതിൽ താഴെ രേഖപ്പെടുത്തിയ സ്ഥിരതയുള്ള payload, ഓരോ ഡെലിവറിക്കും event_id, 30 s timeout, കൂടാതെ 24 h വരെ retries ഉൾപ്പെടും.
  • legacy single-URL webhook ന് അല്പം വ്യത്യസ്തമായ payload സഹിതം ഒരു synchronous attempt ലഭിക്കും (10 s timeout, retries ഇല്ല) — കാണുക Legacy payload differences.

അഭ്യർത്ഥന പേലോഡ് (എൻഡ്‌പോയിന്റ് ഡെലിവറികൾ)

{
  "data": {
    "billable_minutes": 1.25,
    "billing_total_cents": 8,
    "call_id": 987654321,
    "direction": "inbound",
    "duration_seconds": 54,
    "end_reason": "user_hangup",
    "end_time": "2026-04-20T18:25:04.822Z",
    "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..."
    },
    "from_number": "+14155550199",
    "product": "spark",
    "recording_stopped_at": null,
    "recording_stopped_reason": null,
    "recording_url": "https://storage.example.com/…",
    "start_time": "2026-04-20T18:24:10.113Z",
    "status": "completed",
    "summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23. The agent read the appointment back and Alex asked for a reminder text the day before.",
    "to_number": "+15551234567",
    "transcripts": [ /* see Transcript format */ ],
    "transfer_number": null,
    "unresolved_variables": ["campaign_owner"],
    "variables": {"campaign_name": "Spring renewals"},
    "voice": "john"
  },
  "event_id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
  "type": "telephony.complete"
}
ഫീൽഡ്തരംവിവരണം
call_idപൂർണ്ണസംഖ്യഈ കോളിനായുള്ള എല്ലാ ഇവന്റുകളിലും സ്ഥിരതയുള്ളത്
agent_idപൂർണ്ണസംഖ്യ | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
agent_nameസ്ട്രിംഗ് | nullനിയോഗിച്ചിട്ടുണ്ടെങ്കിൽ, കോൾ കൈകാര്യം ചെയ്ത ഏജന്റ്
directionസ്ട്രിംഗ്inbound, outbound, web, test. ചരിത്രപരമായ പേലോഡുകളിൽ പഴയ mic അല്ലെങ്കിൽ widget മൂല്യങ്ങൾ ഉണ്ടായേക്കാം
from_number, to_numberസ്ട്രിംഗ്E.164. വെബ് കോളുകൾക്കും ടെസ്റ്റ് കോളുകൾക്കും from_number-ന്റെ അക്ഷരാർഥ മൂല്യം "web" ആണ്
origin_domainസ്ട്രിംഗ്വെബ്/ടെസ്റ്റിന് മാത്രം — വിജറ്റ് ഹോസ്റ്റ് ചെയ്ത പേജിന്റെ ഒറിജിൻ (മൈക്ക് സെഷനുകൾക്ക് ശൂന്യം)
start_time, end_timeടൈംസ്റ്റാമ്പ്ISO 8601 UTC
duration_secondsപൂർണ്ണസംഖ്യ | nullആരംഭ/അവസാന സമയത്തിൽ നിന്ന് നിർണയിക്കുന്നത്
statusസ്ട്രിംഗ്completed അല്ലെങ്കിൽ failed
end_reasonസ്ട്രിംഗ്താഴെയുള്ള പട്ടിക കാണുക
answered_byസ്ട്രിംഗ് | nullഔട്ട്ബൗണ്ട് ഫോൺ കോളുകൾക്ക് മാത്രം (മറ്റുവിധത്തിൽ ഇല്ല): ഉത്തരം നൽകിയത് ആര്, human, voicemail, screener (കോൾ സ്ക്രീനിംഗ് അസിസ്റ്റന്റ്), ivr (ഫോൺ മെനു), അല്ലെങ്കിൽ unknown. ആരും ഉത്തരം നൽകിയില്ലെങ്കിൽ null, കൂടാതെ നിങ്ങൾ മാറുന്ന പ്ലാറ്റ്ഫോം കൈകാര്യം ചെയ്ത ഔട്ട്ബൗണ്ട് കോളുകൾക്കായുള്ള migration.call.complete ഇവന്റുകളിൽ എല്ലായ്പ്പോഴും null. കോൾ ഒബ്ജക്റ്റിന് സമാനമായ മൂല്യങ്ങൾ
product, voiceസ്ട്രിംഗ്കോൾ സമയത്ത് പ്രാബല്യത്തിലുണ്ടായിരുന്ന ഏജന്റ് കോൺഫിഗറേഷൻ
variablesഒബ്ജക്റ്റ്കോൾ ആരംഭിച്ചപ്പോൾ സ്നാപ്പ്ഷോട്ട് എടുത്ത ഇൻപുട്ട് വേരിയബിളുകൾ
unresolved_variablesഅറേകോൾ കോൺഫിഗറേഷൻ പരാമർശിച്ചെങ്കിലും കോൾ ആരംഭത്തിൽ നൽകിയിട്ടില്ലാത്ത വേരിയബിൾ പേരുകൾ
transfer_numberസ്ട്രിംഗ് | nullകോൾ ട്രാൻസ്ഫർ ചെയ്തപ്പോൾ സജ്ജീകരിക്കുന്നത്
scheduled_send_idസ്ട്രിംഗ്ഷെഡ്യൂൾ ചെയ്ത അയയ്ക്കൽ വഴി സ്ഥാപിച്ച കോളിൽ മാത്രം: ആ അയയ്ക്കലിന്റെ id. മറ്റെല്ലാ കോളുകളിലും ഇല്ല
recording_urlസ്ട്രിംഗ് | nullകാലഹരണപ്പെടുന്ന സൈൻ ചെയ്ത URL; ഉടൻ ഡൗൺലോഡ് ചെയ്യുക. റെക്കോർഡിംഗ് ആർട്ടിഫാക്ട് ലഭ്യമല്ലാത്തപ്പോൾ null
recording_stopped_atടൈംസ്റ്റാമ്പ് | nullകോൾ അവസാനിക്കുന്നതിന് മുമ്പ് റെക്കോർഡിംഗ് നിർത്തിയ സമയം; ഈ നിമിഷത്തിന് ശേഷമുള്ളതൊന്നും റെക്കോർഡിംഗിലില്ല. കോൾ അവസാനിക്കുന്നതുവരെ റെക്കോർഡിംഗ് നടന്നാലോ കോൾ റെക്കോർഡ് ചെയ്തിട്ടില്ലെങ്കിലോ null
recording_stopped_reasonസ്ട്രിംഗ് | nullറെക്കോർഡിംഗ് നേരത്തെ നിർത്തിയതിന്റെ കാരണം. warm_transfer: ഒരു വാം ട്രാൻസ്ഫർ ലക്ഷ്യസ്ഥാനത്തേക്ക് കോൾ ചെയ്യുന്നതിന് തൊട്ടുമുമ്പ് ഇത് നിർത്തുന്നു; ട്രാൻസ്ഫർ പരാജയപ്പെട്ട് കോൾ ചെയ്യുന്നയാൾ ഏജന്റിലേക്ക് മടങ്ങിയാലും ഇത് ഓഫായി തുടരും. മറ്റ് മൂല്യങ്ങളെ വിവരാവശ്യത്തിനുള്ളതായി കണക്കാക്കുക; കൂടുതൽ മൂല്യങ്ങൾ ചേർത്തേക്കാം. recording_stopped_at null ആയിരിക്കുമ്പോൾ null
billable_minutesസംഖ്യബിൽ ചെയ്ത മിനിറ്റുകൾ, ഏറ്റവും അടുത്ത കാൽ മിനിറ്റിലേക്ക് റൗണ്ട് ചെയ്തത് (15-സെക്കൻഡ് വർധനകൾ, കുറഞ്ഞത് 0.25). നേരിട്ട് വോയ്‌സ്‌മെയിലിലേക്കുള്ള കോളുകൾ അവയുടെ യഥാർത്ഥ മീറ്റർ ചെയ്ത മിനിറ്റുകൾ ഇവിടെ റിപ്പോർട്ട് ചെയ്യുന്നു, പക്ഷേ നിരക്ക് പ്ലാൻ പ്രകാരം ചാർജ് ഒരു മിനിറ്റിൽ പരിമിതപ്പെടുത്തിയിരിക്കും.
billing_total_centsപൂർണ്ണസംഖ്യ | nullUSD സെന്റുകൾ. billing_pending true ആയിരിക്കുമ്പോൾ null
billing_pendingബൂളിയൻചാർജ് ഇതുവരെ തീർപ്പാക്കിയിട്ടില്ലാത്ത മീറ്റർ ചെയ്ത കോളിൽ മാത്രം, true ആയി ലഭിക്കും: ഉപയോഗം ലഭ്യമായ ശേഷം, കോളിന് അവസാനിച്ച് ഏതാനും മിനിറ്റുകൾക്ക് ശേഷം മീറ്റർ ചെയ്ത കോളിന് ചാർജ് ചെയ്യും; അതിനാൽ ഇവിടെ billable_minutes, billing_total_cents എന്നിവ null ആയിരിക്കും, ചാർജ് call.billed-ൽ ലഭിക്കും. മറ്റെല്ലാ കോളുകളിലും ഇല്ല
transcriptsഅറേഓരോ ടേണിലുമുള്ള ട്രാൻസ്ക്രിപ്റ്റ് എൻട്രികൾ; ട്രാൻസ്ക്രിപ്റ്റ് ലഭ്യമല്ലാത്തപ്പോൾ ശൂന്യമായേക്കാം
summaryസ്ട്രിംഗ് | nullഏജന്റ് ബിൽഡറിലെ ശേഖരിക്കേണ്ട ഡാറ്റ വിഭാഗത്തിൽ കോൾ സംഗ്രഹം സൃഷ്ടിക്കുക പ്രവർത്തനക്ഷമമാക്കിയിരിക്കുമ്പോൾ ( ഏജന്റിൽ call_summary_enabled) ജനറേഷൻ വിജയിച്ചാൽ, ലളിതഭാഷയിലുള്ള കോൾ-ശേഷമുള്ള സംഗ്രഹം (ഗദ്യരൂപത്തിലുള്ള രണ്ട് മുതൽ നാല് വാക്യങ്ങൾ വരെ, പരമാവധി 2,000 അക്ഷരങ്ങൾ; ഏജന്റിന്റെ summary_language-ൽ, ഇല്ലെങ്കിൽ ഓർഗനൈസേഷന്റെ സംഗ്രഹ ഭാഷയിൽ, ഇല്ലെങ്കിൽ കോളിന്റെ ഭാഷയിൽ: കോൾ അതിനെ മറികടന്നിട്ടില്ലെങ്കിൽ ഏജന്റിന്റെ പ്രാഥമിക ഭാഷയിൽ). അല്ലാത്തപക്ഷം null; സംഗ്രഹിക്കാൻ വളരെ ചെറിയ കോളുകൾ, ട്രാൻസ്ക്രിപ്റ്റില്ലാത്ത കോളുകൾ, റെക്കോർഡിംഗ് ഓഫാക്കിയ ഏജന്റുകൾ എന്നിവയും ഇതിൽ ഉൾപ്പെടുന്നു. എക്സ്ട്രാക്ഷനോടൊപ്പമുള്ള അതേ കോൾ-ശേഷ ഘട്ടത്തിലാണ് സംഗ്രഹം സൃഷ്ടിക്കുന്നത്; അതിനാൽ കോൾ പൂർത്തിയായ വെബ്ഹുക്ക് അയയ്ക്കുന്നതിന് മുമ്പ് എക്സ്ട്രാക്റ്റ് ചെയ്ത ഡാറ്റയ്ക്കായി കാത്തിരിക്കുക ക്രമീകരണം (extraction_blocks_completion) ഈ ഇവന്റ് അതിനായി കാത്തിരിക്കുമോ എന്ന് തീരുമാനിക്കുന്നു: കാത്തിരിപ്പ് മോഡിൽ ഈ ഇവന്റ് അയയ്ക്കുന്നതിന് മുമ്പ് സംഗ്രഹം തയ്യാറായിരിക്കും (സ്റ്റെപ്പിന്റെ 75-സെക്കൻഡ് ബജറ്റിനുള്ളിൽ സംഗ്രഹത്തിന് പരമാവധി 30 സെക്കൻഡ് ലഭിക്കും); ഇവന്റ് കാത്തിരിക്കാത്തപ്പോൾ (never, അല്ലെങ്കിൽ except_transfers പ്രകാരമുള്ള ട്രാൻസ്ഫറോ നിങ്ങളുടെ കോൺടാക്ട് സെന്ററിലേക്കുള്ള തിരിച്ചുപോക്കോ) ഈ ഫീൽഡ് null ആയിരിക്കും, സംഗ്രഹം call.data_extracted-ൽ വീണ്ടും അയയ്ക്കില്ല; അതിനാൽ പിന്നീട് കോൾ ഒബ്ജക്റ്റിലെ summary-യിൽ നിന്ന് വായിക്കുക. ഡാഷ്ബോർഡിലെ കോൾ പേജിലും ലഭ്യമാണ്
extracted_dataഒബ്ജക്റ്റ് | nullstatus, fields, evidence, verification, field_reasons, schema_version എന്നിവയുള്ള ഘടനാപരമായ എക്സ്ട്രാക്ഷൻ ഫലം. ഓരോ null അല്ലാത്ത ഫീൽഡിനും കൃത്യമായി ഘടനാപരമായി പരിശോധിച്ച ഉദ്ധരണി (പരമാവധി 1,000 അക്ഷരങ്ങൾ), അതിന്റെ സ്പീക്കർ റോൾ, ടേൺ ഇൻഡക്സ് എന്നിവ ഉണ്ടായിരിക്കും; മോഡൽ തിരികെ നൽകിയ ദൈർഘ്യമേറിയ ഉദ്ധരണികൾ വെട്ടിച്ചുരുക്കുന്നതിന് പകരം നിരസിക്കും. ഫീൽഡ് null ആയിരിക്കുമ്പോൾ എവിഡൻസ് null ആയിരിക്കും. verified എന്നത് ഓരോ സ്ഥാനാർഥിക്കും കൃത്യമായി ഒരു സാധുവായ സ്വതന്ത്ര വിധി ലഭിച്ചു എന്നാണ് അർഥം. unavailable തെറ്റായതോ ഭാഗികമായതോ ആയ വെരിഫയർ ഔട്ട്പുട്ടും ഉൾക്കൊള്ളുന്നു; സാധുവായ ഭാഗിക വിധികൾ ഇപ്പോഴും ബാധകമാണ്, എന്നാൽ ഒരു സാധുവായ വിധിയും ഇല്ലാത്ത സ്ഥാനാർഥികളെ null ആക്കും. status completed, failed, exhausted, skipped, അല്ലെങ്കിൽ skipped_recording_disabled ആണ്; ഏജന്റിന് എക്സ്ട്രാക്ഷൻ ഫീൽഡുകളൊന്നുമില്ലെങ്കിൽ null
steps_traceഅറേഏജന്റിന് സ്റ്റെപ്പുകളോ ഹാൻഡ്ഓഫുകളോ ഉള്ള കോളുകളിൽ മാത്രം. കോൾ അവയിലൂടെ നീങ്ങിയ ക്രമം: ഓരോ എൻട്രിയിലും t_ms (കോൾ ആരംഭിച്ചതിന് ശേഷമുള്ള മില്ലിസെക്കൻഡുകൾ), agent (ഏജന്റിന്റെ കീ, a-യും അതിന്റെ ID-യും ചേർന്നത്), step (സ്റ്റെപ്പ് ID, അല്ലെങ്കിൽ സ്റ്റെപ്പുകളില്ലാത്ത ഏജന്റിലേക്കുള്ള ഹാൻഡ്ഓഫിൽ null) കൂടാതെ via (start, model, condition, on_enter അല്ലെങ്കിൽ handoff) ഉണ്ടായിരിക്കും. ID-കളും സമയങ്ങളും മാത്രം സൂക്ഷിക്കുന്നതിനാൽ റെക്കോർഡിംഗ് ഓഫായിരിക്കുമ്പോഴും ഇത് നിലനിർത്തുന്നു
collected_valuesഒബ്ജക്റ്റ്ഏജന്റിന് സ്റ്റെപ്പുകളോ ഹാൻഡ്ഓഫുകളോ ഉള്ള കോളുകളിൽ മാത്രം. ഏജന്റ് അതിന്റെ സ്റ്റെപ്പുകളിൽ ശേഖരിച്ച മൂല്യങ്ങൾ, ശേഖരണ ഫീൽഡിന്റെ പേര് കീ ആയി, കൂടാതെ ഓരോ സ്റ്റെപ്പിന്റെയും on_enter_tool ഫലത്തിനായി <tool>_result. കോളിന്റെ ഉള്ളടക്കം നിലനിർത്താത്തപ്പോൾ (റെക്കോർഡിംഗ് ഓഫാക്കിയപ്പോൾ) ഒഴിവാക്കപ്പെടും

അവസാനിപ്പിക്കൽ കാരണങ്ങൾ

മൂല്യംഅർത്ഥം
user_hangupറിമോട്ട് കക്ഷി ആദ്യം കോൾ വിച്ഛേദിച്ചു
ai_hangupAI മനഃപൂർവം കോൾ അവസാനിപ്പിച്ചു
ai_transferAI കോൾ കൈമാറി; transfer_number സജ്ജീകരിച്ചിരിക്കുന്നു
ai_warm_transferAI വാം (അറ്റൻഡഡ്) ട്രാൻസ്ഫർ പൂർത്തിയാക്കി
returned_to_platformAI കോൾ നിങ്ങളുടെ കോൺടാക്റ്റ് സെന്ററിലേക്ക് മടക്കി: ലഭ്യമെങ്കിൽ, റിട്ടേൺ എൻട്രിയുടെ ഹെഡറുകളോടെ SIP BYE അയച്ച് കോൾ വിച്ഛേദിച്ചു
voicemail_hangupവോയ്‌സ്‌മെയിൽ കണ്ടെത്തി, നിങ്ങളുടെ voicemail_action അനുസരിച്ച് കോൾ അവസാനിപ്പിച്ചു
max_durationകോൾ പരമാവധി ദൈർഘ്യപരിധിയിലെത്തി: ഏജന്റിന്റെയോ കോളിന്റെയോ സ്വന്തം പരിധി, അല്ലെങ്കിൽ 6-മണിക്കൂർ പ്ലാറ്റ്ഫോം പരിധി. സമയപരിധി മുന്നറിയിപ്പിന് ശേഷം AI അല്ലെങ്കിൽ കോളർ അവസാനിപ്പിക്കുന്ന കോൾ ai_hangup അല്ലെങ്കിൽ user_hangup നിലനിർത്തും
supersededസെഷൻ പുതിയതൊന്നാൽ മാറ്റിസ്ഥാപിക്കപ്പെട്ടു
inbound_config_webhook_failedവെബ്‌ഹുക്ക് മോഡിലുള്ള ഒരു നമ്പറിലേക്കുള്ള ഇൻബൗണ്ട് കോൾ: കോൺഫിഗറേഷൻ വെബ്‌ഹുക്ക് ഉപയോഗിക്കാവുന്ന കോൺഫിഗറേഷൻ മടക്കിനൽകിയില്ല, അതിനാൽ ഏജന്റ് ഉത്തരം നൽകുന്നതിന് മുമ്പ് കോൾ അവസാനിപ്പിച്ചു. status എന്നത് failed ആണ്, കോളിന് നിരക്ക് ഈടാക്കില്ല
outbound_queue_timeoutഒരു ക്യൂ ചെയ്ത കോൾ ഡയൽ ചെയ്യാൻ ഒഴിവ് ലഭിക്കാതെ 10 മിനിറ്റ് കാത്തിരുന്നു. status എന്നത് failed ആണ്, ഒന്നും ഡയൽ ചെയ്തില്ല, കോളിന് നിരക്ക് ഈടാക്കില്ല
outbound_queue_canceledഡയൽ ചെയ്യുന്നതിന് മുമ്പ് നിങ്ങൾ ഒരു ക്യൂ ചെയ്ത കോൾ റദ്ദാക്കി. status എന്നത് failed ആണ്, കോളിന് നിരക്ക് ഈടാക്കില്ല
unknownഅവസാനിപ്പിച്ചതിന്റെ കാരണം നിർണയിക്കാനായില്ല

ട്രാൻസ്ക്രിപ്റ്റ് ഫോർമാറ്റ്

transcripts-ലെ ഓരോ എൻട്രിയും ഒരു സംഭാഷണ ടേണാണ്. റോളുകൾ user (വിളിക്കുന്നയാളുടെ സംഭാഷണം), model (ഏജന്റ് സംഭാഷണവും ഉപകരണ കോളുകളും), tool (ഉപകരണ ഫലങ്ങൾ), system (ഭാഷ മാറ്റങ്ങൾ പോലുള്ള കോൾ ഇവന്റുകൾ) എന്നിവയാണ്.

[
  {
    "role": "user",
    "content_type": "text/plain",
    "content": "Hi, I'm calling about my appointment.",
    "start_ms": 1200,
    "end_ms":   4100,
    "audio_url": "https://storage.example.com/…"
  },
  {
    "role": "model",
    "content_type": "text/plain",
    "content": "Sure, what date works best?",
    "start_ms": 4200,
    "end_ms":   6100
  },
  {
    "role": "model",
    "content_type": "application/json",
    "content": {
      "tool_call": "search_appointments",
      "arguments": { "date": "2026-04-21" }
    }
  },
  {
    "role": "tool",
    "content_type": "application/json",
    "content": {
      "tool_name": "search_appointments",
      "response": { "available_slots": ["9:00 AM", "2:00 PM"] }
    }
  }
]
ഫീൽഡ്തരംവിവരണം
roleസ്ട്രിംഗ്user, model, tool, അല്ലെങ്കിൽ system
content_typeസ്ട്രിംഗ്സംഭാഷണത്തിന് text/plain; ഉപകരണ കോളുകൾ, ഉപകരണ ഫലങ്ങൾ, സിസ്റ്റം ഇവന്റുകൾ എന്നിവയ്ക്ക് application/json
contentസ്ട്രിംഗ് | ഒബ്ജക്റ്റ്സംഭാഷണ ടെക്സ്റ്റ് അല്ലെങ്കിൽ മുകളിൽ കാണിച്ച ഘടനാപരമായ ഒബ്ജക്റ്റ്. ഉപകരണ കോളുകൾ: {"tool_call": name, "arguments": {…}}. ഉപകരണ ഫലങ്ങൾ: {"tool_name": name, "response": {…}}
start_ms, end_msഇന്റിജർകോൾ ആരംഭത്തിൽ നിന്നുള്ള ഓഫ്‌സെറ്റുകൾ, ms. ഓഡിയോ ടൈമിങ് അറിയാമെങ്കിൽ ഉൾപ്പെടും
ttfa_msഇന്റിജർഅളന്നിട്ടുണ്ടെങ്കിൽ, ഒരു model ടേണിനുള്ള ആദ്യ ഓഡിയോ വരെയുള്ള സമയം
audio_url, audio_urlsസ്ട്രിംഗ് / അറേഓരോ ടേണായും റെക്കോർഡ് ചെയ്തിട്ടുണ്ടെങ്കിൽ, ആ ടേണിന്റെ ഓഡിയോയ്ക്കുള്ള കാലഹരണപ്പെടുന്ന സൈൻ ചെയ്ത URL-കൾ

ഇടപെടൽ മാർക്കറുകൾ, അക്-പ്രോംപ്റ്റുകൾ, റോ സ്ഥാനങ്ങൾ എന്നിവയുള്ള പൂർണ ഘടനാപരമായ ടേൺ ചരിത്രത്തിനായി, GET /v1/calls/{call_id}/history ഉപയോഗിക്കുക.

ലെഗസി പേലോഡ് വ്യത്യാസങ്ങൾ

ലെഗസി സിംഗിൾ-URL വെബ്ഹുക്ക് എൻവലപ്പ് {"type": "telephony.complete" | "web.complete", "data": {…}} ആണ്, ഇതിൽ event_id ഇല്ല, കൂടാതെ അതിന്റെ data എൻഡ്‌പോയിന്റ് പേലോഡിൽനിന്ന് വ്യത്യസ്തമാണ്:

ലെഗസി പൂർത്തീകരണ പേലോഡിൽ agent_id, agent_name എന്നിവയും ഉൾപ്പെടും.

  • ടേൺ അറേ transcripts-ലല്ല, history-ലാണ് (മുകളിൽ പറഞ്ഞതുപോലെയുള്ള അതേ ടേൺ സ്കീമ).
  • ഫീൽഡ് സെറ്റ് റോ എൻഡ്-ഓഫ്-കോൾ റിപ്പോർട്ടാണ്, കൂടാതെ മുകളിലെ പട്ടികയ്ക്കപ്പുറമുള്ള അധിക ആന്തരിക ഫീൽഡുകൾ ഉൾപ്പെട്ടേക്കാം — അജ്ഞാത ഫീൽഡുകളെ വിവരദായകമായി കണക്കാക്കുക.
  • വെബ് കോളുകൾ (direction: "web") from_number / to_number ഒഴിവാക്കുകയും origin_domain ചേർക്കുകയും ചെയ്യുന്നു.
  • ബിൽഡർ മൈക്ക് ടെസ്റ്റ് കോളുകൾ ലെഗസി പാതയിൽ telephony.complete ആയി റിപ്പോർട്ട് ചെയ്യപ്പെടുന്നു (എൻഡ്‌പോയിന്റ് സിസ്റ്റം അവയെ web.complete-ലേക്ക് മാപ്പ് ചെയ്യുന്നു).
  • ട്രാൻസ്ഫർ ഏകോപനം: ഒരു കോൾ ട്രാൻസ്ഫറിൽ അവസാനിക്കുമ്പോൾ, ലെഗസി വെബ്ഹുക്ക് സിൻക്രണസായി വിളിക്കപ്പെടുകയും, കൈമാറ്റ ലക്ഷ്യം സജ്ജമല്ലെന്ന് സൂചിപ്പിക്കാൻ {"transfer_ready": false} മറുപടി നൽകുകയും ചെയ്യാം. മറ്റേതെങ്കിലും പ്രതികരണം (അല്ലെങ്കിൽ ലെഗസി വെബ്ഹുക്ക് ഇല്ലെങ്കിൽ) ട്രാൻസ്ഫർ തുടരാൻ അനുവദിക്കുന്നു. ഇതിനായി എൻഡ്‌പോയിന്റ് ഡെലിവറികൾ ഒരിക്കലും പരിശോധിക്കില്ല.

ഉദാഹരണ ഹാൻഡ്‌ലർ

Python (FastAPI)
import hashlib
import hmac
import json
import os
 
from fastapi import FastAPI, HTTPException, Request
 
app = FastAPI()
SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
 
def verify(body: bytes, signature: str) -> bool:
    expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature or "")
 
@app.post("/thunderphone-webhook")
async def webhook(request: Request):
    body = await request.body()
    if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")):
        raise HTTPException(status_code=401)
 
    event = json.loads(body)
    if event["type"] in ("telephony.complete", "web.complete"):
        data = event["data"]
        # Endpoint deliveries use "transcripts"; the legacy webhook uses "history".
        turns = data.get("transcripts") or data.get("history") or []
        await persist_call_record(
            call_id=data["call_id"],
            turns=turns,
            recording_url=data.get("recording_url"),
        )
        if data["end_reason"] in ("ai_transfer", "ai_warm_transfer"):
            await notify_team(data.get("transfer_number"), data["call_id"])
    return {"ok": True}
Node.js (Express)
import crypto from "node:crypto";
import express from "express";
 
const app = express();
const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET;
 
function verify(body, signature) {
  const expected = crypto.createHmac("sha256", SECRET).update(body).digest("hex");
  return signature &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
 
app.post(
  "/thunderphone-webhook",
  express.raw({ type: "application/json" }),
  async (req, res) => {
    if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
      return res.sendStatus(401);
    }
    const event = JSON.parse(req.body.toString("utf8"));
    if (["telephony.complete", "web.complete"].includes(event.type)) {
      const data = event.data;
      // Endpoint deliveries use "transcripts"; the legacy webhook uses "history".
      const turns = data.transcripts ?? data.history ?? [];
      await persistCallRecord({ ...data, turns });
      if (["ai_transfer", "ai_warm_transfer"].includes(data.end_reason)) {
        await notifyTeam(data.transfer_number, data.call_id);
      }
    }
    res.json({ ok: true });
  },
);

സാധാരണ ഉപയോഗ സാഹചര്യങ്ങൾ

CRM സംയോജനം

ഓരോ കോളിന്റെയും ട്രാൻസ്ക്രിപ്റ്റും റെക്കോർഡിംഗ് URL-ഉം നിങ്ങളുടെ ഉപഭോക്തൃ റെക്കോർഡുകൾക്കൊപ്പം സൂക്ഷിക്കുക.

അനലിറ്റിക്സ്

വിഷയ മോഡലിംഗ്, CSAT സിഗ്നൽ എക്സ്ട്രാക്ഷൻ, അല്ലെങ്കിൽ ട്രാൻസ്ഫർ നിരക്ക് നിരീക്ഷണം എന്നിവയ്ക്കായി ട്രാൻസ്ക്രിപ്റ്റുകൾ ഒരു പൈപ്പ്‌ലൈനിലേക്ക് സ്ട്രീം ചെയ്യുക.

ഗുണനിലവാര അവലോകനം

മാനുഷിക അവലോകനത്തിനായി കോളുകൾ ഒരു QA ടൂളിൽ തുറക്കുക, അല്ലെങ്കിൽ അവയെ നിങ്ങളുടെ സ്വന്തം മൂല്യനിർണയ മോഡലിലൂടെ പ്രവർത്തിപ്പിക്കുക.

അറിയിപ്പുകൾ

ട്രാൻസ്ഫർ / പരാജയം സംഭവിക്കുമ്പോൾ ഒരു മാനുഷിക ടീമംഗത്തെ അറിയിക്കുക.


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