Open in
Amazon Connect-ൽ നിന്ന് കണക്റ്റ് ചെയ്യുക
കോൺടാക്റ്റ് IDയും UUIയും ഉപയോഗിച്ച് Amazon Connect കോളുകൾ SIP വഴി ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക, തുടർന്ന് ഏജന്റിന്റെ ഹാൻഡ്-ഓഫ് ഉപയോഗിച്ച് നിങ്ങളുടെ ഫ്ലോ പുനരാരംഭിക്കുക.
നിങ്ങളുടെ Amazon Connect ഫ്ലോ, കോൺടാക്റ്റ് id-യും നിങ്ങൾ സജ്ജമാക്കുന്ന ഏതെങ്കിലും UUI-യും സഹിതം വിളിക്കുന്നയാളെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. ഏജന്റ് പൂർത്തിയാക്കുമ്പോൾ, അത് കോൾ വിച്ഛേദിക്കുന്നു, നിങ്ങളുടെ ഫ്ലോ തുടരുന്നു, കോൺടാക്റ്റ് id ഉപയോഗിച്ച് ഒരു Lambda ഹാൻഡ്-ഓഫ് ലഭ്യമാക്കുന്നു.
ആരംഭിക്കുന്നതിന് മുമ്പ്
- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ API കീ-യും.
- Amazon Connect-ന്റെ ബാഹ്യ വോയ്സ് ട്രാൻസ്ഫർ കണക്റ്റർ. ആദ്യം "ഓരോ അക്കൗണ്ടിലുമുള്ള ബാഹ്യ വോയ്സ് ട്രാൻസ്ഫർ കണക്റ്ററുകൾ" ക്വാട്ട വർധനവ് അഭ്യർത്ഥിക്കുക: AWS അംഗീകരിക്കുന്നതുവരെ മെനു മറഞ്ഞുകിടക്കും. ഓരോ കണക്റ്ററിനും AWS പ്രതിദിനം ബിൽ ചെയ്യുന്നു ($100 പ്രതിദിനം, 2025 ജൂലൈ 21 മുതൽ) കൂടാതെ മിനിറ്റിന് ഉപയോഗ നിരക്കും ഈടാക്കുന്നു.
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 കോൾ കണ്ടെത്തുന്നു:
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 സെക്കൻഡിന് ശേഷം ടൈംഔട്ട് ആകും.