Open in
Talkdesk నుండి కనెక్ట్ చేయండి
Autopilot Voiceకు కనెక్ట్ చేయడం ద్వారా Talkdesk కాల్లను ThunderPhone ఏజెంట్కు పంపండి మరియు UUIలోని హ్యాండ్-ఆఫ్ IDతో వాటిని తిరిగి ఎస్కలేట్ చేయండి.
మీ Talkdesk Studio ఫ్లో కాలర్ను ఇంటరాక్షన్
ID మరియు UUIతో ఏజెంట్కు పంపుతుంది. కాలర్కు ఒక వ్యక్తి అవసరమైనప్పుడు, ఏజెంట్ SIP
REFER ద్వారా Talkdeskకు ఎస్కలేట్ చేస్తుంది, మరియు హ్యాండ్-ఆఫ్ ID ఒక Studio వేరియబుల్లోకి వస్తుంది.
ప్రారంభించడానికి ముందు
- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ API కీ.
- ఒక Talkdesk కన్వర్సేషన్ ఆర్కెస్ట్రేటర్ లైసెన్స్, ఇది ఎక్స్టర్నల్ వాయిస్ స్ట్రీమ్ మోడ్లోని Studio ఆటోపైలట్ వాయిస్కు కనెక్ట్ చేయండి కాంపొనెంట్ను కవర్ చేస్తుంది (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గా సెట్ చేయండి, ఇది అది లేని
కాల్లను తిరస్కరిస్తుంది.
Talkdesk నుండి Talkdesk యొక్క SIP సిగ్నలింగ్ శ్రేణులను పొందండి. ప్రతి శ్రేణి /16 లేదా మరింత
సంకుచితమైన పబ్లిక్ IPv4 శ్రేణి అయి ఉండాలి (IPv6లో /48 లేదా మరింత సంకుచితం). చూడండి
సోర్స్ IP ద్వారా ప్రామాణీకరించే ప్లాట్ఫారమ్లు.
Talkdesk ప్రతి Twilio కస్టమర్ పంచుకునే Twilio నెట్వర్క్ నుండి SIPను పంపుతుంది, కాబట్టి ఇతర
కాలర్లను నిరోధించేది ఎండ్పాయింట్ చిరునామానే: దానిని ప్రచురించవద్దు.
ప్రతిస్పందనలోని sip_uriను ఉంచుకోండి, ఉదాహరణకు
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. సందర్భంతో కాల్లను పంపండి
మీ Studio ఫ్లోలో, ఎక్స్టర్నల్ వాయిస్
స్ట్రీమ్ మోడ్లో ఆటోపైలట్ వాయిస్కు కనెక్ట్ చేయండిని జోడించి, దాని లక్ష్యాన్ని ;transport=tls జోడించిన ఎండ్పాయింట్
sip_uriగా సెట్ చేయండి, ఉదాహరణకు sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Twilio యొక్క SIPకు వేరే విధంగా
చెప్పకపోతే UDPని ఉపయోగిస్తుంది, కాబట్టి ఎండ్పాయింట్ UDP ద్వారా వచ్చే కాల్లను తిరస్కరిస్తుంది.
Talkdesk పంపేవి:
X-Talkdesk-Interaction-Id, ఇది కాల్ యొక్కexternal_call_idగా నిల్వ అవుతుంది;User-to-User, హెక్స్-ఎన్కోడ్ చేసినది, ఉదాహరణకుbusiness_hours=open. ఇది డీకోడ్ అయి{{sip_uui}}గా promptకు చేరుతుంది.
కాంపొనెంట్ వెర్షన్ 2.1 నిర్వచించిన హెడర్లును కూడా పంపగలదు. Talkdesk యొక్క ప్రాధాన్యతల పేజీ వాటిని WebSocket ద్వారా పంపే JSONగా వివరిస్తుంది, కాబట్టి వాటిపై ఆధారపడే ముందు అవి SIP హెడర్లుగా వస్తాయో లేదో Talkdeskతో నిర్ధారించండి.
3. కాల్ను తిరిగి పొందండి
ఏజెంట్ Talkdesk ఎస్కలేషన్ చిరునామాకు REFER ద్వారా ఎస్కలేట్ చేస్తుంది. ఆ
చిరునామాలో hex UUIగా ఉన్న హ్యాండ్-ఆఫ్ IDని మాత్రమే Talkdesk చదువుతుంది.
ఈ బదిలీ నంబర్ను జోడించండి (చూడండి
బదిలీ నంబర్ను జోడించండి
మరియు బదిలీ చిరునామాలోని హెడర్లు):
{
"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 ఈ విలువను Studio వేరియబుల్లో ఉంచుతుంది. సారాంశం మరియు ఉద్దేశ్యాన్ని పొందడానికి, Connectionsతో రూపొందించిన అనుకూల ఇంటిగ్రేషన్లో చర్యను అమలు చేయండి దశను జోడించండి:
- ఆథ్ రకం API కీ, హెడర్ పేరు
Authorization, విలువBearer sk_live_…. - అభ్యర్థన:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=తర్వాత వేరియబుల్లోని IDని జోడించండి. ఇంటరాక్షన్ IDతోexternal_call_idద్వారా కూడా కాల్ను చూడవచ్చు. handoff.intentఆధారంగా రూట్ చేయండి, కాల్ తీసుకునే వ్యక్తికిhandoff.summaryను చూపించండి.
చూడండి హ్యాండ్-ఆఫ్ చేసిన కాల్ను చూడండి.
దీన్ని పరీక్షించండి
Studio ఫ్లో ద్వారా కాల్ ప్రారంభించి, ఏజెంట్ను ఒక వ్యక్తికి బదిలీ చేయమని అడగండి,
ఆపై హ్యాండ్-ఆఫ్ ID దాని వేరియబుల్లో ఉండగా ఫ్లో కాంపొనెంట్ను దాటి
కొనసాగుతుందో తనిఖీ చేయండి. తర్వాత GET /v1/calls/{call_id}తో కాల్ను తెరవండి:
external_call_id అనేది Talkdesk ఇంటరాక్షన్ ID అయి ఉండాలి.
పరిమితులు
- Talkdesk గరిష్ఠంగా 256 బైట్ల UUIని మాత్రమే చదువుతుంది మరియు
|లేదా;తో వేరు చేసిన విలువలను అనుమతించదు, కాబట్టి ఒకే విలువను పంపండి. హ్యాండ్-ఆఫ్ ID సరిపోతుంది. - Talkdesk APIలు ఏజెంట్ ట్రాన్స్క్రిప్ట్ను చదవలేవు. బదులుగా హ్యాండ్-ఆఫ్ లుకప్
లేదా
GET /v1/calls/{call_id}ను ఉపయోగించండి.