Open in
Povežite se iz Amazon Connecta
Šaljite pozive iz Amazon Connecta glasovnom agentu ThunderPhonea putem SIP-a s ID-jem kontakta i UUI-jem te nastavite tijek rada s predajom agenta.
Vaš Amazon Connect tijek šalje pozivatelja agentu s ID-jem kontakta i svim UUI podacima koje postavite. Kada agent završi, prekida poziv, vaš se tijek nastavlja, a Lambda dohvaća primopredaju prema ID-ju kontakta.
Prije početka
- ThunderPhone agent i organizacijski API ključ.
- Konektor Amazon Connecta Prijenos vanjskog glasa. Najprije zatražite povećanje kvote „Konektori za prijenos vanjskog glasa po računu”: izbornik ostaje skriven dok ga AWS ne odobri. AWS svaki konektor naplaćuje po danu ($100 dnevno od 21. srpnja 2025.) uz korištenje po minuti.
1. Izradite SIP krajnju točku
Konektor ne dokumentira SIP digest autentikaciju, stoga izradite krajnju točku koja prihvaća pozive prema izvornoj adresi:
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"]
}'Od AWS-a pribavite SIP signalizacijske raspone konektora za svoju regiju. Svaki mora biti
javni IPv4 raspon /16 ili uži (IPv6 /48 ili uži). Pogledajte
Platforme koje se autentikiraju prema izvornoj IP adresi
za pravila i rizik adrese koju dijele svi korisnici
platforme. Sačuvajte sip_uri iz odgovora, na primjer
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Šaljite pozive s kontekstom
- U konzoli Amazon Connect otvorite Vanjski glasovni sustavi → Integracije prijenosa glasa i odaberite Izradite.
- Odaberite vrstu odredišta (SBC) i dodajte odlaznu rutu s hostom
sip.thunderphone.com, portom5061i protokolom TLS. Krajnja točka zahtijeva TLS ili TCP (port5060) i odbija UDP. AWS ne dokumentira koje protokole konektor nudi, stoga potvrdite s AWS-om da može koristiti jedan od njih. - U svojem tijeku dodajte blok Prijenos na telefonski broj s opcijom Prijenos na
postavljenom na Vanjski glasovni sustav i postavite:
- ARN odredišta: konektor.
- Za korisnika: korisnički dio
sip_urikrajnje točke, kao što jeagent-12-jhxmginwjx. - UUI (neobavezno): kontekst za agenta. Connect ga šalje heksadekadski kodiranog.
- Nastavi tijek nakon prekida veze: Da, kako bi se tijek nastavio kada agent prekine poziv.
Connect šalje ID kontakta u X-Amzn-ConnectContactId. ThunderPhone ga pohranjuje
kao external_call_id poziva, što vašem tijeku omogućuje da kasnije pronađe poziv.
UUI dolazi do upute kao {{sip_uui}}. Integracije trećih strana dokumentiraju
zaglavlje ID-ja kontakta; AWS-ova vlastita dokumentacija to ne navodi, stoga ga provjerite pri prvom
testnom pozivu.
3. Dohvatite poziv natrag
AWS ne dokumentira način na koji Connect može čitati zaglavlja u BYE zahtjevu ni prihvatiti
REFER od agenta. Zato agent vraća poziv: pozdravi se i prekine vezu, a vaš se tijek nastavlja nakon bloka za prijenos. Dodajte ovaj broj za prijenos (pogledajte Dodajte broj za prijenos):
{"name": "Amazon Connect", "action": "return"}Zatim dohvatite predaju pomoću bloka Pokrenite funkciju AWS Lambda nakon prijenosa. Lambda traži poziv prema ID-u kontakta:
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 vraća ravnu mapu, pa se tijek može granati prema intent ili postaviti
summary kao atribut kontakta za osobu koja preuzima poziv. Pokrenite blok
sinkrono (do 8 sekundi) i API ključ pohranite šifriran, primjerice u AWS Secrets Manageru. Polja odgovora opisana su u
Potražite predani poziv.
Testirajte
Nazovite broj na svojoj instanci Connect koji vodi do bloka za prijenos, zatražite od
agenta osobu i provjerite nastavlja li se tijek. Zatim otvorite poziv pomoću
GET /v1/calls/{call_id}: sip_headers treba navesti
x-amzn-connectcontactid, a external_call_id treba biti jednak ContactId
koji prima vaša Lambda. Ako prijenos ne uspije sa SIP-om 404, ThunderPhone nije
pronašao korisnički dio krajnje točke: mora biti i u URI-ju zahtjeva i u zaglavlju To.
Ograničenja
- AWS ne dokumentira način čitanja zaglavlja u
BYEzahtjevu, uključujućiX-TP-Handoff-Id, pa je ID kontakta jedina poveznica natrag na poziv. - AWS ne dokumentira najveću duljinu UUI-ja za poveznik.
- Sinkroni Lambda blok istječe nakon 8 sekundi.