Open in
Prisijunkite iš Amazon Connect
Per SIP siųskite Amazon Connect skambučius ThunderPhone agentui su kontakto ID ir UUI, o perdavus pokalbį agentui tęskite savo srautą.
Jūsų Amazon Connect srautas siunčia skambinantį asmenį agentui su kontakto ID ir bet kokiu jūsų nustatytu UUI. Kai agentas baigia skambutį, jūsų srautas tęsiamas, o Lambda pagal kontakto ID gauna perdavimo informaciją.
Prieš pradėdami
- ThunderPhone agentas ir organizacijos API raktas.
- Amazon Connect Išorinio balso perdavimo jungtis. Pirmiausia paprašykite padidinti kvotą „Išorinio balso perdavimo jungtys vienai paskyrai“: meniu lieka paslėptas, kol AWS ją patvirtina. AWS už kiekvieną jungtį taiko dienos mokestį ($100 per dieną nuo 2025 m. liepos 21 d.) ir papildomą mokestį už minutes.
1. Sukurkite SIP galinį tašką
Jungties dokumentacijoje neaprašytas SIP santraukos autentifikavimas, todėl sukurkite galinį tašką, priimantį skambučius pagal šaltinio adresą:
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"]
}'Gaukite savo regiono jungties SIP signalizavimo diapazonus iš AWS. Kiekvienas jų
turi būti viešasis IPv4 diapazonas /16 arba siauresnis (IPv6 /48 arba
siauresnis). Informaciją apie taisykles ir visų platformos klientų bendrinamo
adreso riziką rasite skiltyje
Platformos, kurios autentifikuoja pagal šaltinio IP.
Išsaugokite atsakyme pateiktą sip_uri, pavyzdžiui,
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Siųskite skambučius su kontekstu
- Amazon Connect konsolėje atidarykite Išorinės balso sistemos → Balso perdavimo integracijos ir pasirinkite Sukurti.
- Pasirinkite paskirties tipą (SBC) ir pridėkite išeinantį maršrutą su
pagrindinio kompiuterio vardu
sip.thunderphone.com, prievadu5061ir TLS protokolu. Galiniam taškui reikia TLS arba TCP (prievadas5060), jis nepriima UDP. AWS dokumentacijoje nenurodyta, kuriuos protokolus siūlo jungtis, todėl patvirtinkite su AWS, kad ji gali naudoti vieną iš jų. - Savo sraute pridėkite bloką Perkelti į telefono numerį, kuriame
Perkelti į nustatyta kaip Išorinė balso sistema, ir nustatykite:
- Paskirties ARN: jungtis.
- Naudotojui: galinio taško
sip_urinaudotojo dalis, pvz.,agent-12-jhxmginwjx. - UUI (nebūtina): kontekstas agentui. Connect jį siunčia užkoduotą šešioliktainiu formatu.
- Tęsti srautą atsijungus: Taip, kad srautas būtų tęsiamas, kai agentas baigia skambutį.
Connect siunčia kontakto ID antraštėje X-Amzn-ConnectContactId. ThunderPhone
jį išsaugo kaip skambučio external_call_id, pagal kurį jūsų srautas vėliau
randa skambutį. UUI pasiekia raginimą kaip {{sip_uui}}. Trečiųjų šalių
integracijų dokumentacijoje aprašoma kontakto ID antraštė, tačiau AWS
dokumentacijoje jos nėra, todėl patikrinkite ją pirmojo bandomojo skambučio metu.
3. Grąžinkite skambutį
AWS dokumentacijoje nenurodytas būdas, kaip Connect galėtų nuskaityti BYE
antraštes arba priimti agento siunčiamą REFER. Todėl agentas grąžina skambutį:
atsisveikina ir padeda ragelį, o jūsų srautas tęsiamas po perdavimo bloko.
Pridėkite šį perdavimo numerį (žr. Pridėkite perdavimo numerį):
{"name": "Amazon Connect", "action": "return"}Tada po perdavimo gaukite perdavimo duomenis naudodami Iškviesti AWS Lambda funkciją bloką. Lambda ieško skambučio pagal kontakto 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 "",
}Blokas grąžina vieno lygio reikšmių žemėlapį, todėl srautas gali išsišakoti pagal
intent arba nustatyti summary kaip kontakto atributą skambutį perimančiam
asmeniui. Vykdykite bloką sinchroniškai (iki 8 sekundžių) ir saugokite API raktą
užšifruotą, pavyzdžiui, AWS Secrets Manager. Atsakymo laukai aprašyti
Peržiūrėkite perduotą skambutį.
Išbandykite
Paskambinkite į savo Connect egzemplioriaus numerį, kurio skambučiai pasiekia
perdavimo bloką, paprašykite agento sujungti su asmeniu ir patikrinkite, ar
srautas tęsiamas. Tada atidarykite skambutį naudodami
GET /v1/calls/{call_id}: sip_headers turėtų būti nurodyta
x-amzn-connectcontactid, o external_call_id turėtų sutapti su ContactId,
kurį gauna jūsų Lambda. Jei perdavimas nepavyksta ir gaunamas SIP 404,
ThunderPhone nerado galinio taško naudotojo dalies: ji turi būti ir užklausos
URI, ir To antraštėje.
Apribojimai
- AWS dokumentacijoje nenurodytas būdas nuskaityti
BYEantraštes, įskaitantX-TP-Handoff-Id, todėl kontakto ID yra vienintelė nuoroda atgal į skambutį. - AWS dokumentacijoje nenurodytas didžiausias jungties UUI ilgis.
- Sinchroninis Lambda blokas baigia skirtą laiką po 8 sekundžių.