Open in
Amazon Connect वरून कनेक्ट करा
संपर्क आयडी आणि UUI सह Amazon Connect कॉल्स SIP द्वारे ThunderPhone एजंटकडे पाठवा आणि एजंटच्या हँड-ऑफसह तुमचा फ्लो पुन्हा सुरू करा.
तुमचा Amazon Connect फ्लो कॉलरला कॉन्टॅक्ट आयडी आणि तुम्ही सेट केलेल्या कोणत्याही UUI सह एजंटकडे पाठवतो. एजंटचे काम पूर्ण झाल्यावर तो कॉल संपवतो, तुमचा फ्लो पुढे सुरू राहतो आणि Lambda कॉन्टॅक्ट आयडीद्वारे हँड-ऑफ मिळवते.
सुरू करण्यापूर्वी
- ThunderPhone एजंट आणि संस्थेची API की.
- Amazon Connect चा बाह्य व्हॉइस ट्रान्सफर कनेक्टर. प्रथम "प्रति खात्यासाठी बाह्य व्हॉइस ट्रान्सफर कनेक्टर्स" कोटा वाढवण्याची विनंती करा: AWS मंजुरी देईपर्यंत मेनू लपलेला राहतो. AWS प्रत्येक कनेक्टरसाठी प्रतिदिन ($100 प्रतिदिन, 21 जुलै 2025 पासून) तसेच प्रति-मिनिट वापरासाठी शुल्क आकारते.
1. SIP एंडपॉइंट तयार करा
कनेक्टर SIP डायजेस्ट प्रमाणीकरणाचे दस्तऐवजीकरण करत नाही, म्हणून स्रोत पत्त्याद्वारे कॉल स्वीकारणारा एंडपॉइंट तयार करा:
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": "Amazon Connect",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
}'तुमच्या प्रदेशासाठी कनेक्टरच्या SIP सिग्नलिंग श्रेणी AWS कडून मिळवा. प्रत्येक श्रेणी
सार्वजनिक IPv4 ची /16 किंवा त्याहून अरुंद श्रेणी (IPv6 ची /48 किंवा त्याहून अरुंद)
असणे आवश्यक आहे. नियमांसाठी आणि प्लॅटफॉर्मच्या प्रत्येक ग्राहकासोबत सामायिक असलेल्या
पत्त्याच्या धोक्यासाठी
स्रोत IP द्वारे प्रमाणीकरण करणारे प्लॅटफॉर्म
पाहा. प्रतिसादातील sip_uri जतन करा, उदाहरणार्थ
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. संदर्भासह कॉल पाठवा
- Amazon Connect कन्सोलमध्ये, बाह्य व्हॉइस सिस्टिम्स → व्हॉइस ट्रान्सफर इंटिग्रेशन्स उघडा आणि तयार करा निवडा.
- गंतव्य प्रकार (SBC) निवडा आणि होस्ट
sip.thunderphone.com, पोर्ट5061आणि TLS प्रोटोकॉलसह आउटबाउंड रूट जोडा. एंडपॉइंटला TLS किंवा TCP (पोर्ट5060) आवश्यक आहे आणि तो UDP नाकारतो. कनेक्टर कोणते प्रोटोकॉल देते याचे AWS दस्तऐवजीकरण करत नाही, म्हणून ते यापैकी एक वापरू शकते याची AWS कडून पुष्टी करा. - तुमच्या फ्लोमध्ये फोन नंबरवर ट्रान्सफर करा ब्लॉक जोडा, ज्यामध्ये ट्रान्सफर
करा हे बाह्य व्हॉइस सिस्टिम वर सेट करा, आणि पुढील सेट करा:
- गंतव्य ARN: कनेक्टर.
- वापरकर्त्यासाठी: एंडपॉइंटच्या
sip_uriमधील वापरकर्ता भाग, जसे कीagent-12-jhxmginwjx. - UUI (पर्यायी): एजंटसाठी संदर्भ. Connect ते हेक्स-एन्कोड करून पाठवते.
- डिस्कनेक्ट झाल्यानंतर फ्लो पुन्हा सुरू करा: होय, जेणेकरून एजंट कॉल संपवल्यावर फ्लो पुढे सुरू राहील.
Connect X-Amzn-ConnectContactId मध्ये कॉन्टॅक्ट आयडी पाठवते. ThunderPhone तो
कॉलच्या external_call_id म्हणून जतन करते, ज्याद्वारे तुमचा फ्लो नंतर कॉल शोधतो.
UUI prompt पर्यंत {{sip_uui}} म्हणून पोहोचते. तृतीय-पक्ष इंटिग्रेशन्स
कॉन्टॅक्ट-आयडी हेडरचे दस्तऐवजीकरण करतात; AWS चे स्वतःचे दस्तऐवज तसे करत नाहीत,
म्हणून तुमच्या पहिल्या चाचणी कॉलमध्ये ते तपासा.
3. कॉल परत मिळवा
AWS मध्ये Connect ला BYE वरील हेडर वाचण्याचा किंवा एजंटकडून REFER स्वीकारण्याचा कोणताही मार्ग दस्तऐवजीकृत नाही. त्यामुळे एजंट कॉल परत करतो: तो निरोप देतो आणि कॉल बंद करतो, आणि ट्रान्सफर ब्लॉकनंतर तुमचा फ्लो पुन्हा सुरू होतो. हा ट्रान्सफर नंबर जोडा (ट्रान्सफर नंबर जोडा पहा):
{"name": "Amazon Connect", "action": "return"}त्यानंतर ट्रान्सफरनंतरच्या AWS Lambda फंक्शन इनव्होक करा ब्लॉकद्वारे हँड-ऑफ मिळवा. Lambda कॉन्टॅक्ट आयडीनुसार कॉल शोधते:
import json
import os
import urllib.error
import urllib.parse
import urllib.request
def lambda_handler(event, context):
contact_id = event["Details"]["ContactData"]["ContactId"]
url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
{"external_call_id": contact_id}
)
request = urllib.request.Request(
url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
)
try:
with urllib.request.urlopen(request, timeout=5) as response:
call = json.load(response)
except (urllib.error.URLError, TimeoutError):
return {"found": "false"}
handoff = call.get("handoff") or {}
return {
"found": "true",
"intent": handoff.get("intent") or "",
"summary": handoff.get("summary") or "",
}ब्लॉक फ्लॅट मॅप परत करतो, त्यामुळे फ्लो intent नुसार शाखा करू शकतो किंवा कॉल घेणाऱ्या व्यक्तीसाठी summary कॉन्टॅक्ट अॅट्रिब्यूट म्हणून सेट करू शकतो. ब्लॉक सिंक्रोनसपणे चालवा (8 सेकंदांपर्यंत) आणि API की एन्क्रिप्ट करून संग्रहित करा, उदाहरणार्थ AWS Secrets Manager मध्ये. प्रतिसाद फील्ड हँड-ऑफ केलेला कॉल शोधा मध्ये आहेत.
याची चाचणी घ्या
तुमच्या Connect इन्स्टन्सवरील ट्रान्सफर ब्लॉकपर्यंत पोहोचणाऱ्या नंबरवर कॉल करा, एजंटला एखाद्या व्यक्तीसाठी विचारा आणि फ्लो पुन्हा सुरू होतो याची तपासणी करा. नंतर GET /v1/calls/{call_id} वापरून कॉल उघडा: sip_headers मध्ये x-amzn-connectcontactid सूचीबद्ध असावे आणि external_call_id हे तुमच्या Lambda ला मिळणाऱ्या ContactId बरोबर असावे. SIP 404 सह ट्रान्सफर अयशस्वी झाल्यास, ThunderPhone ला एंडपॉइंटचा वापरकर्ता भाग सापडला नाही: तो रिक्वेस्ट URI आणि To हेडर या दोन्हीमध्ये असणे आवश्यक आहे.
मर्यादा
- AWS मध्ये
X-TP-Handoff-IdसहBYEवरील हेडर वाचण्याचा कोणताही मार्ग दस्तऐवजीकृत नाही, त्यामुळे कॉन्टॅक्ट आयडी हाच कॉलशी परत जोडणारा एकमेव दुवा आहे. - AWS मध्ये कनेक्टरसाठी कमाल UUI लांबी दस्तऐवजीकृत नाही.
- सिंक्रोनस Lambda ब्लॉक 8 सेकंदांनंतर टाइम आउट होतो.