Open in
Talkdesk இலிருந்து இணைக்கவும்
Autopilot Voice-இன் Connect ஐப் பயன்படுத்தி Talkdesk அழைப்புகளை ThunderPhone ஏஜென்டுக்கு அனுப்பவும்; UUI-யில் உள்ள hand-off id மூலம் அவற்றை மீண்டும் எஸ்கலேட் செய்யவும்.
உங்கள் Talkdesk Studio பாய்வு, அழைப்பாளரை interaction id மற்றும் UUI உடன் ஏஜென்ட்டுக்கு அனுப்புகிறது. அழைப்பாளருக்கு ஒரு நபர் தேவைப்படும்போது, ஏஜென்ட் SIP REFER மூலம் Talkdesk-க்கு எஸ்கலேட் செய்கிறது; hand-off id ஒரு Studio மாறியில் சேமிக்கப்படுகிறது.
தொடங்குவதற்கு முன்
- ஒரு ThunderPhone ஏஜென்ட் மற்றும் நிறுவன API விசை.
- Talkdesk உரையாடல் ஒருங்கிணைப்பாளர் உரிமம், இது வெளிப்புற குரல் ஸ்ட்ரீம் பயன்முறையில் உள்ள Studio Autopilot குரலுடன் இணை கூறை உள்ளடக்கும் (Talkdesk கட்டுரை). ஏஜென்ட் அழைப்பை வைத்திருக்கும் ஒவ்வொரு நிமிடத்திற்கும் Talkdesk கட்டணம் வசூலிக்கும்.
1. SIP எண்ட்பாயிண்ட்டை உருவாக்கவும்
Talkdesk ஒரு IP அனுமதிப்பட்டியலை மட்டுமே ஆவணப்படுத்துகிறது; எனவே மூல முகவரி மூலம் அழைப்புகளை ஏற்கும் எண்ட்பாயிண்ட்டை உருவாக்கவும்:
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 12,
"name": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'Talkdesk கட்டுரை, அது SRTP வழியாக ஆடியோவை அனுப்புவதாகக் கூறுகிறது; "srtp": "optional"
என்பது Talkdesk வழங்கும்போது SRTP-யில் பதிலளிக்கிறது. Talkdesk-க்கு SRTP
தேவையா என்பதை அந்தக் கட்டுரை கூறவில்லை; தேவை என Talkdesk உங்களிடம் தெரிவித்தால்,
SRTP இல்லாத அழைப்புகளை மறுக்கும் required ஆக srtp-ஐ அமைக்கவும்.
Talkdesk-இலிருந்து Talkdesk-ன் SIP சிக்னலிங் வரம்புகளைப் பெறவும். ஒவ்வொன்றும் /16
அல்லது அதைவிடக் குறுகிய பொது IPv4 வரம்பாக இருக்க வேண்டும் (IPv6-க்கு /48 அல்லது அதைவிடக் குறுகியதாக).
மூல IP மூலம் அங்கீகரிக்கும் தளங்கள் என்பதைப் பார்க்கவும்.
Talkdesk, ஒவ்வொரு Twilio வாடிக்கையாளரும் பகிரும் Twilio நெட்வொர்க்கிலிருந்து SIP-ஐ அனுப்புகிறது;
எனவே மற்ற அழைப்பாளர்களைத் தடுப்பது எண்ட்பாயிண்ட்டின் முகவரிதான்: அதை
வெளியிடாதீர்கள்.
பதிலில் உள்ள sip_uri-ஐ வைத்துக்கொள்ளவும், எடுத்துக்காட்டாக
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. சூழலுடன் அழைப்புகளை அனுப்பவும்
உங்கள் Studio பாய்வில், வெளிப்புற குரல் ஸ்ட்ரீம் பயன்முறையில் Autopilot குரலுடன் இணை என்பதைச் சேர்த்து, அதன் இலக்கை ;transport=tls சேர்க்கப்பட்ட எண்ட்பாயிண்ட்டின் sip_uri ஆக அமைக்கவும், எடுத்துக்காட்டாக sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. வேறுவிதமாகக் கூறப்படாவிட்டால் Twilio-வின் SIP பயன்படுத்தும் UDP வழியான அழைப்புகளை எண்ட்பாயிண்ட் மறுக்கும்.
Talkdesk அனுப்புவது:
- அழைப்பின்
external_call_idஆகச் சேமிக்கப்படும்X-Talkdesk-Interaction-Id; business_hours=openபோன்ற ஹெக்ஸ்-குறியிடப்பட்டUser-to-User. இது{{sip_uui}}ஆகக் குறியீட்டுநீக்கப்பட்ட நிலையில் prompt-ஐ அடைகிறது.
இந்தக் கூறின் பதிப்பு 2.1, வரையறுக்கப்பட்ட தலைப்புகளையும் அனுப்ப முடியும். Talkdesk-ன் விருப்பங்கள் பக்கம் அவற்றை WebSocket வழியாக அனுப்பப்படும் JSON என விவரிக்கிறது; எனவே அவற்றை நம்புவதற்கு முன் அவை SIP தலைப்புகளாக வருகிறதா என்பதை Talkdesk-இடம் உறுதிப்படுத்தவும்.
3. அழைப்பை மீண்டும் பெறுக
ஏஜென்ட், Talkdesk இதைப் படிக்கும் ஒரே இடமான அதன் எஸ்கலேஷன் முகவரிக்கு,
அந்த முகவரிக்குள் hex UUI ஆக ஒப்படைப்பு ஐடியுடன் REFER மூலம் மேல்நிலைக்கு அனுப்புகிறது.
இந்த பரிமாற்ற எண்ணைச் சேர்க்கவும் (பார்க்கவும்
பரிமாற்ற எண்ணைச் சேர்க்கவும்
மற்றும் பரிமாற்ற முகவரிக்குள் உள்ள ஹெடர்கள்):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}முகவரி Talkdesk கட்டுரையில் உள்ளதே. காம்பொனென்ட்டின் 2.1 பதிப்பு
autopilot_result=-ஐப் படிக்கும்; 1.7 பதிப்பு escalate_to=-ஐப் படிக்கும், எனவே
1.7-இல் அந்த விசையைப் பயன்படுத்தவும். REFER இவ்வாறு இருக்கும்:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk மதிப்பை ஒரு ஸ்டுடியோ மாறியில் வைக்கிறது. சுருக்கத்தையும் நோக்கத்தையும் பெற, கனெக்ஷன்ஸ் மூலம் உருவாக்கப்பட்ட தனிப்பயன் ஒருங்கிணைப்பில் செயலை இயக்குக படியைச் சேர்க்கவும்:
- அங்கீகார வகை API விசை, ஹெடர் பெயர்
Authorization, மதிப்புBearer sk_live_…. - கோரிக்கை:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=என்பதற்குப் பின் மாறியிலுள்ள ஐடி. இன்டராக்ஷன் ஐடியைப் பயன்படுத்திexternal_call_idமூலம் அழைப்பைத் தேடவும் முடியும். handoff.intentஅடிப்படையில் வழிமாற்றம் செய்து,handoff.summary-ஐ அழைப்பை ஏற்கும் நபருக்குக் காட்டவும்.
ஒப்படைக்கப்பட்ட அழைப்பைத் தேடுக என்பதைப் பார்க்கவும்.
இதைச் சோதிக்கவும்
ஸ்டுடியோ ஃப்ளோ மூலம் அழைப்பைத் தொடங்கி, ஒரு நபரிடம் இணைக்குமாறு ஏஜென்ட்டிடம் கேட்டு,
அதன் மாறியில் ஒப்படைப்பு ஐடியுடன் காம்பொனென்ட்டைக் கடந்து ஃப்ளோ தொடர்வதைச் சரிபார்க்கவும்.
பின்னர் GET /v1/calls/{call_id} மூலம் அழைப்பைத் திறக்கவும்:
external_call_id என்பது Talkdesk இன்டராக்ஷன் ஐடியாக இருக்க வேண்டும்.
வரம்புகள்
- Talkdesk அதிகபட்சம் 256 பைட்டுகள் UUI-ஐப் படிக்கும்; மேலும்
|அல்லது;மூலம் பிரிக்கப்பட்ட மதிப்புகளை அனுமதிக்காது, எனவே ஒரு மதிப்பை மட்டும் அனுப்பவும். ஒப்படைப்பு ஐடி இதில் பொருந்தும். - Talkdesk API-களால் ஏஜென்ட்டின் உரையாடல் பதிவேட்டைப் படிக்க முடியாது. அதற்குப் பதிலாக
ஒப்படைப்பு தேடலை அல்லது
GET /v1/calls/{call_id}-ஐப் பயன்படுத்தவும்.