Open in
Unganisha kutoka Amazon Connect
Tuma simu za Amazon Connect kwa ejenti wa ThunderPhone kupitia SIP pamoja na kitambulisho cha mawasiliano na UUI, kisha endelea na mtiririko wako kwa makabidhiano ya ejenti.
Mtiririko wako wa Amazon Connect humtuma mpigaji simu kwa ejenti pamoja na kitambulisho cha mawasiliano na UUI yoyote uliyoweka. Ejenti anapomaliza, hukata simu, mtiririko wako unaendelea, na Lambda huchukua uhamisho kwa kutumia kitambulisho cha mawasiliano.
Kabla ya kuanza
- Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
- Kiunganishi cha Uhamisho wa sauti wa nje cha Amazon Connect. Omba kwanza ongezeko la kikomo cha "Viunganishi vya uhamisho wa sauti wa nje kwa kila akaunti": menyu hubaki fiche hadi AWS iidhinishe. AWS hutoza kila kiunganishi kwa siku ($100 kwa siku tangu Julai 21, 2025) pamoja na matumizi ya kila dakika.
1. Unda endpoint ya SIP
Kiunganishi hakiandiki uthibitishaji wa SIP digest, kwa hivyo unda endpoint inayokubali simu kwa anwani chanzo:
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"]
}'Pata masafa ya uashiriaji wa SIP ya kiunganishi kwa Mkoa wako kutoka AWS. Kila moja lazima liwe
masafa ya umma ya IPv4 ya /16 au membamba zaidi (IPv6 /48 au membamba zaidi). Angalia
Majukwaa yanayothibitisha kwa IP chanzo
kwa sheria na hatari ya anwani inayoshirikiwa na kila mteja wa
jukwaa. Hifadhi sip_uri ya jibu, kwa mfano
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Tuma simu pamoja na muktadha
- Katika dashibodi ya Amazon Connect, fungua Mifumo ya Sauti ya Nje → Miunganisho ya Uhamisho wa Sauti kisha uchague Unda.
- Chagua aina ya lengwa (SBC) na uongeze njia ya kutoka yenye host
sip.thunderphone.com, porti5061na itifaki TLS. Endpoint inahitaji TLS au TCP (porti5060) na hukataa UDP. AWS haielezi ni itifaki zipi kiunganishi hutoa, kwa hivyo thibitisha na AWS kwamba kinaweza kutumia mojawapo yao. - Katika mtiririko wako, ongeza bloku ya Hamisha kwa nambari ya simu huku Hamisha kwa
ikiwekwa kuwa Mfumo wa sauti wa nje, kisha weka:
- ARN ya lengwa: kiunganishi.
- Kwa Mtumiaji: sehemu ya mtumiaji ya
sip_uriya endpoint, kamaagent-12-jhxmginwjx. - UUI (hiari): muktadha wa ejenti. Connect huituma ikiwa imesimbwa kwa hex.
- Endelea na mtiririko baada ya kukatwa: Ndiyo, ili mtiririko uendelee ejenti anapokata simu.
Connect hutuma kitambulisho cha mawasiliano katika X-Amzn-ConnectContactId. ThunderPhone huhifadhi
hiki kama external_call_id ya simu, ambacho ndicho kinachowezesha mtiririko wako kupata simu
baadaye. UUI hufika kwenye prompt kama {{sip_uui}}. Miunganisho ya wahusika wengine
huandika header ya kitambulisho cha mawasiliano; nyaraka za AWS zenyewe hazifanyi hivyo, kwa hivyo ikague kwenye simu yako ya kwanza
ya majaribio.
3. Rejesha simu
AWS haijaweka wazi njia ya Connect kusoma header kwenye BYE au kukubali
REFER kutoka kwa ejenti. Kwa hivyo ejenti hurejesha simu: inaaga na
kukata simu, kisha mtiririko wako unaendelea baada ya blok ya uhamisho. Ongeza nambari hii ya uhamisho (tazama Ongeza nambari ya uhamisho):
{"name": "Amazon Connect", "action": "return"}Kisha leta uhamishaji kwa blok ya Washa kipengele cha AWS Lambda baada ya uhamisho. Lambda huitafuta simu kwa kitambulisho cha mawasiliano:
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 "",
}Blok hurejesha ramani tambarare, kwa hivyo mtiririko unaweza kutenganisha kwa
msingi wa intent au kuweka summary kama sifa ya mawasiliano kwa mtu
anayepokea simu. Endesha blok kwa usawazishaji (hadi sekunde 8) na uhifadhi
ufunguo wa API ukiwa umesimbwa, kwa mfano katika AWS Secrets Manager. Sehemu za
jibu ziko katika
Tafuta simu iliyohamishwa.
Ijaribu
Piga nambari kwenye instansi yako ya Connect inayofikia blok ya uhamisho, omba
ejenti akuunganishe na mtu, na uhakikishe kwamba mtiririko unaendelea. Kisha
fungua simu kwa GET /v1/calls/{call_id}: sip_headers inapaswa kuorodhesha
x-amzn-connectcontactid, na external_call_id inapaswa kuwa sawa na ContactId
ambayo Lambda yako inapokea. Ikiwa uhamisho unashindwa kwa SIP 404, ThunderPhone
haikupata sehemu ya mtumiaji ya endpoint: lazima iwe katika URI ya ombi na header
ya To.
Vikomo
- AWS haijaweka wazi njia ya kusoma header kwenye
BYE, ikijumuishaX-TP-Handoff-Id, kwa hivyo kitambulisho cha mawasiliano ndicho kiungo pekee cha kurejea kwenye simu. - AWS haijaweka wazi urefu wa juu zaidi wa UUI kwa kiunganishi.
- Blok ya Lambda ya usawazishaji huisha muda baada ya sekunde 8.