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

Webhooks

telephony.incoming / web.incoming

ഇൻബൗണ്ട് കോളിന്റെ കോൺഫിഗറേഷൻ തത്സമയം രൂപപ്പെടുത്തുന്ന ബ്ലോക്കിംഗ് വെബ്ഹുക്ക്.

ഒരു ഇൻബൗണ്ട് ഫോൺ കോൾ നിയോഗിച്ച ഏജന്റില്ലാത്ത ഒരു നമ്പറിലെത്തുമ്പോൾ (കോൾബാക്കുകൾ കാണുക, നിങ്ങളുടെ ഔട്ട്ബൗണ്ട് കോളുകളിലേക്ക് തിരികെ വിളിക്കുന്ന വിളിക്കാർക്കായി), അല്ലെങ്കിൽ ഒരു വെബ് വിഡ്ജറ്റ് സെഷൻ പ്രസിദ്ധീകരിക്കാവുന്ന കീയിലൂടെ mode="webhook"-ൽ ആരംഭിക്കുമ്പോൾ, ThunderPhone ഒരു തടയുന്ന telephony.incoming / web.incoming അഭ്യർത്ഥന നിങ്ങളുടെ ലെഗസി webhook URL-ലേക്ക് അയയ്ക്കുകയും ഒരു കോൺഫിഗറേഷൻ പ്രതികരണത്തിനായി കാത്തിരിക്കുകയും ചെയ്യുന്നു: ഫോൺ കോളിന് 13 സെക്കൻഡ് വരെ, ഒരു റീട്രൈ ഉൾപ്പെടെ, വിഡ്ജറ്റ് സെഷന് 10 സെക്കൻഡ് വരെ (ടൈംഔട്ടുകളും റീട്രൈകളും കാണുക). ഓരോ കോളിനും prompt, വോയ്സ്, ടൂളുകൾ എന്നിവ ഡൈനാമിക്കായി തിരഞ്ഞെടുക്കാൻ ഈ കൈമാറ്റം ഉപയോഗിക്കുക — എൻഡ്-ടു-എൻഡ് മാതൃകയ്ക്കായി ഡൈനാമിക് കോൾ കോൺഫിഗറേഷൻ ഗൈഡ് കാണുക.

അസൈൻ ചെയ്ത ഏജന്റ് ഉള്ള ഒരു നമ്പർ ആ ഏജന്റിലൂടെ മറുപടി നൽകുന്നു. ഏജന്റിന് സ്വന്തം കോൾ സജ്ജീകരണ webhook ഉണ്ടെങ്കിൽ, ഏജന്റിന്റെ വേരിയബിളുകളും കോളിന്റെ സന്ദർഭവും പൂരിപ്പിക്കാൻ അതേ ബ്ലോക്കിംഗ് കൈമാറ്റം ആദ്യം ഏജന്റിന്റെ URL-ൽ നടക്കും.

സമയപരിധികളും പുനർശ്രമങ്ങളും

വേഗത്തിൽ മറുപടി നൽകുക: നിങ്ങൾ തീരുമാനിക്കുന്നതിനിടെ വിളിക്കുന്നയാൾ ലൈനിൽ കാത്തിരിക്കുന്നു.

ഒരു ഫോൺ കോളിന് (telephony.incoming):

  • ആദ്യ ശ്രമത്തിന് 10 സെക്കൻഡ് വരെ എടുക്കാം.
  • സമയപരിധി കഴിഞ്ഞാലോ, ബന്ധിപ്പിക്കാൻ കഴിയാതിരുന്നാലോ, അല്ലെങ്കിൽ 5xx, 408 അല്ലെങ്കിൽ 429 പ്രതികരണം ലഭിച്ചാലോ, ThunderPhone ഒരിക്കൽക്കൂടി ശ്രമിക്കും. മുഴുവൻ ഇടപാടിനുള്ള 13-സെക്കൻഡ് ബജറ്റിൽ ശേഷിക്കുന്ന സമയം പുനർശ്രമത്തിന് ലഭിക്കും: സമയപരിധി കഴിഞ്ഞ ആദ്യ ശ്രമത്തിന് ശേഷം ഏകദേശം 3 സെക്കൻഡ്, വേഗത്തിലുള്ള പരാജയത്തിന് ശേഷം ഏതാണ്ട് മുഴുവൻ 13 സെക്കൻഡും. 2 സെക്കൻഡിൽ കുറവാണ് ശേഷിക്കുന്നതെങ്കിൽ പുനർശ്രമമുണ്ടാകില്ല.
  • മറ്റേതെങ്കിലും 4xx പ്രതികരണം, വലുപ്പ പരിധിക്ക് മുകളിലുള്ള പ്രതികരണം, അല്ലെങ്കിൽ ബോഡി സാധുവായ കോൺഫിഗറേഷൻ അല്ലാത്ത 2xx പ്രതികരണം എന്നിവ അന്തിമമാണ്; അവ വീണ്ടും ശ്രമിക്കില്ല.
  • രണ്ട് ശ്രമങ്ങളും ഒരേ ബോഡിയും ഒരേ X-ThunderPhone-Signature-ഉം ഒരേ X-ThunderPhone-Idempotency-Key ഹെഡറും (telephony-incoming-<call_id>) അയയ്ക്കും; അതിനാൽ പാർശ്വഫലങ്ങളുള്ള ഒരു ഹാൻഡ്‌ലറിന് പുനർശ്രമം തിരിച്ചറിയാനാകും.

ഉപയോഗിക്കാവുന്ന കോൺഫിഗറേഷൻ ലഭിക്കാത്ത പക്ഷം, വിളിക്കുന്നയാളെ നിശ്ശബ്ദ ലൈനിൽ കാത്തിരിപ്പിക്കുന്നതിന് പകരം കോൾ ഉടൻ അവസാനിപ്പിക്കും. കോൾ ചരിത്രത്തിൽ ഇത് end_reason inbound_config_webhook_failed ഉള്ള, പരാജയപ്പെട്ടതും ബിൽ ഈടാക്കാത്തതുമായ കോളായി കാണപ്പെടും; സാധാരണ telephony.complete ഇവന്റും അയയ്ക്കപ്പെടും. ഡാഷ്ബോർഡിലെ കോളിന്റെ പേജും GET /v1/calls/{call_id}-ലെ config_webhook_failure-ഉം നിങ്ങളുടെ വെബ്ഹുക്കിൽ എന്ത് സംഭവിച്ചുവെന്ന് വ്യക്തമാക്കുന്നു: {kind, attempts, http_status, host, source}, ഇവിടെ kind എന്നത് http_error, timeout, connection, dns, tls, response_too_large, blocked_url, other, invalid_json, non_object_json അല്ലെങ്കിൽ invalid_config ആണ്; host നിങ്ങളുടെ വെബ്ഹുക്കിന്റെ ഹോസ്റ്റ് നാമമാണ്, source എന്നത് number (ഈ വെബ്ഹുക്ക്) അല്ലെങ്കിൽ agent_setup (ഒരു ഏജന്റിന്റെ കോൾ സജ്ജീകരണ വെബ്ഹുക്ക്) ആണ്. invalid_config-നായി, മറുപടി എന്തുകൊണ്ട് ഉപയോഗിക്കാനായില്ലെന്ന് reason വ്യക്തമാക്കുകയും അത് സംബന്ധിച്ച ഫീൽഡുകളുടെ പേരുകൾ fields നൽകുകയും ചെയ്യുന്നു: no_agent (agent_id-ഉം prompt-ഉം ഇല്ല; തെറ്റായി എഴുതിയ agentId പോലുള്ള, അവഗണിച്ച കീകൾ fields പട്ടികപ്പെടുത്തുന്നു), agent_not_found, agent_id_not_integer, unexpected_fields (agent_id-നൊപ്പം variables, context, timezone, language എന്നിവയല്ലാത്ത കീകൾ), invalid_variables, invalid_context, invalid_language, unsupported_language, invalid_config_fields അല്ലെങ്കിൽ agent_settings_invalid. മറ്റെല്ലാ സാഹചര്യങ്ങളിലും reason null ആയിരിക്കും, fields ശൂന്യമായിരിക്കും. ഒരേയൊരു ഒഴിവ്, വിനിമയം തന്നെ പരാജയപ്പെട്ടപ്പോൾ വിളിക്കുന്നയാൾ നിങ്ങളുടെ ഔട്ട്‌ബൗണ്ട് കോളുകളിലൊന്നിലേക്ക് തിരികെ വിളിക്കുന്ന സാഹചര്യമാണ്: കോൾബാക്കുകൾ കാണുക.

ഒരു വിഡ്ജറ്റ് സെഷന് (web.incoming) പരമാവധി 10 സെക്കൻഡ് ദൈർഘ്യമുള്ള ഒരൊറ്റ ശ്രമം ലഭിക്കും. അത് പരാജയപ്പെട്ടാൽ, സെഷൻ അഭ്യർത്ഥന 502 അല്ലെങ്കിൽ 422 ഉപയോഗിച്ച് പരാജയപ്പെടും.

അഭ്യർത്ഥന പേലോഡ്

ഫോൺ കോളുകൾക്കായി (telephony.incoming):

{
  "type": "telephony.incoming",
  "data": {
    "call_id":     987654321,
    "from_number": "+14155550199",
    "to_number":   "+15551234567"
  }
}
ഫീൽഡ്തരംവിവരണം
call_idപൂർണസംഖ്യകോൾ ID — ഈ കോളിനായുള്ള എല്ലാ ഇവന്റുകളിലും സ്ഥിരതയുള്ളത്
from_numberസ്ട്രിംഗ്E.164 വിളിക്കുന്നയാളുടെ നമ്പർ
to_numberസ്ട്രിംഗ്E.164 ലക്ഷ്യസ്ഥാനം (നിങ്ങളുടെ ThunderPhone നമ്പറുകളിൽ ഒന്ന്)
returning_callഒബ്ജക്റ്റ്കഴിഞ്ഞ 30 ദിവസത്തിനുള്ളിൽ ഈ നമ്പർ വിളിക്കുന്നയാളെ വിളിച്ചപ്പോൾ മാത്രം ലഭ്യമാകും. കോൾബാക്കുകൾ കാണുക
sip_headersഒബ്ജക്റ്റ്മാനുവലായി കോൺഫിഗർ ചെയ്ത SIP കണക്ഷനിൽ X-* അല്ലെങ്കിൽ User-to-User SIP ഹെഡറുകളോടെ കോൾ എത്തിയപ്പോൾ മാത്രം ലഭ്യമാകും: ചെറിയക്ഷരങ്ങളിലുള്ള ഹെഡർ നാമം → മൂല്യം. SIP ഹെഡറുകൾ കാണുക

വെബ് വിഡ്ജറ്റ് സെഷനുകൾക്കായി (web.incoming), data ഫോൺ നമ്പറുകൾക്കുപകരം എംബെഡ് ചെയ്ത പേജിനെ തിരിച്ചറിയുന്നു:

{
  "type": "web.incoming",
  "data": {
    "call_id": 987654322,
    "origin_domain": "https://example.com",
    "publishable_key_prefix": "pk_live_a1b2"
  }
}
ഫീൽഡ്തരംവിവരണം
call_idപൂർണസംഖ്യകോൾ ഐഡി
origin_domainസ്ട്രിംഗ്ബ്രൗസർ അയച്ചതുപോലെ, വിജറ്റ് ഹോസ്റ്റ് ചെയ്യുന്ന പേജിന്റെ ഉത്ഭവസ്ഥാനം. ബ്രൗസർ അല്ലാത്ത ക്ലയന്റിന് ഏത് മൂല്യവും അയയ്ക്കാൻ കഴിയും, അതിനാൽ അഭ്യർത്ഥന എവിടെനിന്നാണ് വന്നതെന്നതിനുള്ള തെളിവായി ഇതിനെ കണക്കാക്കരുത്
publishable_key_prefixസ്ട്രിംഗ്സെഷൻ തുറന്ന പബ്ലിഷബിൾ കീയുടെ ആദ്യ അക്ഷരങ്ങൾ
language, primary_languageസ്ട്രിംഗ്വിജറ്റ് സെഷൻ ഭാഷാ ഓവർറൈഡ് അഭ്യർത്ഥിച്ചപ്പോൾ ഉണ്ടായിരിക്കും
voiceസ്ട്രിംഗ്വിജറ്റ് സെഷൻ വോയ്‌സ് ഓവർറൈഡ് അഭ്യർത്ഥിച്ചപ്പോൾ ഉണ്ടായിരിക്കും
website_contextസ്ട്രിംഗ്വിജറ്റ് ഓരോ സെഷനുമുള്ള പേജ് സന്ദർഭം കൈമാറിയപ്പോൾ ഉണ്ടായിരിക്കും

ഓവർറൈഡ് ഫീൽഡുകൾ (language, voice, website_context, കൂടാതെ ഏതെങ്കിലും ബ്രൗസർ variables) പബ്ലിഷബിൾ കീ അതിന്റെ ബ്രൗസർ ഓവർറൈഡുകളിൽ അവ അനുവദിക്കുമ്പോൾ മാത്രമേ എത്തുകയുള്ളു. കീ അനുവദിക്കാത്ത ഒന്ന് ഉൾക്കൊള്ളുന്ന സെഷൻ അഭ്യർത്ഥന ഈ വെബ്ഹുക്ക് വിളിക്കപ്പെടുന്നതിന് മുമ്പ് നിരസിക്കപ്പെടും.


പ്രതികരണ സ്കീമ

ഈ കോളിനായുള്ള ഏജന്റ് കോൺഫിഗറേഷൻ വിവരിക്കുന്ന ഒരു JSON ഒബ്‌ജക്റ്റ് നൽകുക. prompt, voice എന്നിവ നിർബന്ധമാണ്; മറ്റെല്ലാം ഓപ്ഷണലാണ്.

{
  "prompt":  "You are a helpful booking assistant for Acme Restaurant.",
  "voice":   "john",
  "product": "spark",
  "background_track": null,
  "tools":   []
}
ഫീൽഡ്തരംആവശ്യമാണ്വിവരണം
promptസ്ട്രിംഗ്അതെഏജന്റിനെ നയിക്കുന്ന സിസ്റ്റം prompt
voiceസ്ട്രിംഗ്അതെGET /v1/voices-ൽ നിന്നുള്ള വോയ്‌സ് ഐഡി, ഉദാ. john. voice_name ഒരു അപരനാമമായി സ്വീകരിക്കും. അജ്ഞാത വോയ്‌സുകൾ പരിശോധനയിൽ പരാജയപ്പെടുകയും കോൾ നിരസിക്കുകയും ചെയ്യും
productസ്ട്രിംഗ്ഇല്ലbolt അയയ്ക്കുക. സ്ഥിരസ്ഥിതി spark ആണ്; storm-base, storm-base-with-ack, storm-extra, storm-extra-with-ack എന്നിവയ്‌ക്കൊപ്പം ഇപ്പോഴും സ്വീകരിക്കുന്ന പഴയ മൂല്യമാണിത്
thinking_levelസ്ട്രിംഗ്ഇല്ലminimal, base (സ്ഥിരസ്ഥിതി), അല്ലെങ്കിൽ extra. പഴയ storm-* ഉൽപ്പന്ന മൂല്യങ്ങളിൽ, storm-extra* extra നിർബന്ധമാക്കുകയും മറ്റ് storm-* മൂല്യങ്ങൾ base നിർബന്ധമാക്കുകയും ചെയ്യുന്നു
audio_context_modeസ്ട്രിംഗ്ഇല്ലfull (സ്ഥിരസ്ഥിതി) അല്ലെങ്കിൽ reduced
watchdog_enabledബൂളിയൻഇല്ലഈ കോളിനായി മേൽനോട്ടം പ്രവർത്തനക്ഷമമാക്കുക. സ്ഥിരസ്ഥിതി false
additional_audio_contextബൂളിയൻ | nullഇല്ലഏറ്റവും പുതിയ ടേൺ മാത്രം ഉൾപ്പെടുത്തുന്നതിന് പകരം വിളിക്കുന്നയാളുടെ ഓഡിയോയിലെ അവസാന ഏതാനും ടേണുകൾ ഉൾപ്പെടുത്തുക. ചെറിയ ലേറ്റൻസി/ചെലവ് വർധനവോടെ ഇത് തിരുത്തലുകളും അക്ഷരവിന്യാസം/നമ്പർ കൂടുതലുള്ള ഡാറ്റ ശേഖരണവും മെച്ചപ്പെടുത്തുന്നു. ഇൻബൗണ്ട് സെഷനുകളിൽ സ്ഥിരസ്ഥിതിയായി ഓണും ഔട്ട്ബൗണ്ട് ഫോൺ കോളുകളിൽ ഓഫും ആണ്; null സ്ഥിരസ്ഥിതി നിലനിർത്തും
storm_feedback_modeസ്ട്രിംഗ്ഇല്ലaudio_tier plus അല്ലെങ്കിൽ max ആയിരിക്കുമ്പോൾ മന്ദഗതിയിലുള്ള മറുപടി തയ്യാറാക്കുന്നതിനിടെ വിളിക്കുന്നയാൾ കേൾക്കുന്നത്: none, acknowledgement (സ്ഥിരസ്ഥിതി), അല്ലെങ്കിൽ tick
languageസ്ട്രിംഗ്ഇല്ലprimary_language-നുള്ള ചുരുക്കരൂപം. agent_id-നൊപ്പം അനുവദനീയമാണ്; അപ്പോൾ ഈ കോൾ ആരംഭിക്കുന്ന ഭാഷയാണിത്, അതിനായുള്ള ഏജന്റിന്റെ വോയ്‌സിൽ സംസാരിക്കും; ഓരോ കോളിനും ഭാഷ സജ്ജമാക്കുക കാണുക
primary_languageസ്ട്രിംഗ്ഇല്ലസാധാരണവത്കരിച്ച ഭാഷാ കോഡ് (സ്ഥിരസ്ഥിതി en). പരിഹരിക്കാൻ കഴിയാത്ത കോഡുകൾ കോൾ നിരസിക്കും
has_additional_languagesബൂളിയൻഇല്ലസ്ഥിരസ്ഥിതി false
additional_languagesസ്ട്രിംഗിന്റെ അറേഇല്ലഏജന്റിന് മാറാവുന്ന അധിക ഭാഷകൾ
native_voice_switchingബൂളിയൻഇല്ലസ്ഥിരസ്ഥിതി false. കോൾ മറ്റൊരു ഭാഷയിലേക്ക് മാറുമ്പോൾ ക്രമീകരിച്ച വോയ്‌സ് നിലനിർത്തുന്നതിന് പകരം ആ ഭാഷയുടെ നേറ്റീവ് വോയ്‌സിലേക്ക് മാറുക (ലിംഗം അനുസരിച്ച് പൊരുത്തപ്പെടുത്തിയത്)
language_switchingസ്ട്രിംഗ് | nullഇല്ലask_first (സ്ഥിരസ്ഥിതി) അല്ലെങ്കിൽ follow_caller; null എന്നത് ask_first-ന് തുല്യമാണ്. ബഹുഭാഷാ ഏജന്റ് അതിന്റെ മറ്റൊരു ഭാഷയിൽ മറ്റേയാൾ സംസാരിക്കുന്നത് എങ്ങനെ കൈകാര്യം ചെയ്യുന്നു എന്നത്. അവർ ഭാഷ ആവശ്യപ്പെടുമ്പോഴോ അതിൽ ഒരു പൂർണ വാചകം പറയുമ്പോഴോ ask_first ഉടൻ മാറും; "sí" പോലുള്ള ഹ്രസ്വമായ എന്തെങ്കിലും പറഞ്ഞാൽ അതിൽ തുടരണമോയെന്ന് ചോദിക്കും. ഒരൊറ്റ വാക്കായാലും അവർ സംസാരിക്കുന്ന ക്രമീകരിച്ച ഏത് ഭാഷയിലേക്കും follow_caller മാറും. additional_languages സജ്ജമാക്കിയിരിക്കുമ്പോൾ മാത്രം ബാധകം
audio_tierസ്ട്രിംഗ് | nullഇല്ലproduct: "bolt"-ന് മാത്രം. ശ്രവണം: ഏജന്റ് വിളിക്കുന്നയാളെ എത്ര ശ്രദ്ധയോടെ കേൾക്കുന്നു. മിക്ക കോളുകൾക്കും standard (സ്ഥിരസ്ഥിതി; "", null എന്നിവ ഒരേ അർഥം) അനുയോജ്യമാണ് (PHI പ്രോസസ്സ് ചെയ്യുന്ന കോളുകൾ BAA പരിരക്ഷയുള്ള ദാതാക്കളെ മാത്രം ഉപയോഗിക്കുന്നു). lite ഏറ്റവും ചെലവുകുറഞ്ഞതും കൂടുതൽ തവണ തെറ്റിക്കേൾക്കുന്നതുമാണ്. ബുദ്ധിമുട്ടുള്ള ടേണുകളിൽ plus കൂടുതൽ ശ്രദ്ധിച്ച് കേൾക്കും; അവയ്ക്ക് ഏകദേശം 1–2 സെക്കൻഡ് അധികം എടുക്കും. ഏറ്റവും ബുദ്ധിമുട്ടുള്ള ഓഡിയോയ്ക്കും അപൂർവ ഭാഷകൾക്കുമുള്ളതാണ് max; ഓരോ മറുപടിക്കും 3–4 സെക്കൻഡ് എടുക്കും, കോൾ pro ഇന്റലിജൻസ് പ്രവർത്തിപ്പിക്കും (intelligence അവഗണിക്കും). max പൊതുവായി ലഭ്യമല്ല: പ്രവർത്തനക്ഷമമാക്കാത്ത ഒരു ഓർഗനൈസേഷനായി, കോൾ plus-ഉം നിങ്ങൾ വ്യക്തമാക്കുന്ന intelligence-ഉം പ്രവർത്തിപ്പിക്കും (ഇതോടുകൂടിയ ഔട്ട്ബൗണ്ട് കോൾ അഭ്യർഥന 400 ഉപയോഗിച്ച് നിരസിക്കും). പഴയ മൂല്യങ്ങളായ lean (ലൈറ്റ്), hearing (പ്ലസ്), deep_hearing (മാക്സ്) എന്നിവ ഇപ്പോഴും സ്വീകരിക്കും. മറ്റ് ഉൽപ്പന്നങ്ങൾ ഇത് അവഗണിക്കും
endpointingസ്ട്രിംഗ് | nullഇല്ലfaster (200 ms), fast (300 ms), normal (500 ms, സ്ഥിരസ്ഥിതി), അല്ലെങ്കിൽ patient (800 ms); null എന്നത് normal-ന് തുല്യമാണ്. വിളിക്കുന്നയാൾ നിർത്തിയശേഷം മറുപടി ആവശ്യപ്പെടാൻ മോഡലിനോട് ചോദിക്കുന്നതിന് മുമ്പ് Bolt v2 ഏജന്റ് എത്ര സമയം കാത്തിരിക്കും എന്നത്. കുറഞ്ഞ കാത്തിരിപ്പുകൾക്ക് വേഗത്തിൽ മറുപടി നൽകാനാകും, എന്നാൽ വിളിക്കുന്നയാളുടെ അടുത്ത വാക്കുകൾ കാലഹരണപ്പെടുത്തുന്ന കൂടുതൽ അഭ്യർഥനകൾ അയയ്ക്കും; ഇത് മോഡൽ ചെലവ് വർധിപ്പിക്കും. മറ്റ് ഉൽപ്പന്നങ്ങൾ ഇത് അവഗണിക്കും
eagernessസ്ട്രിംഗ് | nullഇല്ലഒഴിവാക്കിയിരിക്കുന്നു: October 19, 2026 വരെ endpointing-ന്റെ പേരായിരുന്നു ഇത്, ഇപ്പോഴും വായിക്കും. endpointing സജ്ജമാക്കിയിരിക്കുമ്പോൾ അവഗണിക്കും
intelligenceസ്ട്രിംഗ് | nullഇല്ലcore അല്ലെങ്കിൽ pro (സ്ഥിരസ്ഥിതി); null എന്നത് pro-ന് തുല്യമാണ്. Bolt v2 പൈപ്പ്‌ലൈനിലുള്ള bolt ഏജന്റ് അതിന്റെ നിർദേശങ്ങൾ എത്ര വിശ്വസനീയമായി പിന്തുടരുന്നു എന്നത്. core-ൽ ആദ്യ വാക്കിന് ഏകദേശം 700 ms എടുക്കും, ഏറ്റവും ചെലവുകുറഞ്ഞതും അല്പം കുറവ് വിശ്വസനീയവുമാണ് (PHI ആയി പരിഗണിക്കുന്ന കോളുകളിൽ ഏകദേശം 900 ms എടുക്കുകയും വിശ്വസനീയത കുറയുകയും ചെയ്യും); pro-ക്ക് ഏകദേശം 900 ms എടുക്കും; ഒരു ടൂൾ മാത്രം വിളിക്കുന്ന കോർ മറുപടികൾ പ്രോയിലേക്ക് കൈമാറും. പഴയ മൂല്യങ്ങളായ lite (കോർ), standard (പ്രോ) എന്നിവ ഇപ്പോഴും സ്വീകരിക്കും; ഒഴിവാക്കിയ plus, max എന്നിവ pro-ൽ പ്രവർത്തിക്കും. audio_tier max ആയിരിക്കുമ്പോൾ അവഗണിക്കും. മറ്റ് ഉൽപ്പന്നങ്ങൾ ഇത് അവഗണിക്കും
faster_repliesബൂളിയൻ | nullഇല്ലവേഗവർധന. സ്ഥിരസ്ഥിതി true. Bolt v2 പൈപ്പ്‌ലൈനിലെ bolt ഏജന്റിൽ, അല്പം കൂടുതൽ ചെലവിൽ മറുപടികൾ കുറച്ച് നേരത്തെ ആരംഭിക്കും. false അത് ഓഫാക്കും. മറ്റ് ഉൽപ്പന്നങ്ങൾ ഇത് അവഗണിക്കും
background_trackസ്ട്രിംഗ് | nullഇല്ലആംബിയന്റ് ഓഡിയോ ഐഡി അല്ലെങ്കിൽ null
acknowledgement_prompt_modeസ്ട്രിംഗ്ഇല്ലauto (സ്ഥിരസ്ഥിതി) അല്ലെങ്കിൽ manual (പഴയ -with-ack ഉൽപ്പന്ന മൂല്യങ്ങൾ)
acknowledgement_promptസ്ട്രിംഗ്ഇല്ലacknowledgement_prompt_mode="manual" ആയിരിക്കുമ്പോൾ ഉപയോഗിക്കുന്നു
silence_interval_secondsഇന്റിജർ | nullഇല്ല5–120. പരിശോധനാ സന്ദേശത്തിന് മുമ്പുള്ള വിളിക്കുന്നയാളുടെ നിശ്ശബ്ദതയുടെ സെക്കൻഡുകൾ
silence_max_checkinsഇന്റിജർ | nullഇല്ല1–10
silence_checkins_enabledബൂളിയൻഇല്ലസ്ഥിരസ്ഥിതി true
silence_final_actionസ്ട്രിംഗ്ഇല്ലഅവസാന പരിശോധനാ സന്ദേശത്തിനുശേഷം: hang_up (സ്ഥിരസ്ഥിതി) അല്ലെങ്കിൽ silence_transfer_destination-ലേക്ക് transfer
silence_transfer_destinationസ്ട്രിംഗ്ഇല്ലഈ കോൺഫിഗിലെ transfer_destinations-ലുള്ള ഒരു എൻട്രിയുടെ പേര്; transfer-നൊപ്പം ആവശ്യമാണ്. transfer_destinations ഇല്ലാതെ ട്രാൻസ്ഫർ ചെയ്യാനാകില്ല, ഏജന്റ് കോൾ അവസാനിപ്പിക്കും
silence_final_messageസ്ട്രിംഗ്ഇല്ല≤ 300 അക്ഷരങ്ങൾ, എഴുതിയതുപോലെ വായിക്കും; "" (സ്ഥിരസ്ഥിതി) സ്ഥിരസ്ഥിതി വരി ഉപയോഗിക്കും
connect_tone_enabledബൂളിയൻഇല്ലസ്ഥിരസ്ഥിതി false
pronunciation_dictsബൂളിയൻ | nullഇല്ലസ്ഥിരസ്ഥിതി false; null എന്നത് false-ന് തുല്യമാണ്. true ആയിരിക്കുമ്പോൾ, ലഭ്യമായിടത്ത് കോളിന്റെ ഭാഷയ്ക്കായുള്ള ThunderPhone-ന്റെ ഉച്ചാരണ നിഘണ്ടു കോളിന്റെ Cartesia സംഭാഷണം ഉപയോഗിക്കും. ഫോൺ, വിജറ്റ് കോളുകൾക്ക് പ്രവർത്തിക്കും. നിങ്ങളുടെ സ്വന്തം Cartesia API കീയിലെ വോയ്‌സുകൾക്കല്ല, ThunderPhone-ന്റെ സ്വന്തം Cartesia വോയ്‌സുകൾക്ക് മാത്രം ബാധകമാണ്. സംരക്ഷിച്ച ഏജന്റിന്റെ ക്രമീകരണങ്ങൾ ബാധകമായ agent_id-നൊപ്പം ഉപയോഗിക്കില്ല
wordsഅറേ | nullഇല്ലഏജന്റ് നിർദിഷ്ട വാക്കുകൾ എങ്ങനെ ഉച്ചരിക്കുന്നു എന്നത്; support ഇല്ലാത്ത ഏജന്റിന്റെ words-ലുള്ള അതേ എൻട്രികൾ. language ഇല്ലാത്ത ഒരു എൻട്രി ഈ കോൺഫിഗിന്റെ ഭാഷ സ്വീകരിക്കും. null, [] എന്നിവ ഒന്നുമില്ല എന്നാണ് അർഥം. സംരക്ഷിച്ച ഏജന്റിന്റെ വാക്കുകൾ ബാധകമായ agent_id-നൊപ്പം ഉപയോഗിക്കില്ല
voicemail_actionസ്ട്രിംഗ്ഇല്ലprompt (സ്ഥിരസ്ഥിതി), hangup, അല്ലെങ്കിൽ message
voicemail_messageസ്ട്രിംഗ്ഇല്ലvoicemail_action="message" ആയിരിക്കുമ്പോൾ ഉപയോഗിക്കുന്നു
agent_nameസ്ട്രിംഗ്ഇല്ലഡാഷ്ബോർഡുകളിലും വിജറ്റിലും റിപ്പോർട്ട് ചെയ്യുന്ന പ്രദർശന നാമം
org_nameസ്ട്രിംഗ്ഇല്ലഏജന്റിന്റെ വ്യക്തിത്വത്തിനുള്ള ഓർഗനൈസേഷൻ പ്രദർശന നാമം
toolsഅറേഇല്ലഇൻലൈൻ ഫംഗ്ഷൻ-ടൂൾ സ്കീമകൾ (ഫംഗ്ഷൻ ടൂളുകൾ കാണുക)
transfer_destinationsഒബ്ജക്റ്റിന്റെ അറേ | nullഇല്ലഈ കോളിന് ട്രാൻസ്ഫർ ചെയ്യാവുന്ന പരമാവധി 50 {name, number} എൻട്രികൾ; ഏജന്റിന്റെ ട്രാൻസ്ഫർ നമ്പറുകൾ പോലെ സാധൂകരിക്കുന്നു. ഏജന്റ് പേരുപയോഗിച്ചും ഇവയിലേക്ക് മാത്രവും ട്രാൻസ്ഫർ ചെയ്യും; [] എന്നാൽ ട്രാൻസ്ഫറുകളില്ല. ഏജന്റ് തിരഞ്ഞെടുക്കുന്ന ഒരു നമ്പറിലേക്ക് ട്രാൻസ്ഫർ ചെയ്യാൻ ഇത് ഒഴിവാക്കുക അല്ലെങ്കിൽ null അയയ്ക്കുക
timezoneസ്ട്രിംഗ്ഇല്ലഈ കോളിനുള്ള IANA സമയ മേഖല, ഉദാഹരണത്തിന് America/Chicago. ഏജന്റിന്റെ സ്വന്തം സമയ മേഖലയെക്കാൾ മുൻഗണന നൽകി ഏജന്റ് അതിലെ തീയതിയും സമയവും പറയും. agent_id-നൊപ്പം അനുവദനീയമാണ്. IANA മേഖലകളല്ലാത്ത മൂല്യങ്ങൾ അവഗണിക്കും. ഓരോ കോളിനും സമയ മേഖല സജ്ജമാക്കുക കാണുക
contextസ്ട്രിംഗ് | nullഇല്ലനിങ്ങളുടെ സിസ്റ്റം ശേഖരിച്ച കുറിപ്പുകൾ പോലുള്ള, ഈ കോളിനായുള്ള സ്വതന്ത്രരൂപ വാചകം, പരമാവധി 20,000 അക്ഷരങ്ങൾ. prompt-ന് ശേഷം ഒരു വേർതിരിച്ച ബ്ലോക്കിൽ ചേർക്കും; ടെംപ്ലേറ്റായി റെൻഡർ ചെയ്യില്ല. agent_id-നൊപ്പം അനുവദനീയമാണ്. സ്ട്രിംഗ് അല്ലാത്തതോ കൂടുതൽ നീളമുള്ളതോ ആയ മൂല്യം കോൾ നിരസിക്കും. കോൾ വേരിയബിളുകളും കോൺടെക്സ്റ്റും കാണുക
call_idഇന്റിജർഇല്ലഅഭ്യർഥനയുടെ കോൾ ഐഡിയുടെ ഐച്ഛിക എക്കോ; അവഗണിക്കും

prompt, voice എന്നിവ ആവശ്യമായതിനാൽ, {} അല്ലെങ്കിൽ പരിശോധനയിൽ പരാജയപ്പെടുന്ന ഏതെങ്കിലും പ്രതികരണം മടക്കിനൽകുന്നത് കോൾ നിരസിക്കും: കാലഹരണങ്ങളും വീണ്ടും ശ്രമിക്കലുകളും എന്നതിൽ വിവരിച്ചിരിക്കുന്നതുപോലെ ഒരു ഫോൺ കോൾ അവസാനിപ്പിക്കും, കൂടാതെ ഒരു വിഡ്ജറ്റ് സെഷൻ അഭ്യർത്ഥന 422 ഉപയോഗിച്ച് പരാജയപ്പെടും. മടങ്ങിവരുന്ന കോളർമാർക്കും ഇത് ബാധകമാണ്: നിങ്ങളുടെ വെബ്‌ഹുക്ക് മടക്കിനൽകുന്ന ഏതൊരു JSON ഒബ്‌ജക്റ്റും അതിന്റെ ഉത്തരമാണ്, ഒരു കോൾ നിരസിക്കാനുള്ള മാർഗമാണ് {}.


ഏജന്റ് കോൾ സജ്ജീകരണ വെബ്ഹുക്ക്

ഒരു ഏജന്റിന് സ്വന്തമായി കോൾ സജ്ജീകരണ വെബ്ഹുക്ക് ഉണ്ടായിരിക്കാം: അതിന്റെ ക്രമീകരണങ്ങളിലെ കോൾ സജ്ജീകരണ വെബ്ഹുക്ക് ഫീൽഡിലോ APIയിലെ call_setup_webhook_url ലോ. ഏജന്റിനെ ഒരു നമ്പറിലേക്ക് നിയോഗിക്കുക. ആ നമ്പറിലേക്ക് വരുന്ന ഓരോ ഇൻബൗണ്ട് കോളിനും ഏജന്റ് മറുപടി നൽകുന്നതിന് മുമ്പ്, ആ കോളിന്റെ വേരിയബിളുകളും സന്ദർഭവും അറിയാൻ ThunderPhone വെബ്ഹുക്കിനോട് ചോദിക്കും. നമ്പർ അതിന്റെ ഏജന്റിനെ നിലനിർത്തും, അതിനാൽ ഫോൺ നമ്പറുകൾ പേജും ഏജന്റ് പേജും അതിന് മറുപടി നൽകുന്ന ഏജന്റിനെ കാണിക്കും.

ഇത് ഏജന്റിന്റെ മറ്റ് ക്രമീകരണങ്ങളെപ്പോലെയുള്ള ഒരു ക്രമീകരണമാണ്: ഡ്രാഫ്റ്റായി ഘട്ടീകരിക്കപ്പെടുകയും, ഡിപ്ലോയ് ചെയ്യുമ്പോൾ പ്രസിദ്ധീകരിക്കപ്പെടുകയും, പതിപ്പ് ചരിത്രത്തിൽ സൂക്ഷിക്കപ്പെടുകയും ചെയ്യും. ഒരു നമ്പർ പഴയ പതിപ്പിലേക്ക് പിൻ ചെയ്തിട്ടുണ്ടെങ്കിൽ ആ പതിപ്പിന്റെ URL-നോട് ചോദിക്കും. അഭ്യർഥനകൾ ഏജന്റിന്റെ സ്വന്തം call_setup_webhook_signing_secret ഉപയോഗിച്ചാണ് ഒപ്പിടുന്നത് (ഓർഗനൈസേഷന്റെ വെബ്ഹുക്ക് രഹസ്യമല്ല); മുകളിൽ പറഞ്ഞ അതേ X-ThunderPhone-Signature ഹെഡർ, ടൈംഔട്ടുകൾ, വീണ്ടും ശ്രമിക്കൽ, ഐഡംപൊട്ടൻസി കീ എന്നിവയോടുകൂടി. രഹസ്യം എഴുത്തിന് മാത്രമുള്ളതാണ്: നിങ്ങളുടെ എൻഡ്‌പോയിന്റ് പരിശോധിക്കുന്ന ഒന്ന് സജ്ജമാക്കുക (ഏജന്റിന്റെ ക്രമീകരണങ്ങളിലോ PATCH /v1/agents/{id} ഉപയോഗിച്ചോ); ഒരു റീഡ് പ്രവർത്തനവും അത് തിരികെ നൽകില്ല, കൂടാതെ ഒന്ന് സജ്ജമാക്കിയിട്ടുണ്ടോ എന്ന് call_setup_webhook_signing_secret_set വ്യക്തമാക്കുന്നു.

അഭ്യർഥന, മുകളിലെ telephony.incoming പേലോഡും അതിൽ പൂരിപ്പിക്കുന്ന ഏജന്റും ചേർന്നതാണ്:

{
  "type": "telephony.incoming",
  "data": {
    "call_id":     987654321,
    "from_number": "+14155550199",
    "to_number":   "+15551234567",
    "variables":   null,
    "agent": {
      "id": 12,
      "name": "Front desk",
      "version": 7,
      "version_pinned": false
    }
  }
}
ഫീൽഡ്തരംവിവരണം
agent.idintegerനമ്പറിലേക്ക് നിയോഗിച്ച ഏജന്റ്
agent.namestringഅതിന്റെ പേര്
agent.versioninteger | nullമറുപടി നൽകുന്ന പതിപ്പിന്റെ നമ്പർ: നമ്പറിന്റെ പിൻ ചെയ്ത പതിപ്പ്, അല്ലെങ്കിൽ ഏജന്റിന്റെ ഏറ്റവും പുതിയ പ്രസിദ്ധീകരിച്ച പതിപ്പ് (ഒന്നുമില്ലെങ്കിൽ null)
agent.version_pinnedbooleanനമ്പർ ആ പതിപ്പിലേക്ക് പിൻ ചെയ്തിട്ടുണ്ടോ എന്ന്

കോളിന് ആവശ്യമായത് നൽകി മറുപടി നൽകുക. ഇവയിൽ ഏതെങ്കിലും, നമ്പറിന്റെ പതിപ്പിൽ നിയോഗിച്ച ഏജന്റിന്റെ വിവരങ്ങൾ പൂരിപ്പിക്കുന്നു:

  • {"variables": {...}}, {"context": "..."}, അല്ലെങ്കിൽ രണ്ടും
  • നിയോഗിച്ച ഏജന്റിന്റെ id ആയി "agent_id" സജ്ജമാക്കിയ അതേ രീതി
  • {}: ഒന്നും പൂരിപ്പിക്കാതെയാണ് ഏജന്റ് മറുപടി നൽകുന്നത്

ഒരു agent_id-ന് അടുത്തുള്ളതുപോലെ timezone, language എന്നിവയും അനുവദനീയമാണ്. വേരിയബിളുകൾ ഏജന്റിന്റെ {{placeholders}} പൂരിപ്പിക്കും; prompt-ന് ശേഷം സന്ദർഭം ചേർക്കപ്പെടും.

അല്ലെങ്കിൽ കോൾ നിങ്ങൾക്ക് തന്നെ തീരുമാനിക്കാം. മറ്റൊരു ഏജന്റിന്റെ agent_id അല്ലെങ്കിൽ prompt അടങ്ങിയ പൂർണ്ണ കോൺഫിഗറേഷൻ, നിയോഗിച്ച ഏജന്റിന് പകരം (അതിന്റെ പിൻ ചെയ്ത പതിപ്പിനും പകരം) ഈ ഒരു കോളിന് മറുപടി നൽകും. കോൾ വിശദാംശങ്ങൾ ഓരോ സാഹചര്യത്തെയും call_setup_webhook-ൽ ഇങ്ങനെ അടയാളപ്പെടുത്തും: assigned_agent, other_agent അല്ലെങ്കിൽ inline_config. ഉപയോഗിക്കാൻ കഴിയാത്ത മറുപടി (അറിയപ്പെടാത്ത agent_id, variables-നൊപ്പം മറ്റ് കീകൾ, സാധൂകരണം പരാജയപ്പെടുന്ന കോൺഫിഗറേഷൻ) ഒരു നമ്പറിന്റെ വെബ്ഹുക്കിനുള്ളതുപോലെ കോൾ അവസാനിപ്പിക്കും.

വെബ്ഹുക്ക് മറുപടി നൽകേണ്ടപ്പോൾ. ഒരു ഏജന്റിന്റെ ക്രമീകരണങ്ങളിൽ ഡിഫോൾട്ട് ഇല്ലാത്ത {{variable}} ഉപയോഗിക്കുമ്പോൾ അതിന് വെബ്ഹുക്ക് ആവശ്യമാണ്: അതിന്റെ prompt അല്ലെങ്കിൽ പുനരുപയോഗിക്കാവുന്ന നിർദ്ദേശങ്ങൾ, ഘട്ട നിർദ്ദേശങ്ങൾ അല്ലെങ്കിൽ വരികൾ, അംഗീകാര prompt, വോയ്‌സ്‌മെയിൽ സന്ദേശം, സമ്മത പ്രഖ്യാപനം, അല്ലെങ്കിൽ ഒരു {{variable}} ട്രാൻസ്ഫർ നമ്പർ. ഏജന്റിന്റെ call_setup_webhook_variables അവയുടെ പട്ടിക നൽകുന്നു.

  • അതിന് വെബ്ഹുക്ക് ആവശ്യമാണ്: വെബ്ഹുക്ക് ടൈംഔട്ട് ആകുമ്പോൾ, എത്തിച്ചേരാനാകാതിരിക്കുമ്പോൾ, അല്ലെങ്കിൽ പിശകോ JSON ഒബ്‌ജക്റ്റ് അല്ലാത്ത ബോഡിയോ നൽകി മറുപടി നൽകുമ്പോൾ, ആ വേരിയബിളുകളിലൊന്നിന് കോളിൽ ഇതിനകം മൂല്യമുണ്ടെങ്കിലും കോൾ ആരംഭിക്കില്ല. ടൈംഔട്ടുകളും വീണ്ടും ശ്രമിക്കലും-ൽ വിവരിച്ചിരിക്കുന്നതുപോലെ അത് അവസാനിപ്പിച്ച് രേഖപ്പെടുത്തും (end_reason inbound_config_webhook_failed, ബിൽ ചെയ്യില്ല).
  • അതിന് ഒന്നും ആവശ്യമില്ല (വേരിയബിളുകളില്ല, അല്ലെങ്കിൽ ഓരോന്നിനും {{first_name|there}} പോലുള്ള ഡിഫോൾട്ട് ഉണ്ടെങ്കിൽ): വെബ്ഹുക്ക് തുടർന്നും പ്രവർത്തിക്കും, എന്നാൽ അത് പരാജയപ്പെട്ടാൽ ഏജന്റ് അതില്ലാതെ മറുപടി നൽകും, എന്താണ് തെറ്റിയതെന്ന് കോൾ വിശദാംശങ്ങളിൽ webhook_failed സഹിതം കാണിക്കും.

കോൾ കോൺടെക്സ്റ്റ് മാത്രം വെബ്ഹുക്ക് നിർബന്ധമാക്കില്ല: ഒരു ഏജന്റിന്റെ ക്രമീകരണങ്ങളിലൊന്നും അതിന് കോൺടെക്സ്റ്റ് ആവശ്യമാണെന്ന് പറയുന്നില്ല. നിങ്ങളുടെ വെബ്ഹുക്കിന്റെ മറുപടിയില്ലാതെ ഒരു കോൾ ആരംഭിക്കരുതെങ്കിൽ ഡിഫോൾട്ട് ഇല്ലാത്ത ഒരു വേരിയബിൾ ഉപയോഗിക്കുക.

അസൈൻ ചെയ്യലും വിന്യാസവും. വെബ്ഹുക്ക് ആവശ്യമുള്ള ഒരു ഏജന്റിനെ, വെബ്ഹുക്ക് ഇല്ലാത്ത ഒരു നമ്പറിലേക്ക് അസൈൻ ചെയ്യാനാവില്ല: വേരിയബിളുകളുടെ പേരുകൾ പറയുന്ന സന്ദേശത്തോടെ അസൈൻമെന്റ് നിരസിക്കും. പിൻ ചെയ്ത നമ്പർ വീണ്ടും ഏറ്റവും പുതിയത് എന്നതിലേക്ക് മാറുന്നതുൾപ്പെടെ, ഒരു നമ്പറിന്റെ പതിപ്പ് മാറുമ്പോഴും ഇതേ പരിശോധന പ്രവർത്തിക്കും. പ്രസിദ്ധീകരിച്ച ക്രമീകരണങ്ങളോടെ ഒരു നമ്പറിന് മറുപടി നൽകുമ്പോൾ, വെബ്ഹുക്ക് ഇല്ലാതെ അത്തരമൊരു വേരിയബിൾ ചേർക്കുന്ന (അല്ലെങ്കിൽ വെബ്ഹുക്ക് നീക്കുന്ന) വിന്യാസവും ഇതേ രീതിയിൽ നിരസിക്കും. ഡ്രാഫ്റ്റ് സംരക്ഷിക്കുന്നത് എപ്പോഴും അനുവദനീയമാണ്, പരിഹരിക്കുന്നതുവരെ ഏജന്റിന്റെ warnings-ൽ call_setup_webhook_needed ഉണ്ടായിരിക്കും.

ഏജന്റിന്റെ വെബ്ഹുക്ക് അത് അസൈൻ ചെയ്തിരിക്കുന്ന നമ്പറുകളിലെ ഇൻബൗണ്ട് ഫോൺ കോളുകൾക്കു മാത്രമേ പ്രവർത്തിക്കൂ. ഔട്ട്ബൗണ്ട് കോളുകൾ, വെബ് വിജറ്റ് സെഷനുകൾ, SIP വിലാസങ്ങൾ, സിമുലേഷനുകൾ, ഡാഷ്ബോർഡ് ടെസ്റ്റ് സംഭാഷണങ്ങൾ എന്നിവ അതിനെ വിളിക്കില്ല; അവ മുമ്പത്തെപ്പോലെ അഭ്യർത്ഥനയിൽനിന്ന് വേരിയബിളുകൾ സ്വീകരിക്കും.

സംരക്ഷിച്ച സാമ്പിളുകൾ ഉപയോഗിച്ചുള്ള പരിശോധന. നൽകിയിരിക്കുന്ന ഒരു മറുപടിയിൽ (വീണ്ടും വിളിക്കുന്ന കോളർ, രേഖയൊന്നും കണ്ടെത്തിയില്ല, സ്പാനിഷ് സംസാരിക്കുന്നയാൾ) നിങ്ങളുടെ ഏജന്റ് എന്ത് ചെയ്യുമെന്ന് പരിശോധിക്കാൻ, ആ മറുപടി ഏജന്റിൽ ഒരു സാമ്പിളായി സംരക്ഷിക്കുക: അതിന്റെ variables, context, ആവശ്യമെങ്കിൽ language; നേരിട്ട് ടൈപ്പ് ചെയ്തോ മുൻകാല കോളിൽ നിന്ന് പകർത്തിയോ. ഡാഷ്ബോർഡ് ടെസ്റ്റ് സംഭാഷണം, നിങ്ങളുടെ ഫോണിലേക്കുള്ള ടെസ്റ്റ് കോൾ, അല്ലെങ്കിൽ ഏജന്റിനെതിരായ ഒരു സിമുലേഷൻ ആരംഭിക്കുമ്പോൾ അത് തിരഞ്ഞെടുക്കുക; അപ്പോൾ നിങ്ങളുടെ webhook അതിനൊപ്പം മറുപടി നൽകിയതുപോലെ കോൾ പ്രവർത്തിക്കും. സാമ്പിളുകൾ ഏജന്റിന്റെ എല്ലാ പതിപ്പുകളും പങ്കിടുന്നു. ഒരെണ്ണം എഡിറ്റ് ചെയ്താൽ അതിന്റെ മുൻ പതിപ്പുകൾ നിലനിൽക്കും: ഒരു ഏജന്റ് മാറ്റത്തിന് സാമ്പിൾ സജ്ജീകരിക്കാത്ത ഒരു വേരിയബിൾ ആവശ്യമാണെങ്കിൽ, അത് സാമ്പിളിലേക്ക് ചേർക്കുക; പഴയ ഏജന്റ് പതിപ്പുകൾ സാമ്പിളിനെ മുമ്പുണ്ടായിരുന്ന രീതിയിൽ തന്നെ ഉപയോഗിക്കുന്നത് തുടരും. ഒരു ഫോൺ നമ്പറിലേക്ക് ഡയൽ ചെയ്യുന്ന സിമുലേഷനുകൾ പകരം നിങ്ങളുടെ യഥാർഥ webhook പ്രവർത്തിപ്പിക്കും.

അസൈൻ ചെയ്ത ഏജന്റില്ലാത്ത നമ്പറുകൾ മുകളിൽ പറഞ്ഞതുപോലെ നമ്പറിന്റെ അല്ലെങ്കിൽ ഓർഗനൈസേഷന്റെ വെബ്ഹുക്ക് ഉപയോഗിക്കുന്നത് തുടരും.


കോൾബാക്കുകൾ

നിങ്ങളുടെ ഏജന്റ് ഒരു വോയ്‌സ്‌മെയിൽ വിട്ടതിന് ശേഷം പോലുള്ള സാഹചര്യങ്ങളിൽ, ആളുകൾ തങ്ങളെ വിളിച്ച നമ്പറിലേക്ക് പലപ്പോഴും തിരികെ വിളിക്കും. കഴിഞ്ഞ 30 ദിവസത്തിനുള്ളിൽ അതേ നമ്പർ വിളിച്ച ഒരാളിൽ നിന്ന് ഒരു ഫോൺ കോൾ വരുമ്പോൾ, ThunderPhone അത്തരത്തിലുള്ള ഏറ്റവും പുതിയ ഔട്ട്‌ബൗണ്ട് കോൾ കണ്ടെത്തുകയും (അവരുടെ ഫോൺ റിംഗ് ചെയ്ത ഒന്ന്) അത് മൂന്ന് രീതികളിൽ ഉപയോഗിക്കുകയും ചെയ്യുന്നു:

  1. അഭ്യർത്ഥനയിലെ returning_call. മുകളിലെ തടയുന്ന അഭ്യർത്ഥനയും എൻഡ്‌പോയിന്റ് അറിയിപ്പും ഇത് വഹിക്കുന്നു, അതിനാൽ നിങ്ങളുടെ ഹാൻഡ്ലറിന് കോളറെ റൂട്ട് ചെയ്യാനാകും:

    {
      "type": "telephony.incoming",
      "data": {
        "call_id": 987654321,
        "from_number": "+14155550199",
        "to_number": "+15551234567",
        "returning_call": {
          "call_id": 987650001,
          "agent_id": 13,
          "started_at": "2026-10-21T19:05:12.402Z",
          "outcome": "voicemail"
        }
      }
    }
    ഫീൽഡ്തരംവിവരണം
    call_idഇന്റിജർമുമ്പത്തെ ഔട്ട്‌ബൗണ്ട് കോൾ
    agent_idഇന്റിജർ | nullകോൾ നടത്തിയ ഏജന്റ്; ഇൻലൈൻ കോൺഫിഗ് ഉപയോഗിച്ച് നടത്തിയ കോളിനോ ഏജന്റ് ഇല്ലാതാക്കിയ കോളിനോ null
    started_atസ്ട്രിംഗ്അത് ആരംഭിച്ച സമയം (ISO 8601, UTC)
    outcomeസ്ട്രിംഗ്no_answer (കോൾ റിംഗ് ചെയ്ത് അവസാനിച്ചു, തിരക്കിലായിരുന്നു, അല്ലെങ്കിൽ നിരസിക്കപ്പെട്ടു), voicemail (വോയ്‌സ്‌മെയിൽ മറുപടി നൽകി, അല്ലെങ്കിൽ ആരും ഏജന്റുമായി സംസാരിച്ചില്ല), conversation (ആരെങ്കിലും ഏജന്റുമായി സംസാരിച്ചു) അല്ലെങ്കിൽ answered (കോൾ എടുത്തു; ആരാണ് എടുത്തതെന്ന് ഇതുവരെ അറിയില്ല)
  2. ഏജന്റിനുള്ള പശ്ചാത്തലം. മറുപടി നൽകുന്ന ഏത് ഏജന്റിനും അതിന്റെ prompt-ന്റെ അവസാനത്തിൽ ഒരു ചെറിയ കുറിപ്പ് ലഭിക്കും: മുമ്പത്തെ കോൾ എപ്പോൾ നടത്തി, ഏത് ഏജന്റാണ് നടത്തിയത്, അതിന്റെ ഫലം എന്നിവ. അത് ഉറക്കെ വായിക്കരുതെന്നും, കോളർ ID വ്യാജമാക്കാൻ കഴിയുന്നതിനാൽ, മുമ്പ് നമ്പറിലേക്ക് വിളിച്ചിരുന്നു എന്നതിനപ്പുറം ആ കോളിനെക്കുറിച്ചുള്ള ഒന്നും പങ്കിടരുതെന്നും ഏജന്റിനോട് നിർദേശിക്കുന്നു.

  3. ഒരു ഫാൾബാക്ക് ഏജന്റ്. നമ്പറിന് ഇൻബൗണ്ട് ഏജന്റ് ഇല്ലാതിരിക്കുകയും വെബ്ഹുക്ക് URL ഇല്ലാത്തതിനാലോ നിങ്ങളുടെ വെബ്ഹുക്ക് മറുപടി നൽകാത്തതിനാലോ കോൺഫിഗറേഷൻ ലഭിക്കാതിരിക്കുകയും ചെയ്യുമ്പോൾ (അത് ടൈംഔട്ട് ആയി, എത്തിച്ചേരാനായില്ല, അല്ലെങ്കിൽ രണ്ട് ശ്രമങ്ങളിലും 5xx, 408 അല്ലെങ്കിൽ 429 മറുപടി നൽകി), കോൾ അവസാനിപ്പിക്കുന്നതിനുപകരം മുമ്പത്തെ കോൾ നടത്തിയ ഏജന്റിലേക്ക് പോകും, ആ ഏജന്റ് ഇപ്പോഴും നിങ്ങളുടെ ഓർഗനൈസേഷനിൽ ഉണ്ടെങ്കിൽ. ആ ഏജന്റിന്റെ ഡിപ്ലോയ് ചെയ്ത ക്രമീകരണങ്ങളോടെയാണ് അത് പ്രവർത്തിക്കുന്നത്. നിങ്ങളുടെ വെബ്ഹുക്ക് നൽകുന്ന ഏത് മറുപടിയും ഇപ്പോഴും നിർണായകമാണ്: മറ്റൊരു 4xx, JSON ഒബ്ജക്റ്റ് അല്ലാത്ത ഒരു ബോഡി, {}, അല്ലെങ്കിൽ സാധൂകരണം പരാജയപ്പെടുന്ന ഒരു കോൺഫിഗ് എന്നിവ കോൾ മുമ്പത്തെപ്പോലെ അവസാനിപ്പിക്കും. നമ്പറിലുള്ള ഒരു ഇൻബൗണ്ട് ഏജന്റ് എപ്പോഴും മറുപടി നൽകും.

മുമ്പത്തെ കോളിന്റെ വിശദാംശങ്ങൾ പങ്കിടൽ. കോളർ ID വ്യാജമാക്കാൻ കഴിയുന്നതിനാൽ, ഡിഫോൾട്ടായി മുമ്പത്തെ കോളിന്റെ ഉള്ളടക്കത്തിൽ നിന്നൊന്നും പുതിയ കോളിലേക്ക് എത്തില്ല. ഒരു ഓർഗനൈസേഷൻ അഡ്മിന് ഓർഗനൈസേഷൻ → ജനറൽ → കോൾബാക്കുകൾ എന്നതിന് കീഴിൽ മുമ്പത്തെ കോളിന്റെ വിശദാംശങ്ങൾ പങ്കിടുക ഓണാക്കാം (അല്ലെങ്കിൽ callback_context_details_enabled സജ്ജമാക്കാം). ഇത് ഓണായിരിക്കുമ്പോൾ, ഏജന്റിന്റെ കുറിപ്പിൽ മുമ്പത്തെ കോളിന്റെ സംഗ്രഹവും ഉദ്ധരിക്കും, കൂടാതെ മുമ്പത്തെ കോൾ നടത്തിയ ഏജന്റിലേക്ക് റൂട്ട് ചെയ്യുന്ന കോൾ ആ കോളിന്റെ variables ഉപയോഗിച്ച് പ്രവർത്തിക്കും (ഉദാഹരണത്തിന്, ഒരു കോൺടാക്റ്റിന്റെ പേര്). ആ നമ്പറിൽ നിന്ന് വിളിക്കുന്ന ഏതൊരാളുമായും പങ്കിടാൻ ആ വിശദാംശങ്ങൾ സുരക്ഷിതമാണെങ്കിൽ മാത്രം ഇത് ഓണാക്കുക. ഇത് ഓണായിരുന്നാലും, സംരക്ഷിത ആരോഗ്യ വിവരങ്ങൾ ഉൾക്കൊള്ളാൻ സാധ്യതയുള്ള ഒരു കോൾ അതിന്റെ സംഗ്രഹമോ variables-ഓ PHI പ്രോസസ്സ് ചെയ്യുന്നതിനായി നിയോഗിച്ചിട്ടില്ലാത്ത ഒരു കോളിലേക്ക് ഒരിക്കലും കൈമാറില്ല.

കോൾ വിശദാംശങ്ങളിൽ. മുമ്പത്തെ കോളുമായി പൊരുത്തപ്പെട്ട ഒരു ഇൻബൗണ്ട് കോളിന് GET /v1/calls/{call_id}-ൽ ഒരു callback ഒബ്ജക്റ്റ് ഉണ്ടായിരിക്കും: മുകളിലുള്ള returning_call, routed_as_callback (ഫോൾബാക്ക് അതിന് മറുപടി നൽകിയോയെന്നത്), കൂടാതെ config_webhook_failure (നിങ്ങളുടെ വെബ്ഹുക്ക് മറുപടി നൽകാതിരിക്കുകയും ഫോൾബാക്ക് കോൾ ഏറ്റെടുക്കുകയും ചെയ്തപ്പോൾ {kind, attempts, http_status, host}, അല്ലാത്തപക്ഷം null) എന്നിവ ഇതിൽ ഉൾപ്പെടും. അതിനാൽ കോൾക്ക് മറുപടി ലഭിച്ചാലും വെബ്ഹുക്ക് ഔട്ടേജ് ദൃശ്യമാകും.


പ്രതികരണ വലുപ്പ പരിധി


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

Python (FastAPI)
import hashlib
import hmac
import json
import os
 
from fastapi import FastAPI, HTTPException, Request
 
app = FastAPI()
WEBHOOK_SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
 
def verify(body: bytes, signature: str) -> bool:
    expected = hmac.new(WEBHOOK_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"] == "telephony.incoming":
        caller = event["data"]["from_number"]
        prompt = (
            "Greet the caller as a San Francisco local…"
            if caller.startswith("+1415")
            else "You are a friendly customer support agent…"
        )
        return {
            "prompt": prompt,
            "voice": "john",
            "product": "spark",
        }
    if event["type"] == "web.incoming":
        return {
            "prompt": "You are the website's helpful voice assistant…",
            "voice": "john",
            "product": "spark",
        }
    return {}
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" }),
  (req, res) => {
    if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
      return res.sendStatus(401);
    }
    const event = JSON.parse(req.body.toString("utf8"));
 
    if (event.type === "telephony.incoming" || event.type === "web.incoming") {
      const caller = event.data.from_number || "web";
      const prompt = caller.startsWith("+1415")
        ? "Greet the caller as a San Francisco local…"
        : "You are a friendly customer support agent…";
      return res.json({
        prompt,
        voice: "john",
        product: "spark",
      });
    }
    res.json({});
  },
);

ഫംഗ്ഷൻ ടൂളുകളുള്ള പ്രതികരണം

സംഭാഷണത്തിനിടെ AI-ക്ക് നിങ്ങളുടെ API-കളെ വിളിക്കാൻ കഴിയുന്ന വിധത്തിൽ ടൂളുകൾ ചേർക്കുക:

{
  "prompt":  "You are a booking assistant. Use the available tools to help customers schedule appointments.",
  "voice":   "john",
  "product": "spark",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_appointments",
        "description": "Find available appointment slots",
        "parameters": {
          "type": "object",
          "properties": {
            "date": { "type": "string", "description": "YYYY-MM-DD" },
            "service": { "type": "string" }
          },
          "required": ["date"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/search",
        "method": "POST",
        "headers": {
          "X-Api-Key": "your-key"
        }
      }
    }
  ]
}

ക്രമീകരണങ്ങളുടെ ചീറ്റ് ഷീറ്റ്

product: "bolt" അയച്ച്, ഈ ഫീൽഡുകൾ ഉപയോഗിച്ച് കോൾ ക്രമീകരിക്കുക. പഴയ product മൂല്യങ്ങളും (spark, storm-* മൂല്യങ്ങൾ) ഇപ്പോഴും സ്വീകരിക്കുന്നു.

ഫീൽഡ്മൂല്യങ്ങൾഎന്തിനുള്ള കൈമാറ്റം
intelligencecore, pro (സ്ഥിരസ്ഥിതി)Core ചെലവ് കുറഞ്ഞതും വേഗത്തിൽ മറുപടി തുടങ്ങുന്നതുമാണ്; Pro ദൈർഘ്യമേറിയ prompt-ുകൾ കൂടുതൽ വിശ്വസനീയമായി പിന്തുടരുന്നു
audio_tierlite, standard (സ്ഥിരസ്ഥിതി), plus, maxഉയർന്ന ടിയറുകൾക്ക് മികച്ച രീതിയിൽ കേൾക്കാനും കൂടുതൽ ചെലവാകാനും കഴിയും; ചില ടേണുകളിൽ Plus 1–2 s ചേർക്കുന്നു, ഓരോ Max മറുപടിക്കും 3–4 s എടുക്കും (Max പൊതുവായി ലഭ്യമല്ല)
endpointingfaster, fast, normal (സ്ഥിരസ്ഥിതി), patientകുറഞ്ഞ കാത്തിരിപ്പുകൾ വേഗത്തിൽ മറുപടി നൽകും, എന്നാൽ കൂടുതൽ ചെലവാകും
faster_repliestrue (സ്ഥിരസ്ഥിതി), falseവേഗവർധന: അല്പം കൂടുതൽ ചെലവിൽ, അല്പം വേഗത്തിൽ മറുപടികൾ

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