Open in
வெளிச்செல்லும் அழைப்புகளை மேற்கொள்ளுங்கள் (API)
உங்கள் சொந்த குறியீட்டிலிருந்து AI இயக்கும் வெளிச்செல்லும் அழைப்பைத் தொடங்குங்கள் — கருத்துக்கணிப்பு, தொடர்நடவடிக்கை அல்லது உறுதிப்படுத்தல் செயலோட்டங்களுக்கு.
வெளிச்செல்லும் அழைப்பு மூலம், இலக்கு எண்ணையும் ஏஜென்ட் கட்டமைப்பையும் ThunderPhone-க்கு வழங்கி, உங்கள் சார்பாக AI அழைப்பை மேற்கொள்ளச் செய்யலாம். வழக்கமான பயன்பாடுகள்:
- சந்திப்பு உறுதிப்படுத்தல்கள்
- கருத்துக்கணிப்பு மீளழைப்புகள்
- தவறவிட்ட அழைப்புக்குப் பிறகான "இரண்டாவது முயற்சி" தொடர்தொடர்புகள்
- அனுப்புநர் பாணி அறிவிப்புகள்
முன்நிபந்தனைகள்
- வெளிச்செல்லும் அழைப்புகளுக்கு இயக்கப்பட்ட எண்ணைத் தேர்ந்தெடுக்கவும்
நீங்கள் சொந்தமாக வைத்திருக்கும் எண்ணை VoIP இணைப்பு மூலம் பயன்படுத்தவும் அல்லது Phone Numbers பக்கத்தில் இருந்து வெளிச்செல்லும் அழைப்புகளுக்காக உங்கள் ThunderPhone எண்களைப் பயன்படுத்த அனுமதி கோரவும். ThunderPhone எண்கள் ஆரம்பத்தில் உள்வரும் அழைப்புகளுக்கு மட்டும் இயங்கும். ஒவ்வொரு கோரிக்கையையும் ThunderPhone கைமுறையாக மதிப்பாய்வு செய்கிறது; அங்கீகரிக்கப்பட்டதும், அந்த எண்கள் அங்கீகரிக்கப்பட்ட தினசரி வரம்பு வரை (00:00 UTC-இல் மீட்டமைக்கப்படும்) அழைப்புகளை மேற்கொள்ளவும் கேம்பெயின்களை இயக்கவும் முடியும்; மேலும் அதிக வரம்பைக் கேட்கலாம். வாடிக்கையாளர் VoIP எண்களுக்கு தினசரி வரம்பு இல்லை; எனவே வெளிச்செல்லும் அழைப்புகளுக்கு அவற்றை பரிந்துரைக்கிறோம். பார்க்கவும் உங்கள் சொந்த எண்களைக் கொண்டு வரவும்.
- ஒரு ஏஜென்ட்டை உருவாக்கவும்
வெளிச்செல்லும் அழைப்புக்கான prompt பொதுவாக ஏஜென்ட் தன்னைவும் அதன் நோக்கத்தையும் அறிமுகப்படுத்துவதுடன் தொடங்கும் — "வணக்கம், நாளை மாலை 3 மணிக்கான உங்கள் சந்திப்பை உறுதிப்படுத்த Acme-லிருந்து அழைக்கிறேன்…"
outbound_speak_order-ஐagent_firstஆக அமைக்கவும் (இயல்புநிலை). - நேர்மறை இருப்பை வைத்திருக்கவும்
இருப்பு ≤
$0.00என்றால் வெளிச்செல்லும் அழைப்புகள்402 Payment Requiredஐ வழங்கும். டாஷ்போர்டில் Organization → Billing Settings என்பதன் கீழ் தொகையைச் சேர்க்கவும் அல்லது தானியங்கி மறுஏற்றத்தை இயக்கவும். உங்கள்sk_live_விசைGET /v1/billingமூலம் இருப்பைச் சரிபார்க்கலாம், ஆனால் தொகையைச் சேர்க்கவோ தானியங்கி மறுஏற்றத்தை மாற்றவோ முடியாது.
சேமிக்கப்பட்ட ஏஜென்ட்டுடன் அழைப்பை மேற்கொள்ளவும்
எளிய வழி — id மூலம் ஏஜென்ட்டைக் குறிப்பிடவும்:
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+14155552671",
"agent_id": 12
}'பதில்:
{ "call_id": 987654321, "status": "initiated" }உள்ளமை கட்டமைப்புடன் அழைப்பை மேற்கொள்ளவும்
ஏஜென்ட்டாகச் சேமிக்கத் தேவையில்லாத ஒருமுறை பயன்படுத்தும் prompt வேண்டுமெனில்,
அதற்குப் பதிலாக config-ஐ வழங்கவும். இதன் வடிவம்
call.incoming webhook-இன் பதில்
ஸ்கீமாவுடன் பொருந்தும்:
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+14155552671",
"config": {
"prompt": "You are confirming Jane Doe appointment for 3pm tomorrow…",
"voice": "john",
"product": "spark"
}
}'கடைசி அமைதி சரிபார்ப்புக்குப் பிறகு என்ன நடக்கும் என்பதை கட்டுப்படுத்துங்கள்
சேமிக்கப்பட்ட ஏஜென்ட்கள் பயன்படுத்தும் அதே அமைதி இறுதிச் செயல் அமைப்புகளை இன்லைன் config இலும் அனுப்பலாம்:
{
"from_number": "+[REDACTED_PHONE]",
"to_number": "+[REDACTED_PHONE]",
"config": {
"silence_final_action": "hang_up"
}
}கடைசி அமைதி சரிபார்ப்புக்குப் பிறகு என்ன நடக்கும் என்பதைத் தேர்ந்தெடுக்க silence_final_action ஐப் பயன்படுத்துங்கள். silence_final_message ஐயும் அனுப்பலாம்; இறுதிச் செயல் பரிமாற்றமாக இருந்தால், silence_transfer_destination ஐயும் அனுப்பலாம்.
இன்லைன் config இல் சொற்கள் பட்டியலைச் சேர்க்கவும்
இன்லைன் வெளிச்செல்லும் அழைப்புகளில், சேமிக்கப்பட்ட ஏஜென்ட்களைப் போலவே அதே words பட்டியலைச் சேர்க்கலாம்.
முதலில் ஏஜென்ட்டைச் சேமிக்காமல், தனிப்பயன் உச்சரிப்பு அல்லது கேட்கும்
விதிகளை அழைப்பு பின்பற்ற வேண்டுமெனில் இதைப் பயன்படுத்துங்கள்.
{
"from_number": "+[REDACTED_PHONE]",
"to_number": "+[REDACTED_PHONE]",
"config": {
"prompt": "[REDACTED_LITERAL]",
"voice": "john",
"product": "spark",
"words": []
}
}அழைப்பைப் பின்தொடருங்கள்
queued_at நேரத்துடன் வரும் பதில், ThunderPhone-இன் வெளிச்செல்லும் அழைப்பு திறன் பயன்பாட்டில் உள்ளது என்பதைக் குறிக்கிறது: இடம் கிடைக்கும்போது, 10 நிமிடங்களுக்குள் அழைப்பு டயல் செய்யப்படும்; இடம் கிடைக்காவிட்டால் end_reason outbound_queue_timeout உடன் முடிவடையும். நீங்கள் மீண்டும் முயற்சிக்க வேண்டியதில்லை. வரிசைப்படுத்தப்பட்ட அழைப்புகள் என்பதைப் பார்க்கவும்.
இணையாக, இதற்கு குழுசேரவும்
telephony.complete வெப்ஹுக் —
அழைப்பு முடிந்ததை அறிய மிக வேகமான வழி. நேரடி
முன்னேற்றப் புதுப்பிப்புகளான டயல் செய்தல், பதிலளிக்கப்பட்டது, குரலஞ்சல் மற்றும் ஹோல்டு மாற்றங்களுக்கு
call.status_changed-க்கும் குழுசேரலாம்.
உள்வரும் வெப்ஹுக்குகளை ஏற்க முடியாவிட்டால், ஒவ்வொரு சில
விநாடிகளுக்கும் GET /v1/calls/{call_id}-ஐ வினவவும்; அழைப்பு முடிந்ததும் பதிவில் end_reason, duration_seconds,
மற்றும் பதிவு URL இடம்பெறும்.
அழைப்புக்குப் பிறகு கட்டமைக்கப்பட்ட தரவைப் பிரித்தெடுக்க உங்கள் ஏஜென்ட் அமைக்கப்பட்டிருந்தால், இறுதிப்படுத்தல் முடிந்த பிறகு அந்தத் தரவு தனியாக வழங்கப்படும்.
சேமிக்கப்பட்ட ஏஜென்ட்டிற்கு ஒவ்வொரு அழைப்புக்குமான மாறிகளை அனுப்புங்கள்
சேமிக்கப்பட்ட ஏஜென்ட்கள் prompt உரையில் {{name}} அல்லது {{name|there}} போன்ற
பிளேஸ்ஹோல்டர்களைப் பயன்படுத்தலாம். agent_id உடன் வெளிச்செல்லும் அழைப்பை மேற்கொள்ளும்போது,
அந்த அழைப்பிற்கான மதிப்புகளுடன் variables-ஐ அனுப்புங்கள்:
{
"from_number": "+[REDACTED_PHONE]",
"to_number": "+[REDACTED_PHONE]",
"agent_id": 12,
"variables": {
"name": "Jordan"
}
}பிளேஸ்ஹோல்டர் பெயரை விசையாகக் கொண்ட சரம் மதிப்புகளைப் பயன்படுத்துங்கள். இந்த மாறிகள்
சேமிக்கப்பட்ட ஏஜென்ட்களுக்குப் பொருந்தும்; இந்த வழிகாட்டியின் inline config எடுத்துக்காட்டு அவற்றைப் பயன்படுத்தாது.
கையாள வேண்டிய தோல்வி நிலைகள்
| பிழை | தீர்வு |
|---|---|
402 Payment Required | இருப்பை நிரப்பவும் அல்லது தானியங்கி மீள்நிரப்புதலை இயக்கவும் |
400 உடன் code: destination_not_allowed | ThunderPhone அந்த எண்ணிற்கு அழைக்காது: தவறான எண்கள், அவசர எண்கள், கூடுதல் கட்டண எண்கள், குறுகிய குறியீடுகள், தடையாண்மை விதிக்கப்பட்ட நாடுகள் அல்லது வெளிச்செல்லும் அழைப்புகளுக்காக உங்கள் நிறுவனம் தடுத்துள்ள அமெரிக்க மாநிலம். ThunderPhone எண்களிலிருந்து, வழக்கமான அமெரிக்க மற்றும் கனடிய எண்கள் அனுமதிக்கப்படுகின்றன; சில சர்வதேச இலக்குகளும் அனுமதிக்கப்பட்டு, இலக்கின் கட்டண விகிதத்தில் கட்டணமிடப்படும். எது என்பதை reason குறிப்பிடும்; தடுக்கப்பட்ட இலக்குகள் என்பதைப் பார்க்கவும் |
ThunderPhone எண்ணிற்கான retryable: false உடன் 409 | code ஐப் பின்பற்றவும்: Phone Numbers பக்கத்தில் வெளிச்செல்லும் அழைப்பைக் கோரவும், நிலுவையிலுள்ள மதிப்பாய்வுக்காகக் காத்திருக்கவும் அல்லது தகுதியுள்ள வேறு எண்ணைப் பயன்படுத்தவும் |
429 உடன் code: platform_outbound_daily_limit_reached | நிறுவனம் இன்று ThunderPhone எண்களிலிருந்து அனுமதிக்கப்பட்ட வெளிச்செல்லும் அழைப்புகளைப் பயன்படுத்திவிட்டது. resets_at (00:00 UTC) வரை காத்திருக்கவும், Phone Numbers பக்கத்தில் அதிக வரம்பைக் கோரவும் அல்லது உங்கள் சொந்த VoIP இணைப்பிலுள்ள எண்ணிலிருந்து அழைக்கவும் |
429 உடன் code: concurrent_call_limit_reached | நிறுவனத்தில் அதன் ஒரேநேர அழைப்பு வரம்பு அளவுக்கு அழைப்புகள் செயலிலுள்ளன (இயல்பாக 20; உள்வரும், வெளிச்செல்லும், வலை மற்றும் சோதனை அழைப்புகள் உட்பட). Retry-After தலைப்பில் உள்ள விநாடிகளுக்குப் பிறகு அல்லது ஒரு அழைப்பு முடிந்ததும் மீண்டும் முயற்சிக்கவும்; வரம்பை உயர்த்த support@thunderphone.com க்கு மின்னஞ்சல் அனுப்பவும் |
429 உடன் code: outbound_queue_full | நிறுவனத்தில் 50 வரிசையில் உள்ள அழைப்புகள் காத்திருக்கின்றன. Retry-After தலைப்பில் உள்ள விநாடிகளுக்குப் பிறகு மீண்டும் முயற்சிக்கவும் |
429 உடன் code: same_number_too_soon | இதே to_number ஐ 10 விநாடிகளுக்கும் குறைவான நேரத்திற்கு முன்பு நீங்கள் அழைத்துள்ளீர்கள். Retry-After தலைப்பில் உள்ள விநாடிகளுக்குப் பிறகு மீண்டும் முயற்சிக்கவும் |
வாடிக்கையாளர் VoIP எண்ணிற்கான retryable: false உடன் 409 | code குறிப்பிடும் நிலையைச் சரிசெய்யவும்; சரிபார்ப்பு தோல்விகளுக்கு, POST /v1/phone-numbers/{id}/verify-voip ஐ இயக்கவும் |
409 இடெம்போடென்சி முரண்பாடு | அசல் சீரமைக்கப்பட்ட கோரிக்கையுடன் மட்டுமே விசையை மீண்டும் பயன்படுத்தவும் அல்லது புதிய விசையை அனுப்பவும் |
404 from_number is not registered to this organization | from_number உங்கள் நிறுவனத்தில் உள்ள செயலில் இருக்கும் தொலைபேசி எண்ணுடன் பொருந்துவதை உறுதிப்படுத்தவும். ஏற்கனவே வழங்கல் நிலையில் உள்ள, தோல்வியடைந்த, வெளியிடப்படும் நிலையில் உள்ள அல்லது வெளியிடப்பட்ட எண்களும் இந்தப் பதிலை வழங்கும் |
500 இல் detail புலம் மட்டும் | வெளிச்செல்லும் டிரங்க் எதுவும் கட்டமைக்கப்படவில்லை. ஆதரவைத் தொடர்புகொள்ளவும்; இது நீங்கள் சரிசெய்யக்கூடிய எண்-நிலைச் சிக்கல் அல்ல |
502 Bad Gateway | தற்காலிக SIP / LiveKit தோல்வி; மீண்டும் முயற்சிப்பது பாதுகாப்பானது |
முழுமையான நிலையான தகுதிக் குறியீட்டு பட்டியலுக்கும் இரு 409 பதில் வடிவங்களுக்கும்
வெளிச்செல்லும் அழைப்புகள் குறிப்பைப் பார்க்கவும்.
கோரிக்கை ஏற்கப்பட்ட பிறகு ஆனால் அழைப்பு மேற்கொள்ளப்படுவதற்கு முன் செயலில் உள்ள எண் தகுதியற்றதாக மாறினால்,
இறுதிச் சரிபார்ப்பு மீண்டும் முயற்சிக்க முடியாத 409 பேலோடை வழங்கும்.
காத்திருப்பு நேரத்தைக் கட்டுப்படுத்துதல்
அழைப்பைப் பெறுபவர் பதிலளிக்கத் தாமதிப்பதால் நீண்ட நேரம் இயங்கும் வெளிச்செல்லும் அழைப்புகளை
(IVR மரங்கள், வரிசைகள்), அழைப்பில் max_hold_seconds அமைப்பதன் மூலம் அல்லது சேமிக்கப்பட்ட ஏஜென்டில் அதை அமைப்பதன் மூலம் வரம்பிடலாம்:
{
"from_number": "+15551234567",
"to_number": "+14155552671",
"agent_id": 12,
"max_hold_seconds": 120
}கடந்த N வினாடிகளில் மனித குரல் எதுவும் பெறப்படவில்லை என்றால் ஏஜென்ட் அழைப்பைத் துண்டிக்கிறது. இயல்புநிலை 900 வினாடிகள் (15 நிமிடங்கள்).
சேமிக்கப்பட்ட ஏஜென்டிலும் வெளிச்செல்லும் அழைப்பு கோரிக்கையிலும் max_hold_seconds அமைத்தால், அந்த அழைப்பிற்கு அழைப்பு-குறிப்பிட்ட மதிப்பு பயன்படுத்தப்படும்.
அடுத்த படிகள்
ஒவ்வொரு கோரிக்கைப் புலமும் பிழைக் குறியீடும்.
முடிந்த வெளிச்செல்லும் அழைப்புகளை உங்கள் அமைப்பிற்கு அனுப்புங்கள்.
இருப்பு காரணமாக வெளிச்செல்லும் அழைப்புகள் ஒருபோதும் தோல்வியடையாதபடி தானியங்கு மறுஏற்றத்தை அமைக்கவும்.
தயாரிப்புக்கு முன் உங்கள் வெளிச்செல்லும் ஏஜென்ட்டை டிரை-ரன் செய்யுங்கள்.