Open in
Povežite se iz Amazon Connecta
Klice iz Amazon Connecta usmerite h glasovnemu agentu ThunderPhone prek SIP-a z ID-jem stika in UUI ter nadaljujte svoj potek z agentovim predajanjem.
Vaš tok Amazon Connect usmeri klicatelja k agentu z ID-jem stika in nastavljenimi podatki UUI. Ko agent konča, prekine klic, vaš tok se nadaljuje, Lambda pa pridobi predajo po ID-ju stika.
Preden začnete
- Agent ThunderPhone in ključ API organizacije.
- Priključek Amazon Connect Zunanji prenos glasu. Najprej zahtevajte povečanje kvote »Priključki za zunanji prenos glasu na račun«: meni ostane skrit, dokler ga AWS ne odobri. AWS vsak priključek zaračunava na dan ($100 na dan od 21. julija 2025) ter uporabo na minuto.
1. Ustvarite končno točko SIP
Priključek ne dokumentira preverjanja pristnosti SIP digest, zato ustvarite končno točko, ki sprejema klice z izvornega naslova:
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"]
}'Obsege signalizacije SIP priključka za svojo regijo pridobite pri AWS. Vsak mora
biti javni obseg IPv4 velikosti /16 ali ožji (IPv6 /48 ali ožji). Oglejte si
Platforme, ki preverjajo pristnost po izvornem IP-ju
za pravila in tveganje naslova, ki si ga delijo vse stranke platforme. Shranite
sip_uri iz odgovora, na primer
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Pošljite klice s kontekstom
- V konzoli Amazon Connect odprite Zunanji glasovni sistemi → Integracije prenosa glasu in izberite Ustvarite.
- Izberite vrsto cilja (SBC) in dodajte odhodno pot z gostiteljem
sip.thunderphone.com, vrati5061in protokolom TLS. Končna točka zahteva TLS ali TCP (vrata5060) in zavrača UDP. AWS ne dokumentira, katere protokole priključek ponuja, zato pri AWS potrdite, da lahko uporablja enega od njih. - V svojem toku dodajte blok Prenos na telefonsko številko, pri čemer
nastavite Prenos na na Zunanji glasovni sistem, nato pa nastavite:
- ARN cilja: priključek.
- Uporabniku: uporabniški del
sip_urikončne točke, na primeragent-12-jhxmginwjx. - UUI (izbirno): kontekst za agenta. Connect ga pošlje šestnajstiško kodiranega.
- Nadaljujte tok po prekinitvi: Da, da se tok nadaljuje, ko agent prekine klic.
Connect pošlje ID stika v X-Amzn-ConnectContactId. ThunderPhone ga shrani kot
external_call_id klica, s čimer vaš tok pozneje najde klic. UUI doseže poziv
kot {{sip_uui}}. Integracije tretjih oseb dokumentirajo glavo ID-ja stika;
dokumentacija AWS je ne, zato jo preverite pri prvem testnem klicu.
3. Pridobite klic nazaj
AWS ne dokumentira načina, kako bi Connect prebral glave v BYE ali sprejel
REFER od agenta. Zato agent vrne klic: poslovi se in prekine klic, vaš potek pa se nadaljuje po bloku prenosa. Dodajte to številko za prenos (glejte Dodajte številko za prenos):
{"name": "Amazon Connect", "action": "return"}Nato po prenosu pridobite predajo z blokom Prikličite funkcijo AWS Lambda. Lambda poišče klic po ID-ju stika:
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 vrne ploski zemljevid, zato lahko potek razveji glede na intent ali nastavi
summary kot atribut stika za osebo, ki prevzame klic. Blok zaženite
sinhrono (do 8 sekund) in ključ API shranite šifrirano, na primer v AWS Secrets Manager. Polja odgovora so opisana v
Iskanje predanega klica.
Preizkusite
Pokličite številko v svoji instanci Connect, ki doseže blok prenosa, agenta
prosite za osebo in preverite, ali se potek nadaljuje. Nato odprite klic z
GET /v1/calls/{call_id}: sip_headers mora navajati
x-amzn-connectcontactid, external_call_id pa mora biti enak ContactId,
ki ga prejme vaša Lambda. Če prenos ne uspe s SIP 404, ThunderPhone ni našel
uporabniškega dela končne točke: biti mora tako v URI-ju zahteve kot v glavi
To.
Omejitve
- AWS ne dokumentira načina za branje glav v
BYE, vključno zX-TP-Handoff-Id, zato je ID stika edina povezava nazaj do klica. - AWS ne dokumentira največje dolžine UUI za priključek.
- Sinhroni blok Lambda poteče po 8 sekundah.