ThunderPhone v3 आता लाइव्ह आहे.स्वतःच सुरू करा—2¢/मिनिटपासून.घोषणा वाचा

Webhooks

telephony.incoming / web.incoming

येणाऱ्या कॉलचे कॉन्फिगरेशन रिअल टाइममध्ये आकार देणारा ब्लॉकिंग webhook.

जेव्हा इनबाउंड फोन कॉल नियुक्त एजंटशिवाय असलेल्या क्रमांकावर येतो (तुमच्या आउटबाउंड कॉलना परत कॉल करणाऱ्या कॉलरसाठी कॉलबॅक पहा), किंवा वेब विजेट सत्र प्रकाशित करण्यायोग्य कीवर mode="webhook" सह सुरू होते, तेव्हा ThunderPhone तुमच्या लेगसी वेबहुक URL वर ब्लॉकिंग telephony.incoming / web.incoming विनंती पाठवते आणि कॉन्फिगरेशन प्रतिसादाची प्रतीक्षा करते: फोन कॉलसाठी 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 दोन्हीही नाहीत; fields दुर्लक्षित केलेल्या कीची यादी देते, जसे चुकीचे लिहिलेले agentId), 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 रिकामे असते. एकमेव अपवाद म्हणजे एक्स्चेंज स्वतः अयशस्वी झाल्यावर कॉलरने तुमच्या आउटबाउंड कॉलपैकी एखाद्यावर परत कॉल करणे: Callbacks पहा.

विजेट सत्राला (web.incoming) 10 सेकंदांपर्यंतचा एकच प्रयत्न मिळतो. तो अयशस्वी झाल्यास, सत्र विनंती 502 किंवा 422 सह अयशस्वी होते.

विनंती पेलोड

फोन कॉलसाठी (telephony.incoming):

{
  "type": "telephony.incoming",
  "data": {
    "call_id":     987654321,
    "from_number": "+14155550199",
    "to_number":   "+15551234567"
  }
}
फील्डप्रकारवर्णन
call_idपूर्णांककॉल आयडी — या कॉलसाठी सर्व इव्हेंटमध्ये स्थिर
from_numberस्ट्रिंगE.164 कॉलर क्रमांक
to_numberस्ट्रिंगE.164 गंतव्य (तुमच्या ThunderPhone क्रमांकांपैकी एक)
returning_callऑब्जेक्टहा क्रमांक मागील 30 दिवसांत कॉलरला कॉल करत असेल तरच उपस्थित. कॉलबॅक पहा
sip_headersऑब्जेक्टकॉल X-* किंवा User-to-User SIP हेडरसह मॅन्युअल 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स्ट्रिंगनाहीnone, acknowledgement (डीफॉल्ट), किंवा tick: audio_tier plus किंवा max असताना मंद प्रतिसाद तयार होत असताना कॉलरला काय ऐकू येते
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नाहीअप्रचलित: 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 असताना, कॉलची Cartesia स्पीच त्या कॉलच्या भाषेसाठी उपलब्ध असल्यास ThunderPhone चा उच्चार शब्दकोश वापरते. फोन आणि विजेट कॉलसाठी कार्य करते. फक्त ThunderPhone च्या स्वतःच्या Cartesia व्हॉइससाठी लागू होते, तुमच्या स्वतःच्या Cartesia API कीवरील व्हॉइससाठी नाही. 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 सह अयशस्वी होते. परत कॉल करणाऱ्या व्यक्तींसाठीही हेच लागू होते: तुमचा webhook परत करत असलेला कोणताही 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.idपूर्णांकनंबरला नियुक्त केलेला एजंट
agent.nameस्ट्रिंगत्याचे नाव
agent.versionपूर्णांक | nullउत्तर देणाऱ्या आवृत्तीचा क्रमांक: नंबरची पिन केलेली आवृत्ती, अन्यथा एजंटची नवीनतम प्रकाशित आवृत्ती (ती नसल्यास null)
agent.version_pinnedबूलियननंबर त्या आवृत्तीला पिन केलेला आहे का

कॉलला आवश्यक असलेली माहिती द्या. यांपैकी कोणतेही पर्याय नंबरच्या आवृत्तीवर नियुक्त एजंटमध्ये माहिती भरतात:

  • {"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, स्वतः टाइप करून किंवा मागील कॉलमधून कॉपी करून. डॅशबोर्ड चाचणी संभाषण, तुमच्या फोनवर चाचणी कॉल किंवा एजंटविरुद्ध सिम्युलेशन सुरू करताना ते निवडा, आणि कॉल तुमच्या वेबहूकने त्यासह उत्तर दिल्याप्रमाणे चालेल. नमुने एजंटच्या प्रत्येक आवृत्तीद्वारे सामायिक केले जातात. एक नमुना संपादित केल्याने त्याच्या आधीच्या आवृत्त्या टिकून राहतात: एजंटच्या बदलासाठी नमुन्यात सेट नसलेले व्हेरिएबल आवश्यक असल्यास, ते नमुन्यात जोडा, आणि एजंटच्या जुन्या आवृत्त्या नमुना जसा होता तसाच वापरत राहतील. फोन नंबरवर डायल करणारी सिम्युलेशन्स त्याऐवजी तुमचा प्रत्यक्ष वेबहूक चालवतात.

नियुक्त एजंट नसलेले नंबर वर वर्णन केल्याप्रमाणेच नंबरचा किंवा संस्थेचा वेबहुक वापरत राहतात.


कॉलबॅक

लोक अनेकदा ज्या नंबरवरून त्यांना कॉल आला होता त्या नंबरवर परत कॉल करतात, उदाहरणार्थ तुमच्या एजंटने व्हॉइसमेल सोडल्यानंतर. मागील 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 (तुमच्या webhook ने उत्तर दिले नाही आणि फॉलबॅकने कॉल घेतला तेव्हा {kind, attempts, http_status, host}, अन्यथा null), त्यामुळे कॉलला उत्तर दिले गेले असले तरी webhook मधील अडथळा दिसत राहतो.


प्रतिसाद आकार मर्यादा


उदाहरण हँडलर

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 (default)Core स्वस्त आहे आणि लवकर प्रतिसाद देण्यास सुरुवात करते; Pro दीर्घ prompt अधिक विश्वासार्हपणे पाळते
audio_tierlite, standard (default), plus, maxउच्च टियर अधिक चांगले ऐकतात आणि अधिक खर्चिक असतात; काही टर्नमध्ये Plus 1–2 सेकंद जोडते, प्रत्येक Max प्रतिसादाला 3–4 सेकंद लागतात (Max सर्वसाधारणपणे उपलब्ध नाही)
endpointingfaster, fast, normal (default), patientकमी प्रतीक्षा कालावधी लवकर प्रतिसाद देतात आणि अधिक खर्चिक असतात
faster_repliestrue (default), falseस्पीड बूस्ट: थोड्या अधिक खर्चात, प्रतिसाद थोडे लवकर येतात

संबंधित