Open in
Amazon Connect నుండి కనెక్ట్ చేయండి
కాంటాక్ట్ ID మరియు UUIతో Amazon Connect కాల్లను SIP ద్వారా ThunderPhone ఏజెంట్కు పంపి, ఏజెంట్ హ్యాండ్-ఆఫ్తో మీ ఫ్లోను కొనసాగించండి.
మీ Amazon Connect ఫ్లో, కాలర్ను కాంటాక్ట్ ID మరియు మీరు సెట్ చేసిన ఏవైనా UUIతో ఏజెంట్కు పంపుతుంది. ఏజెంట్ పని పూర్తిచేసినప్పుడు, అది కాల్ను ముగిస్తుంది, మీ ఫ్లో కొనసాగుతుంది, మరియు ఒక Lambda కాంటాక్ట్ ID ద్వారా హ్యాండ్-ఆఫ్ను పొందుతుంది.
ప్రారంభించే ముందు
- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ API కీ.
- Amazon Connect యొక్క బాహ్య వాయిస్ బదిలీ కనెక్టర్. ముందుగా "ఖాతాకు బాహ్య వాయిస్ బదిలీ కనెక్టర్లు" కోటా పెంపుదలను అభ్యర్థించండి: AWS ఆమోదించే వరకు మెను కనిపించదు. AWS ప్రతి కనెక్టర్కు రోజుకు ఛార్జ్ చేస్తుంది (జూలై 21, 2025 నుండి రోజుకు $100) మరియు ప్రతి నిమిషం వినియోగ ఛార్జీలు అదనం.
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"]
}'మీ Region కోసం కనెక్టర్ యొక్క SIP సిగ్నలింగ్ పరిధులను AWS నుండి పొందండి. ప్రతి దానీ
/16 లేదా దాని కంటే సన్నని పబ్లిక్ IPv4 పరిధి అయి ఉండాలి (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 కాంటాక్ట్ IDని X-Amzn-ConnectContactIdలో పంపుతుంది. ThunderPhone దాన్ని కాల్ యొక్క external_call_idగా నిల్వ చేస్తుంది, దీనివల్ల మీ ఫ్లో తర్వాత కాల్ను కనుగొంటుంది. UUI, {{sip_uui}}గా promptకు చేరుతుంది. మూడవ పక్ష ఇంటిగ్రేషన్లు కాంటాక్ట్-ID హెడర్ను డాక్యుమెంట్ చేస్తాయి; AWS స్వంత డాక్యుమెంటేషన్లో అది లేదు, కాబట్టి మీ మొదటి పరీక్ష కాల్లో దాన్ని పరిశీలించండి.
3. కాల్ను తిరిగి పొందండి
BYEలో హెడర్లను చదవడానికి లేదా ఏజెంట్ నుండి REFERను స్వీకరించడానికి Connectలో మార్గం లేదని AWS డాక్యుమెంట్ చేస్తుంది. కాబట్టి ఏజెంట్ కాల్ను తిరిగి పంపుతుంది: వీడ్కోలు చెప్పి కాల్ను ముగిస్తుంది, ఆపై ట్రాన్స్ఫర్ బ్లాక్ తర్వాత మీ ఫ్లో కొనసాగుతుంది. ఈ ట్రాన్స్ఫర్ నంబర్ను జోడించండి (ట్రాన్స్ఫర్ నంబర్ను జోడించండి చూడండి):
{"name": "Amazon Connect", "action": "return"}తర్వాత ట్రాన్స్ఫర్ అనంతరం AWS Lambda ఫంక్షన్ను ఇన్వోక్ చేయండి బ్లాక్తో హ్యాండ్-ఆఫ్ను పొందండి. Lambda కాంటాక్ట్ ID ద్వారా కాల్ను వెతుకుతుంది:
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 హెడర్లోనూ ఉండాలి.
పరిమితులు
X-TP-Handoff-Idతో సహాBYEలో హెడర్లను చదవడానికి మార్గం లేదని AWS డాక్యుమెంట్ చేస్తుంది, కాబట్టి కాల్కు తిరిగి ఉన్న ఏకైక లింక్ కాంటాక్ట్ ID మాత్రమే.- కనెక్టర్ కోసం గరిష్ఠ UUI పొడవును AWS డాక్యుమెంట్ చేయదు.
- సింక్రోనస్ Lambda బ్లాక్ 8 సెకన్ల తర్వాత టైమ్ అవుట్ అవుతుంది.