Open in
உள்வரும் அழைப்புகளைக் கையாளுங்கள் (API)
முழுமையாக: ஒரு ஏஜென்ட்டை உள்ளமைக்கவும், அதை ஒரு தொலைபேசி எண்ணுக்கு ஒதுக்கவும், அழைப்பை ஏற்கவும், உரைப்பதிவைப் பரிசோதிக்கவும்.
உங்கள் டெர்மினலிலிருந்து, வழக்கமான "AI மூலம் தொலைபேசி அழைப்பிற்குப் பதிலளி" செயல்முறை. நீங்கள் செய்ய வேண்டியவை:
- ஒரு prompt மற்றும் குரலுடன் ஏஜென்ட்டை உருவாக்குங்கள்.
- ஒரு தொலைபேசி எண்ணை வழங்குங்கள் (அல்லது உங்கள் எண்ணைக் கொண்டு வாருங்கள்) மற்றும் அந்த ஏஜென்ட்டை அதன் உள்வரும் அழைப்பு கையாளராக ஒதுக்குங்கள்.
- எண்ணிற்கு அழையுங்கள். அழைப்புப் பதிவு, உரையாடல் பதிவு மற்றும் பதிவை கவனியுங்கள்.
மொத்த API அழைப்புகள்: நான்கு. மொத்த நேரம்: ஐந்து நிமிடங்களுக்குள்.
1. ஏஜென்ட்டை உருவாக்குங்கள்
ஒரு ஏஜென்ட், அழைப்பை இயக்கும் prompt, குரல் மற்றும் தயாரிப்பு அடுக்கு ஆகியவற்றை ஒருங்கிணைக்கிறது. ஏஜென்டில் max_call_duration_seconds மற்றும் ring_duration_seconds போன்ற அழைப்பு வரம்புகளையும் நீங்கள் அமைக்கலாம். வெளிச்செல்லும் அழைப்புகளுக்கு, அழைப்பை முடிப்பதற்கு முன் ஏஜென்ட் காத்திருப்பில் காத்திருக்கும் நேரத்தை வரம்பிட max_hold_seconds அமைக்கலாம். Bolt ஏஜென்ட்கள், அவை எவ்வாறு கேட்கின்றன மற்றும் பதிலளிக்கின்றன என்பதைக் கட்டுப்படுத்த audio_tier, endpointing, மற்றும் intelligence ஆகியவற்றையும் ஆதரிக்கின்றன. intelligence, lite மற்றும் standard ஆகியவற்றை ஆதரிக்கிறது. ஏஜென்ட் பேசுவதற்கு முன், முன்பதிவு செய்யப்பட்ட அறிமுகத்தையும் அதிகபட்சம் இரண்டு ரிங்குகளையும் இயக்க intro_clip மற்றும் intro_ring_count ஆகியவற்றையும் ஏஜென்ட்கள் ஆதரிக்கின்றன. புதிய ஏஜென்ட்களுக்கு நேர மண்டலமும் தேவை. உங்கள் ஏஜென்ட் பல மொழிகளை ஆதரித்தால், மொழிகளை மாற்றுவதற்கு முன் அது கேட்க வேண்டுமா அல்லது அழைப்பாளரின் மொழியைப் பின்பற்ற வேண்டுமா என்பதைக் கட்டுப்படுத்த language_switching அமைக்கலாம். குறிப்பிட்ட சொற்களை அது எவ்வாறு உச்சரிக்கிறது, எந்தச் சொற்களைக் கவனிக்கிறது என்பதைக் கட்டுப்படுத்த ஏஜென்டில் words அமைக்கலாம். ஒவ்வொரு கட்டமைப்பு புலத்திற்கும் ஏஜென்ட்களை பார்க்கவும்; குறைந்தபட்சம் இதுவாகும்:
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Support",
"prompt": "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
"voice": "john",
"product": "spark"
}'திரும்பிய id-ஐச் சேமியுங்கள் — படி 2-ல் அது தேவைப்படும்.
2. ஒரு தொலைபேசி எண்ணைப் பெறுங்கள்
அழைப்பதற்கு மட்டும் ஏதாவது தேவைப்பட்டால், ThunderPhone தொகுப்பிலிருந்து ஒரு ThunderPhone எண்ணைப் பெறுங்கள்:
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"area_code": "415"}'பதில் E.164 வடிவில் id மற்றும் number ஆகியவற்றை உள்ளடக்கும். ThunderPhone
எண்கள் status="provisioning" நிலையில் தொடங்கி சில
வினாடிகளுக்குள் active ஆகும் — தேவைப்பட்டால் மாற்றத்தைக் காண
GET /v1/phone-numbers/{id}
ஐ poll செய்யுங்கள்.
3. ஏஜென்ட்டை ஒதுக்குங்கள்
படி 1-ல் உள்ள ஏஜென்ட்டை எண்ணின் உள்வரும் அழைப்பு திசையுடன் இணைக்குங்கள்:
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'அவ்வளவுதான் — எண் செயல்பாட்டில் உள்ளது. உங்கள்
நிறுவனத்திற்கு வெளிச்செல்லும் அழைப்பு அங்கீகரிக்கப்பட்ட பிறகு, அதே PATCH-ல்
outbound_agent_id-ஐயும் அமைக்கலாம். அதுவரை, API அந்த ஒதுக்கீட்டை 400 மூலம் நிராகரிக்கும்.
நிலையான inbound_agent_id ஐப் பயன்படுத்துவதற்குப் பதிலாக, உள்ளீட்டு அழைப்புகளை config webhook மூலம் வழிமாற்றினால், அந்த webhook இப்போது ஒவ்வொரு அழைப்பிற்குமான timezone ஐ agent_id மற்றும் variables உடன் திருப்பியனுப்பலாம். Bolt ஏஜென்ட்களுக்கு, API எழுதுதல்களில் ஏஜென்டில் audio_tier, endpointing, மற்றும் intelligence ஐயும் அமைக்கலாம். endpointing க்கான மாற்றுப்பெயராக பழைய eagerness பெயரையும் API இன்னும் ஏற்கிறது. உங்கள் ஏஜென்ட் trigger="call_start" உடன் API இணைப்புகளைப் பயன்படுத்தினால், ThunderPhone ஒவ்வொரு தொலைபேசி அழைப்பின் தொடக்கத்திலும், வாழ்த்துக்கு முன், அவற்றின் சேமிக்கப்பட்ட call_start_arguments ஐப் பயன்படுத்தி அந்த கருவிகளை ஒருமுறை இயக்க முடியும்.
உங்கள் வெளிச்செல்லும் அழைப்புகளுக்கான மீளழைப்பு செயலாக்கம்
கடந்த 30 நாட்களுக்குள் ஒருவரை அழைத்த எண்ணுக்கு அவர்கள் மீண்டும் அழைத்தால், பதிலளிக்கும் ஏஜென்ட்டுக்கு அந்த அழைப்பைப் பற்றிய சுருக்கமான பின்னணி குறிப்பு கிடைக்கும்: அது எப்போது செய்யப்பட்டது, எந்த ஏஜென்ட் செய்தது, என்ன நடந்தது (பதில் இல்லை, குரலஞ்சல் அல்லது உரையாடல்). உள்வரும் ஏஜென்ட் இல்லாத எண், இதே விவரங்களை உங்கள் config webhook-க்கு returning_call ஆக அனுப்பும். அந்த எண்ணுக்கு webhook இல்லாவிட்டால், அல்லது webhook நேரம் முடிந்தாலோ அணுக முடியாவிட்டாலோ, அழைப்பு முடிவதற்குப் பதிலாக முந்தைய அழைப்பை மேற்கொண்ட ஏஜென்ட்டிடம் செல்லும். அழைப்பாளர் அடையாளத்தைப் போலியாக்க முடியும் என்பதால், நிர்வாகி Organization → General → Callbacks கீழ் முந்தைய அழைப்பின் விவரங்களைப் பகிர்க என்பதை இயக்கினால் மட்டுமே முந்தைய அழைப்பின் சுருக்கமும் மாறிகளும் பகிரப்படும். மீளழைப்பு செயலாக்கம் பார்க்கவும்.
4. ஒரு அழைப்பை ஏற்குங்கள்
உங்கள் தொலைபேசியிலிருந்து அந்த எண்ணிற்கு அழையுங்கள். ஏஜென்ட் அழைப்பை ஏற்று, உங்கள் prompt-க்கு ஏற்ப தன்னை அறிமுகப்படுத்தி, உரையாடல் தொடங்கும்.
அழைப்பு நடந்து கொண்டிருக்கும்போது, அது
GET /v1/calls-இல்
status="in_progress" உடன் தோன்றும். அது முடிந்ததும், பதிவில்
end_reason, duration_seconds, billable_minutes, மற்றும் (இறுதியில்)
பதிவு URL மற்றும் AI தரம் புதுப்பிக்கப்படும்.
உள்வரும் அழைப்புகள் உங்கள் நிறுவனத்தின்
ஒரேநேர அழைப்பு வரம்பில் சேர்க்கப்படும் (இயல்பாக 20
அழைப்புகள் செயலிலிருக்கும்; இது வெளிச்செல்லும், இணைய மற்றும் சோதனை
அழைப்புகளுடன் பகிரப்படும்). வரம்பை எட்டிய நிலையில் வரும் அழைப்பு, ஏஜென்ட்
பதிலளிப்பதற்கு முன் நிராகரிக்கப்பட்டு துண்டிக்கப்படும்; அதற்கு கட்டணம் விதிக்கப்படாது,
மேலும் concurrent_call_limit_reached என்ற முடிவுக் காரணத்துடன் தோல்வியுற்ற அழைப்பாகப் பதிவாகும். உங்களுக்கு
அதிக வரம்பு தேவைப்பட்டால் support@thunderphone.com க்கு மின்னஞ்சல் அனுப்புங்கள்.
5. முடிவுகளைப் பரிசோதிக்கவும்
சமீபத்திய அழைப்புகளின் பட்டியலைப் பெறவும்:
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"உரையாடல் பதிவைப் பெறவும்:
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"மேலும் பதிவு URL-ஐப் பெறவும் (குறுகிய காலத்துக்கு மட்டுமே செல்லுபடியாகும், கையொப்பமிடப்பட்டது):
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"நீங்கள்
telephony.complete வெப்ஹுக்கிற்கு
சந்தா செய்திருந்தால், அதே தரவை உங்கள் சர்வருக்கு POST ஆகப் பெறுவீர்கள் — விவரங்களுக்கு
call.complete-ஐப் பார்க்கவும்.
உங்கள் ஏஜென்டில் தரவு பிரித்தெடுப்பு புலங்கள் கட்டமைக்கப்பட்டிருந்தால், நிறைவடைந்த அழைப்பு payload-ல் கட்டமைக்கப்பட்ட பிரித்தெடுக்கப்பட்ட தரவும் இருக்கலாம்.
அடுத்த படிகள்
தொலைபேசி எண் அல்லது வெப்ஹுக்கில் உள்ள தனிப்பயன் தர்க்கத்தின் அடிப்படையில் ஒவ்வொரு அழைப்பாளருக்கும் வேறு ஏஜென்டைத் தேர்ந்தெடுக்கவும்.
உரையாடலின் நடுவில் உங்கள் API-களை ஏஜென்ட் அழைக்க அனுமதிக்கவும்.
அழைப்பாளர்களை நேரடியாக வழிமாற்றவும் அல்லது இணைப்பதற்கு முன் இலக்கிடத்தைச் சரிபார்க்கவும்.
முடிவடைந்த ஒவ்வொரு அழைப்பையும் உங்கள் CRM / பகுப்பாய்வு பைப்லைனுக்கு ஸ்ட்ரீம் செய்யவும்.
ஒவ்வொரு அழைப்பையும் தானாக மதிப்பிடவும் மற்றும் கொடியிடப்பட்டவற்றை மதிப்பாய்வுக்கு அனுப்பவும்.