Open in
Savienošana no Amazon Connect
Nosūtiet Amazon Connect zvanus uz ThunderPhone balss aģentu, izmantojot SIP ar kontakta ID un UUI, un atsāciet savu plūsmu ar balss aģenta pāradresēšanu.
Jūsu Amazon Connect plūsma nosūta zvanītāju balss aģentam kopā ar kontakta ID un jebkādu jūsu iestatīto UUI. Kad balss aģents ir pabeidzis darbu, tas noliek klausuli, jūsu plūsma turpinās, un Lambda pēc kontakta ID iegūst pārsūtīšanas informāciju.
Pirms sākat
- ThunderPhone balss aģents un organizācijas API atslēga.
- Amazon Connect Ārējās balss pārsūtīšanas savienotājs. Vispirms pieprasiet kvotas palielinājumu “Ārējās balss pārsūtīšanas savienotāji vienam kontam”: izvēlne paliek paslēpta, līdz AWS to apstiprina. AWS par katru savienotāju iekasē maksu dienā ($100 dienā kopš 2025. gada 21. jūlija) un maksu par lietojumu minūtēs.
1. Izveidojiet SIP galapunktu
Savienotāja dokumentācijā nav aprakstīta SIP digest autentifikācija, tāpēc izveidojiet galapunktu, kas pieņem zvanus pēc avota adreses:
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"]
}'Iegūstiet savienotāja SIP signalizācijas diapazonus savam reģionam no AWS. Katram jābūt
publiskam IPv4 diapazonam ar /16 vai šaurāku masku (IPv6 /48 vai šaurāku masku). Skatiet
Platformas, kas autentificē pēc avota IP
noteikumus un risku, ko rada adrese, kuru koplieto visi platformas
klienti. Saglabājiet atbildē norādīto sip_uri, piemēram,
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Nosūtiet zvanus ar kontekstu
- Amazon Connect konsolē atveriet Ārējās balss sistēmas → Balss pārsūtīšanas integrācijas un izvēlieties Izveidot.
- Atlasiet galamērķa tipu (SBC) un pievienojiet izejošo maršrutu ar resursdatoru
sip.thunderphone.com, portu5061un TLS protokolu. Galapunktam nepieciešams TLS vai TCP (ports5060), un tas noraida UDP. AWS nedokumentē, kurus protokolus savienotājs piedāvā, tāpēc apstipriniet AWS, ka tas var izmantot kādu no tiem. - Savā plūsmā pievienojiet bloku Pārsūtīt uz tālruņa numuru, kur Pārsūtīt uz
ir iestatīts uz Ārējā balss sistēma, un norādiet:
- Galamērķa ARN: savienotāju.
- Lietotājam: galapunkta
sip_urilietotāja daļu, piemēram,agent-12-jhxmginwjx. - UUI (neobligāti): balss aģenta kontekstu. Connect to nosūta heksadecimāli kodētu.
- Atsākt plūsmu pēc atvienošanas: Jā, lai plūsma turpinātos, kad balss aģents noliek klausuli.
Connect nosūta kontakta ID laukā X-Amzn-ConnectContactId. ThunderPhone to saglabā
kā zvana external_call_id, un tā jūsu plūsma vēlāk atrod zvanu. UUI nonāk
uzvednē kā {{sip_uui}}. Trešo pušu integrāciju dokumentācijā ir aprakstīta
kontakta ID galvene; AWS dokumentācijā tās nav, tāpēc pārbaudiet to savā pirmajā
testa zvanā.
3. Saņemiet zvanu atpakaļ
AWS nedokumentē veidu, kā Connect varētu nolasīt galvenes BYE ziņojumā vai
pieņemt aģenta REFER ziņojumu. Tāpēc balss aģents atgriež zvanu: tas atvadās un
noliek klausuli, un jūsu plūsma turpinās pēc pārsūtīšanas bloka. Pievienojiet šo
pārsūtīšanas numuru (skatiet Pievienojiet pārsūtīšanas numuru):
{"name": "Amazon Connect", "action": "return"}Pēc pārsūtīšanas izgūstiet nodošanas informāciju ar bloku Izsaukt AWS Lambda funkciju. Lambda meklē zvanu pēc kontaktpersonas 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 "",
}Bloks atgriež plakanu kartējumu, tāpēc plūsma var veidot atzarojumu pēc intent vai iestatīt
summary kā kontaktpersonas atribūtu personai, kura pieņem zvanu. Palaidiet
bloku sinhroni (līdz 8 sekundēm) un glabājiet API atslēgu šifrētā veidā, piemēram,
AWS Secrets Manager. Atbildes lauki ir aprakstīti sadaļā
Meklēt nodotu zvanu.
Pārbaudiet
Zvaniet uz numuru savā Connect instancē, kas sasniedz pārsūtīšanas bloku, lūdziet
balss aģentam savienot ar personu un pārbaudiet, vai plūsma turpinās. Pēc tam atveriet
zvanu ar GET /v1/calls/{call_id}: sip_headers jānorāda
x-amzn-connectcontactid, un external_call_id jāatbilst ContactId,
ko saņem jūsu Lambda. Ja pārsūtīšana neizdodas ar SIP 404, ThunderPhone
neatrada galapunkta lietotāja daļu: tai jābūt gan pieprasījuma URI, gan To
galvenē.
Ierobežojumi
- AWS nedokumentē veidu, kā nolasīt galvenes
BYEziņojumā, tostarpX-TP-Handoff-Id, tāpēc kontaktpersonas ID ir vienīgā saite atpakaļ uz zvanu. - AWS nedokumentē savienotāja maksimālo UUI garumu.
- Sinhronais Lambda bloks pārsniedz noildzi pēc 8 sekundēm.