Open in
Amazon Connect இலிருந்து இணைக்கவும்
contact id மற்றும் UUI உடன் Amazon Connect அழைப்புகளை SIP வழியாக ThunderPhone ஏஜென்ட்டிற்கு அனுப்பி, ஏஜென்ட்டின் hand-off மூலம் உங்கள் flow-ஐத் தொடரவும்.
உங்கள் Amazon Connect flow, contact ID மற்றும் நீங்கள் அமைக்கும் எந்த UUI-உடனும் அழைப்பாளரை ஏஜென்ட்டிற்கு அனுப்பும். ஏஜென்ட் முடித்ததும், அது அழைப்பைத் துண்டிக்கும், உங்கள் flow தொடரும், மேலும் ஒரு Lambda contact ID மூலம் ஒப்படைப்பைப் பெறும்.
தொடங்குவதற்கு முன்
- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவனம் API விசை.
- Amazon Connect-இன் வெளிப்புற குரல் பரிமாற்றம் இணைப்பி. முதலில் "ஒரு கணக்கிற்கான வெளிப்புற குரல் பரிமாற்ற இணைப்பிகள்" quota அதிகரிப்பைக் கோருங்கள்: AWS அதை அங்கீகரிக்கும் வரை மெனு மறைந்தே இருக்கும். AWS ஒவ்வொரு இணைப்பிக்கும் ஒரு நாளுக்கு கட்டணம் வசூலிக்கும் ($100 ஒரு நாள், July 21, 2025 முதல்) மற்றும் நிமிடப் பயன்பாட்டிற்கும் கூடுதல் கட்டணம் வசூலிக்கும்.
1. SIP endpoint-ஐ உருவாக்குங்கள்
இந்த இணைப்பி SIP digest அங்கீகாரத்தை ஆவணப்படுத்தவில்லை; எனவே மூல முகவரி மூலம் அழைப்புகளை ஏற்கும் ஒரு endpoint-ஐ உருவாக்குங்கள்:
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-இடமிருந்து பெறுங்கள். ஒவ்வொன்றும்
/16 அல்லது அதைவிடக் குறுகலான பொது IPv4 வரம்பாக இருக்க வேண்டும் (IPv6 /48 அல்லது அதைவிடக் குறுகலானது). விதிகள் மற்றும் தளத்தின்
ஒவ்வொரு வாடிக்கையாளரும் பகிரக்கூடிய முகவரியின் ஆபத்து பற்றிய விவரங்களுக்கு
மூல IP மூலம் அங்கீகரிக்கும் தளங்கள்
பார்க்கவும். பதிலில் உள்ள sip_uri-ஐ வைத்திருங்கள், உதாரணமாக
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. சூழலுடன் அழைப்புகளை அனுப்புங்கள்
- Amazon Connect console-இல், வெளிப்புற குரல் அமைப்புகள் → குரல் பரிமாற்ற ஒருங்கிணைப்புகள் என்பதைத் திறந்து உருவாக்கு என்பதைத் தேர்ந்தெடுக்கவும்.
- இலக்கு வகையை (ஒரு SBC) தேர்ந்தெடுத்து, host
sip.thunderphone.com, port5061, மற்றும் TLS நெறிமுறையுடன் ஒரு வெளிச்செல்லும் route-ஐச் சேர்க்கவும். இந்த endpoint-க்கு TLS அல்லது TCP (port5060) தேவை; அது UDP-ஐ நிராகரிக்கும். இணைப்பி எந்த நெறிமுறைகளை வழங்குகிறது என்பதை AWS ஆவணப்படுத்தவில்லை; எனவே அவற்றில் ஒன்றைப் பயன்படுத்த முடியும் என்பதை AWS-இடம் உறுதிப்படுத்துங்கள். - உங்கள் flow-இல், தொலைபேசி எண்ணுக்கு பரிமாற்று block-ஐச் சேர்த்து, பரிமாற்று
என்பதை வெளிப்புற குரல் அமைப்பு என அமைக்கவும்; பின்னர் இதை அமைக்கவும்:
- இலக்கு ARN: இணைப்பி.
- பயனருக்கு: endpoint-இன்
sip_uri-இல் உள்ள பயனர் பகுதி, உதாரணமாகagent-12-jhxmginwjx. - UUI (விருப்பமானது): ஏஜென்ட்டிற்கான சூழல். Connect இதை hex-encoded வடிவில் அனுப்பும்.
- இணைப்பு துண்டிக்கப்பட்ட பிறகு flow-ஐத் தொடரவும்: ஆம், இதனால் ஏஜென்ட் அழைப்பைத் துண்டிக்கும்போது flow தொடரும்.
Connect, contact ID-ஐ X-Amzn-ConnectContactId-இல் அனுப்பும். ThunderPhone அதை அழைப்பின்
external_call_id ஆகச் சேமிக்கும்; இதன் மூலமே உங்கள் flow பின்னர் அழைப்பைக் கண்டறியும். UUI,
prompt-ஐ {{sip_uui}} ஆக அடையும். மூன்றாம் தரப்பு ஒருங்கிணைப்புகள் contact-ID header-ஐ
ஆவணப்படுத்துகின்றன; AWS-இன் சொந்த ஆவணங்கள் அவ்வாறு செய்யவில்லை, எனவே உங்கள் முதல்
சோதனை அழைப்பில் அதைச் சரிபார்க்கவும்.
3. அழைப்பை மீண்டும் பெறுங்கள்
BYE-இல் தலைப்புகளைப் படிக்கவோ அல்லது ஏஜென்டிடமிருந்து REFER-ஐ ஏற்கவோ Connect-க்கு வழி இல்லை என்று AWS ஆவணப்படுத்துகிறது. எனவே ஏஜென்ட் அழைப்பைத் திருப்பி அனுப்புகிறது: அது விடைபெற்று அழைப்பை முடிக்கிறது, மேலும் பரிமாற்றத் தொகுதிக்குப் பிறகு உங்கள் ஓட்டம் தொடர்கிறது. இந்தப் பரிமாற்ற எண்ணைச் சேர்க்கவும் (பரிமாற்ற எண்ணைச் சேர்க்கவும் பார்க்கவும்):
{"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 தலைப்பு இரண்டிலும் இருக்க வேண்டும்.
வரம்புகள்
X-TP-Handoff-Idஉட்படBYE-இல் தலைப்புகளைப் படிப்பதற்கான வழியை AWS ஆவணப்படுத்தவில்லை; எனவே அழைப்புக்கான ஒரே இணைப்பு தொடர்பு அடையாளம்தான்.- இணைப்பிக்கான அதிகபட்ச UUI நீளத்தை AWS ஆவணப்படுத்தவில்லை.
- ஒத்திசைவு Lambda தொகுதி 8 வினாடிகளுக்குப் பிறகு நேரம் முடிவடையும்.