Open in
telephony.incoming / web.incoming
உள்வரும் அழைப்பின் கட்டமைப்பை நிகழ்நேரத்தில் வடிவமைக்கும் தடைசெய்யும் webhook.
உள்வரும் தொலைபேசி அழைப்பு ஒதுக்கப்பட்ட
ஏஜென்ட் இல்லாத எண்ணை அடையும்போது (Callbacks இல் உங்கள்
வெளிச்செல்லும் அழைப்புகளுக்குப் பதிலளித்து மீண்டும் அழைக்கும் அழைப்பாளர்களைப் பார்க்கவும்), அல்லது இணைய விட்ஜெட் அமர்வு வெளியிடத்தக்க விசையில்
mode="webhook" உடன் தொடங்கும்போது, ThunderPhone உங்கள்
பழைய webhook 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 இரண்டிலும் எதுவும் இல்லை; தவறாக எழுதப்பட்ட 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 | integer | அழைப்பு ஐடி — இந்த அழைப்பிற்கான அனைத்து நிகழ்வுகளிலும் நிலையாக இருக்கும் |
from_number | string | E.164 அழைப்பாளர் எண் |
to_number | string | E.164 இலக்கு எண் (உங்கள் ThunderPhone எண்களில் ஒன்று) |
returning_call | object | கடந்த 30 நாட்களுக்குள் இந்த எண் அழைப்பாளரை அழைத்திருந்தால் மட்டுமே இருக்கும். மீளழைப்புகள் பார்க்கவும் |
sip_headers | object | 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 | சரம் | உலாவி அனுப்பியபடி, widget-ஐ ஹோஸ்ட் செய்யும் பக்கத்தின் மூலம். உலாவி அல்லாத கிளையன்ட் எந்த மதிப்பையும் அனுப்ப முடியும் என்பதால், கோரிக்கை எங்கிருந்து வந்தது என்பதற்கான சான்றாக இதைக் கருத வேண்டாம் |
publishable_key_prefix | சரம் | அமர்வைத் திறந்த publishable key-யின் முதல் எழுத்துகள் |
language, primary_language | சரம் | widget அமர்வு மொழி மேலெழுதலைக் கோரியபோது இருக்கும் |
voice | சரம் | widget அமர்வு குரல் மேலெழுதலைக் கோரியபோது இருக்கும் |
website_context | சரம் | widget ஒவ்வொரு அமர்வுக்குமான பக்கச் சூழலை அனுப்பியபோது இருக்கும் |
மேலெழுதும் புலங்கள் (language, voice, website_context, மற்றும் எந்த
உலாவி variables) publishable key தனது உலாவி மேலெழுதல்களில் அவற்றை அனுமதிக்கும்போது மட்டுமே
வரும். key அனுமதிக்காத ஒன்றைக் கொண்ட அமர்வுக் கோரிக்கை, இந்த webhook அழைக்கப்படுவதற்கு முன் நிராகரிக்கப்படும்.
பதில் ஸ்கீமா
இந்த அழைப்பிற்கான ஏஜென்ட் கட்டமைப்பை விவரிக்கும் 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 இலிருந்து குரல் id, எ.கா. 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 உடனடியாக மாறும்; "ஆம்" போன்ற சுருக்கமான ஒன்றுக்குப் பிறகு, அதில் தொடர வேண்டுமா என்று கேட்கும். ஒரு சொல் மட்டுமே இருந்தாலும், அவர்கள் பேசும் எந்தக் கட்டமைக்கப்பட்ட மொழிக்கும் 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 (Lite), hearing (Plus), மற்றும் deep_hearing (Max) இன்னும் ஏற்கப்படுகின்றன. பிற தயாரிப்புகள் இதைப் புறக்கணிக்கும் |
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; ஒரு கருவியை மட்டும் அழைக்கும் Core பதில்கள் Pro-வுக்கு வழங்கப்படும். பழைய மதிப்புகளான lite (Core) மற்றும் standard (Pro) இன்னும் ஏற்கப்படுகின்றன; ஓய்வுபெற்ற plus மற்றும் max மதிப்புகள் pro-வில் இயங்கும். audio_tier என்பது max ஆக இருக்கும்போது புறக்கணிக்கப்படும். பிற தயாரிப்புகள் இதைப் புறக்கணிக்கும் |
faster_replies | பூலியன் | null | இல்லை | வேக அதிகரிப்பு. இயல்புநிலை true. Bolt v2 பைப்லைனில் உள்ள bolt ஏஜென்ட்டில், சற்று அதிக செலவுக்கு பதில்கள் சற்று விரைவில் தொடங்கும். false அதை முடக்கும். பிற தயாரிப்புகள் இதைப் புறக்கணிக்கும் |
background_track | சரம் | null | இல்லை | சுற்றுப்புற ஆடியோ id அல்லது 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 உச்சரிப்பு அகராதியைப் பயன்படுத்தும். தொலைபேசி மற்றும் விட்ஜெட் அழைப்புகளில் செயல்படும். உங்கள் சொந்த 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 | முழுஎண் | இல்லை | கோரிக்கையின் அழைப்பு id-யின் விருப்ப எதிரொலி; புறக்கணிக்கப்படும் |
prompt மற்றும் voice அவசியம் என்பதால், {} அல்லது சரிபார்ப்பில் தோல்வியடையும் எந்தப் பதிலையும் திருப்பியனுப்பினால் அழைப்பு நிராகரிக்கப்படும்: காலாவதிகள் மற்றும் மீண்டும் முயற்சிகள் பகுதியில் விவரித்தபடி தொலைபேசி அழைப்பு முடிக்கப்படும், மேலும் விட்ஜெட் அமர்வுக் கோரிக்கை 422 உடன் தோல்வியடையும். திரும்ப அழைக்கும் அழைப்பாளர்களுக்கும் இது பொருந்தும்: உங்கள் webhook திருப்பியனுப்பும் எந்த JSON பொருளும் அதன் பதிலாகும், மேலும் அழைப்பை நிராகரிக்கும் வழி {} ஆகும்.
ஏஜென்ட் அழைப்பு அமைப்பு வெப்ஹுக்
ஒரு ஏஜென்ட்டுக்கு அதன் சொந்த அழைப்பு அமைப்பு வெப்ஹுக் இருக்கலாம்: அதன் அமைப்புகளில் உள்ள அழைப்பு அமைப்பு வெப்ஹுக்
புலம் அல்லது API-இல் உள்ள call_setup_webhook_url.
ஏஜென்ட்டை ஒரு எண்ணுக்கு ஒதுக்குங்கள்; அந்த எண்ணில் ஏஜென்ட் ஏற்கும் ஒவ்வொரு உள்வரும் அழைப்புக்கும் முன்,
ThunderPhone அந்த அழைப்பின் மாறிகள் மற்றும் சூழலை வெப்ஹுக்கிடம் கேட்கும். எண் தனது ஏஜென்ட்டைத் தக்கவைத்துக்கொள்வதால்,
தொலைபேசி எண்கள் பக்கமும் ஏஜென்ட் பக்கமும் அதற்கு எந்த ஏஜென்ட் பதிலளிக்கிறது என்பதைக் காட்டும்.
இது ஏஜென்ட்டின் பிற அமைப்புகளைப் போன்ற ஒரு அமைப்பாகும்: வரைவாக நிலைநிறுத்தப்பட்டு,
வெளியிடும்போது பிரசுரிக்கப்பட்டு, பதிப்பு வரலாற்றில் வைத்திருக்கும். ஒரு எண்
முந்தைய பதிப்பில் நிலைநிறுத்தப்பட்டிருந்தால்,
அந்தப் பதிப்பின் URL-ஐக் கேட்கும். கோரிக்கைகள் ஏஜென்ட்டின் சொந்த
call_setup_webhook_signing_secret மூலம் (நிறுவனத்தின் வெப்ஹுக்
ரகசியம் அல்ல) கையொப்பமிடப்படுகின்றன; மேலே உள்ள அதே
X-ThunderPhone-Signature தலைப்பு, நேரமுடிவுகள், மறுமுயற்சி மற்றும் idempotency விசையுடன். இந்த ரகசியம்
எழுத-மட்டுமே இயலும்: உங்கள் இறுதிப்புள்ளி சரிபார்க்கும் ஒன்றை அமைக்கவும் (ஏஜென்ட்டின் அமைப்புகளில் அல்லது
PATCH /v1/agents/{id} மூலம்); எந்த வாசிப்பும் அதைத் திருப்பித் தராது, மேலும்
call_setup_webhook_signing_secret_set ஒன்று அமைக்கப்பட்டுள்ளதா என்பதைக் கூறும்.
இந்தக் கோரிக்கை மேலுள்ள telephony.incoming payload-உடன், அது நிரப்பவிருக்கும் ஏஜென்ட்டையும் கொண்டுள்ளது:
{
"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_reasoninbound_config_webhook_failed, கட்டணமின்றி). - இதற்கு எதுவும் தேவையில்லை (மாறிகள் இல்லையெனில் அல்லது ஒவ்வொன்றுக்கும்
{{first_name|there}}போன்ற இயல்புநிலை இருந்தால்): வெப்ஹுக் தொடர்ந்து இயங்கும்; ஆனால் அது தோல்வியடைந்தால் ஏஜென்ட் அது இல்லாமல் பதிலளிக்கும், மேலும் அழைப்பு விவரங்கள் தவறானதைக் கொண்டுwebhook_failedஎன்பதைக் காட்டும்.
அழைப்பு சூழல் மட்டும் webhook-ஐ கட்டாயமாக்காது: ஏஜென்டின் அமைப்புகளில் அதற்கு சூழல் தேவை என்று எதுவும் குறிப்பிடப்படுவதில்லை. உங்கள் webhook-இன் பதில் இல்லாமல் அழைப்பு தொடங்கக்கூடாது என்றால், இயல்புநிலை இல்லாத மாறியைப் பயன்படுத்துங்கள்.
ஒதுக்குதல் மற்றும் deploy செய்தல். தனது webhook தேவைப்படும் ஏஜென்டை, webhook இல்லாத எண்ணுக்கு ஒதுக்க முடியாது: மாறிகளின் பெயர்களைக் குறிப்பிடும் செய்தியுடன் ஒதுக்கீடு நிராகரிக்கப்படும். pinned செய்யப்பட்ட எண் Latest-க்கு மீண்டும் மாறுவது உட்பட, எண்ணின் பதிப்பு மாறும்போதும் இதே சரிபார்ப்பு இயங்கும். ஏஜென்ட் தனது வெளியிடப்பட்ட அமைப்புகளுடன் ஒரு எண்ணுக்குப் பதிலளிக்கும்போது, webhook இல்லாமல் அத்தகைய மாறியைச் சேர்க்கும் deploy (அல்லது webhook-ஐ அகற்றும் deploy) இதே முறையில் நிராகரிக்கப்படும். வரைவினைச் சேமிப்பது எப்போதும் அனுமதிக்கப்படும்; சரிசெய்யப்படும் வரை ஏஜென்டின் warnings-இல் call_setup_webhook_needed இருக்கும்.
ஏஜென்டின் webhook, அது ஒதுக்கப்பட்டுள்ள எண்களில் வரும் உள்வரும் தொலைபேசி அழைப்புகளுக்கு மட்டுமே இயங்கும். வெளிச்செல்லும் அழைப்புகள், web widget அமர்வுகள், SIP முகவரிகள், சிமுலேஷன்கள் மற்றும் dashboard சோதனை உரையாடல்கள் இதை அழைக்காது; முன்புபோல அவை கோரிக்கையிலிருந்து தங்கள் மாறிகளைப் பெறும்.
சேமித்த மாதிரிகளுடன் சோதித்தல். ஒரு குறிப்பிட்ட பதிலுடன் (மீண்டும் அழைக்கும் அழைப்பாளர், பதிவு எதுவும் கிடைக்கவில்லை, ஸ்பானிஷ் பேசுபவர்) உங்கள் ஏஜென்ட் என்ன செய்கிறது என்பதைச் சோதிக்க, அந்தப் பதிலை ஏஜென்டில் ஒரு மாதிரியாகச் சேமிக்கவும்: அதன் variables, context, மற்றும் விருப்பமாக language ஆகியவற்றை உள்ளிடவும் அல்லது முந்தைய அழைப்பிலிருந்து நகலெடுக்கவும். டாஷ்போர்டு சோதனை உரையாடல், உங்கள் தொலைபேசிக்கான சோதனை அழைப்பு அல்லது ஏஜென்டுக்கு எதிரான சிமுலேஷன் தொடங்கும்போது அதைத் தேர்ந்தெடுக்கவும்; அப்போது உங்கள் webhook அதனுடன் பதிலளித்தது போல அழைப்பு இயங்கும். மாதிரிகள் ஏஜென்டின் ஒவ்வொரு பதிப்பாலும் பகிரப்படுகின்றன. ஒன்றைத் திருத்தும்போது அதன் முந்தைய பதிப்புகள் பாதுகாக்கப்படும்: ஏஜென்ட் மாற்றத்திற்கு மாதிரியில் அமைக்கப்படாத ஒரு மாறி தேவைப்பட்டால், அதை மாதிரியில் சேர்க்கவும்; பழைய ஏஜென்ட் பதிப்புகள் மாதிரியை முன்பு இருந்தபடியே பயன்படுத்தும். தொலைபேசி எண்ணை அழைக்கும் சிமுலேஷன்கள் அதற்குப் பதிலாக உங்கள் உண்மையான webhook-ஐ இயக்கும்.
ஒதுக்கப்பட்ட ஏஜென்ட் இல்லாத எண்கள், மேலே கூறியபடியே எண்ணின் அல்லது நிறுவனத்தின் webhook-ஐத் தொடர்ந்து பயன்படுத்தும்.
மீளழைப்புகள்
உங்களை அழைத்த எண்ணுக்கு, எடுத்துக்காட்டாக உங்கள் ஏஜென்ட் குரலஞ்சல் விட்ட பிறகு, மக்கள் அடிக்கடி மீண்டும் அழைப்பார்கள். கடந்த 30 நாட்களில் அதே எண்ணை அழைத்த ஒருவரிடமிருந்து தொலைபேசி அழைப்பு வரும்போது, ThunderPhone அத்தகைய மிகச் சமீபத்திய வெளிச்செல்லும் அழைப்பைக் (அவர்களின் தொலைபேசியில் ஒலித்த அழைப்பு) கண்டறிந்து, அதை மூன்று வழிகளில் பயன்படுத்தும்:
-
கோரிக்கையில்
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 அழைப்பை மேற்கொண்ட ஏஜென்ட்; இன்லைன் கட்டமைப்புடன் மேற்கொள்ளப்பட்ட அழைப்புக்கு அல்லது அதன் ஏஜென்ட் நீக்கப்பட்டிருந்தால் nullstarted_atசரம் அது தொடங்கிய நேரம் (ISO 8601, UTC) outcomeசரம் no_answer(அழைப்பு முழுவதும் ஒலித்தது, பிஸியாக இருந்தது அல்லது நிராகரிக்கப்பட்டது),voicemail(குரலஞ்சல் பதிலளித்தது அல்லது யாரும் ஏஜென்டுடன் பேசவில்லை),conversation(யாரோ ஏஜென்டுடன் பேசினர்) அல்லதுanswered(அழைப்பு எடுக்கப்பட்டது; பதிலளித்தவர் யார் என்பது இன்னும் தெரியவில்லை) -
ஏஜென்டிற்கான பின்னணி. பதிலளிக்கும் ஏஜென்ட் எதுவாக இருந்தாலும், அதன் prompt-இன் இறுதியில் ஒரு சுருக்கமான குறிப்பு கிடைக்கும்: முந்தைய அழைப்பு எப்போது மேற்கொள்ளப்பட்டது, எந்த ஏஜென்டால் மேற்கொள்ளப்பட்டது, அதன் முடிவு என்ன என்பவை. அதைச் சத்தமாகப் படிக்க வேண்டாம் என்றும், அழைப்பாளர் அடையாளம் போலியாக இருக்கக்கூடும் என்பதால், அந்த எண்ணை முன்பு அழைத்ததைத் தாண்டி அந்த அழைப்பைப் பற்றிய எதையும் பகிர வேண்டாம் என்றும் ஏஜென்டிடம் கூறப்படும்.
-
ஒரு ஃபால்பேக் ஏஜென்ட். எண்ணில் உள்வரும் ஏஜென்ட் இல்லாதபோதும், வெப்ஹுக் URL இல்லாததாலோ அல்லது உங்கள் வெப்ஹுக் பதில் அளிக்காததாலோ (அது நேரம் கடந்தது, அணுக முடியவில்லை, அல்லது இரு முயற்சிகளிலும்
5xx,408அல்லது429எனப் பதிலளித்தது) கட்டமைப்பு வராதபோதும், அழைப்பு முடிவடைவதற்குப் பதிலாக முந்தைய அழைப்பை மேற்கொண்ட ஏஜென்டுக்கு அனுப்பப்படும்; அந்த ஏஜென்ட் இன்னும் உங்கள் அமைப்பில் இருந்தால் மட்டுமே இது நடக்கும். அது அந்த ஏஜென்டின் பயன்படுத்தப்பட்ட அமைப்புகளுடன் இயங்கும். உங்கள் வெப்ஹுக் அளிக்கும் எந்தப் பதிலும் முடிவைத் தீர்மானிக்கும்: மற்றொரு4xx, JSON பொருளாக இல்லாத உடல்,{}, அல்லது சரிபார்ப்பில் தோல்வியடையும் கட்டமைப்பு, முன்புபோல அழைப்பை முடிவடையச் செய்யும். எண்ணில் உள்ள உள்வரும் ஏஜென்ட் எப்போதும் பதிலளிக்கும்.
முந்தைய அழைப்பின் விவரங்களைப் பகிர்தல். அழைப்பாளர் அடையாளம் போலியாக இருக்கக்கூடும் என்பதால், இயல்பாக முந்தைய அழைப்பின் உள்ளடக்கத்திலிருந்து எதுவும் புதிய அழைப்பை அடையாது. அமைப்பின் நிர்வாகி, அமைப்பு → பொது → மீளழைப்புகள் என்பதன் கீழ் முந்தைய அழைப்பின் விவரங்களைப் பகிர் என்பதை இயக்கலாம் (அல்லது
callback_context_details_enabled அமைக்கலாம்).
இது இயக்கப்பட்டால், ஏஜென்டின் குறிப்பில் முந்தைய அழைப்பின் சுருக்கமும் மேற்கோளிடப்படும்; மேலும் முந்தைய அழைப்பை மேற்கொண்ட ஏஜென்டுக்கு வழிமாற்றப்படும் அழைப்பு, அந்த அழைப்பின் variables-உடன் (தொடர்பின் பெயர் போன்றவை) இயங்கும். அந்த எண்ணிலிருந்து அழைக்கும் எவருடனும் பகிர இந்த விவரங்கள் பாதுகாப்பானவை என்றால் மட்டுமே இதை இயக்குங்கள். இது இயக்கப்பட்டிருந்தாலும், பாதுகாக்கப்பட்ட சுகாதாரத் தகவலைக் கொண்டிருக்கக்கூடிய அழைப்பு, PHI-ஐச் செயலாக்குவதற்காக நியமிக்கப்படாத அழைப்புக்கு அதன் சுருக்கத்தையோ மாறிகளையோ ஒருபோதும் அனுப்பாது.
அழைப்பு விவரங்களில். முந்தைய அழைப்புடன் பொருந்திய உள்வரும் அழைப்பில் GET /v1/calls/{call_id} இல் callback ஆப்ஜெக்ட் இருக்கும்:
மேலுள்ள returning_call, routed_as_callback (மாற்று ஏஜென்ட் அதற்கு பதிலளித்ததா), மற்றும் config_webhook_failure (உங்கள் webhook பதிலளிக்காதபோது மாற்று ஏஜென்ட் அழைப்பை எடுத்திருந்தால் {kind, attempts, http_status, host}, இல்லையெனில் null) ஆகியவை இதில் இருக்கும்; எனவே அழைப்புக்கு பதிலளிக்கப்பட்டிருந்தாலும் webhook செயலிழப்பு தென்படும்.
பதில் அளவு வரம்பு
உதாரண ஹேண்ட்லர்
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 {}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({});
},
);function tools உடனான பதில்
உரையாடலின் நடுவில் AI உங்கள் API-களை அழைக்கக்கூடிய வகையில் tools-ஐ இணைக்கவும்:
{
"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-* மதிப்புகள்) இன்னும் ஏற்கப்படுகின்றன.
| புலம் | மதிப்புகள் | இது எதற்கான சமநிலையை மாற்றுகிறது |
|---|---|---|
intelligence | core, pro (இயல்புநிலை) | Core குறைந்த செலவானது மற்றும் விரைவில் பதிலளிக்கத் தொடங்கும்; Pro நீண்ட prompt-களை அதிக நம்பகத்தன்மையுடன் பின்பற்றும் |
audio_tier | lite, standard (இயல்புநிலை), plus, max | உயர்ந்த நிலைகள் சிறப்பாகக் கேட்கும் மற்றும் அதிக செலவாகும்; சில முறைகளில் Plus 1–2 s சேர்க்கும், ஒவ்வொரு Max பதிலும் 3–4 s எடுக்கும் (Max பொதுவாகக் கிடைக்காது) |
endpointing | faster, fast, normal (இயல்புநிலை), patient | குறுகிய காத்திருப்புகள் விரைவில் பதிலளிக்கும் மற்றும் அதிக செலவாகும் |
faster_replies | true (இயல்புநிலை), false | வேக உயர்வு: சிறிது அதிக செலவில், பதில்கள் சற்றே விரைவில் வரும் |
தொடர்புடையவை
செயல்பாட்டைத் தடுக்காத அழைப்பு-முடிவு நிகழ்வு.
tools[]-க்கான முழுமையான JSON ஸ்கீமாவும் கையொப்பமிடப்பட்ட முடிவுப்புள்ளி ஒப்பந்தமும்.
பல URL-களை telephony.incoming / web.incoming-க்கு சந்தா செய்யுங்கள்.
ஒவ்வொரு அழைப்பாளருக்கும் உரிய prompt-கள், கருவிகள் மற்றும் A/B சோதனைகளுக்கான வடிவங்கள்.