Open in
Talkdesk वरून कनेक्ट करा
Connect to Autopilot Voice वापरून Talkdesk कॉल ThunderPhone एजंटकडे पाठवा आणि UUI मधील hand-off 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 सिग्नलिंग श्रेण्या मिळवा. प्रत्येक श्रेणी सार्वजनिक IPv4
ची /16 किंवा त्यापेक्षा अरुंद श्रेणी असणे आवश्यक आहे (IPv6 ची /48 किंवा त्यापेक्षा अरुंद). पहा
स्रोत IP द्वारे प्रमाणीकरण करणारे प्लॅटफॉर्म.
Talkdesk Twilio च्या नेटवर्कवरून SIP पाठवते, ज्याचे पत्ते प्रत्येक Twilio ग्राहक
सामायिक करतो, त्यामुळे इतर कॉल करणाऱ्यांना रोखणारा घटक म्हणजे एंडपॉइंटचा पत्ता आहे: तो
प्रकाशित करू नका.
प्रतिसादातील sip_uri जतन करा, उदाहरणार्थ
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. संदर्भासह कॉल पाठवा
तुमच्या Studio फ्लोमध्ये, बाह्य व्हॉइस
स्ट्रीम मोडमध्ये ऑटोपायलट व्हॉइसशी कनेक्ट करा जोडा आणि त्याचे लक्ष्य एंडपॉइंटच्या sip_uri वर सेट करा, त्यात ;transport=tls जोडा, उदाहरणार्थ
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. एंडपॉइंट
UDP वरील कॉल नाकारतो, जो वेगळे सांगितल्याशिवाय Twilio चा SIP वापरतो.
Talkdesk पाठवते:
X-Talkdesk-Interaction-Id, जो कॉलचाexternal_call_idम्हणून साठवला जातो;User-to-User, हेक्स-एन्कोड केलेले, जसे कीbusiness_hours=open. ते डीकोड होऊन prompt पर्यंत{{sip_uui}}म्हणून पोहोचते.
घटकाची आवृत्ती 2.1 परिभाषित हेडर्स देखील पाठवू शकते. Talkdesk चे प्राधान्ये पृष्ठ त्यांचे वर्णन WebSocket वरून पाठवलेल्या JSON असे करते, त्यामुळे त्यांच्यावर अवलंबून राहण्यापूर्वी ते SIP हेडर्स म्हणून येतात का याची Talkdesk कडून खात्री करा.
3. कॉल परत मिळवा
एजंट Talkdesk च्या एस्कलेशन पत्त्यावर REFER सह एस्कलेट करतो, ज्यामध्ये
हस्तांतरण आयडी त्या पत्त्यात हेक्स UUI म्हणून असतो; 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=नंतर व्हेरिएबलमधील आयडी. तुम्ही इंटरॅक्शन आयडीसहexternal_call_idवापरूनही कॉल शोधू शकता. handoff.intentनुसार रूट करा आणि कॉल घेणाऱ्या व्यक्तीलाhandoff.summaryदाखवा.
पहा हस्तांतरित केलेला कॉल शोधा.
त्याची चाचणी करा
Studio फ्लोद्वारे कॉल सुरू करा, एजंटकडे एखाद्या व्यक्तीची मागणी करा आणि
त्याच्या व्हेरिएबलमध्ये हस्तांतरण आयडीसह फ्लो घटकापुढे सुरू राहतो का ते तपासा.
नंतर GET /v1/calls/{call_id} सह कॉल उघडा:
external_call_id हा Talkdesk इंटरॅक्शन आयडी असावा.
मर्यादा
- Talkdesk जास्तीत जास्त 256 बाइट्स UUI वाचतो आणि
|किंवा;ने विभक्त केलेली मूल्ये स्वीकारत नाही, त्यामुळे एकच मूल्य पाठवा. हस्तांतरण आयडी बसतो. - Talkdesk चे API एजंटचे ट्रान्सक्रिप्ट वाचू शकत नाहीत. त्याऐवजी हस्तांतरण
शोध किंवा
GET /v1/calls/{call_id}वापरा.