Open in
Conectați din Amazon Connect
Trimiteți apeluri Amazon Connect către un agent ThunderPhone prin SIP, împreună cu ID-ul de contact și UUI, apoi reluați fluxul cu transferul agentului.
Fluxul dumneavoastră Amazon Connect trimite apelantul către agent cu ID-ul de contact și orice UUI configurați. Când agentul termină, închide apelul, fluxul dumneavoastră continuă, iar o funcție Lambda preia transferul după ID-ul de contact.
Înainte de a începe
- Un agent ThunderPhone și o cheie API a organizației.
- Conectorul Amazon Connect Transfer vocal extern. Solicitați mai întâi creșterea cotei „Conectori de transfer vocal extern per cont”: meniul rămâne ascuns până când AWS o aprobă. AWS facturează fiecare conector pe zi ($100 pe zi începând cu 21 iulie 2025) plus utilizarea pe minut.
1. Creați punctul terminal SIP
Conectorul nu documentează autentificarea SIP digest, așadar creați un punct terminal care acceptă apeluri după adresa sursă:
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"]
}'Obțineți de la AWS intervalele de semnalizare SIP ale conectorului pentru regiunea dumneavoastră. Fiecare trebuie să fie
un interval IPv4 public de /16 sau mai restrâns (IPv6 /48 sau mai restrâns). Consultați
Platforme care se autentifică după IP-ul sursă
pentru reguli și riscul unei adrese partajate de fiecare client al
platformei. Păstrați sip_uri din răspuns, de exemplu
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Trimiteți apeluri cu context
- În consola Amazon Connect, deschideți Sisteme vocale externe → Integrări de transfer vocal și alegeți Creare.
- Alegeți tipul de destinație (un SBC) și adăugați o rută de ieșire cu gazda
sip.thunderphone.com, portul5061și protocolul TLS. Punctul terminal necesită TLS sau TCP (portul5060) și refuză UDP. AWS nu documentează ce protocoale oferă conectorul, așadar confirmați cu AWS că poate utiliza unul dintre acestea. - În fluxul dumneavoastră, adăugați un bloc Transferați către număr de telefon cu Transferați către
setat la Sistem vocal extern și configurați:
- ARN de destinație: conectorul.
- Către utilizator: partea de utilizator din
sip_urial punctului terminal, precumagent-12-jhxmginwjx. - UUI (opțional): context pentru agent. Connect îl trimite codificat hexazecimal.
- Reluați fluxul după deconectare: Da, astfel încât fluxul să continue când agentul închide apelul.
Connect trimite ID-ul de contact în X-Amzn-ConnectContactId. ThunderPhone îl stochează
ca external_call_id al apelului, astfel găsește fluxul dumneavoastră apelul
ulterior. UUI ajunge în prompt ca {{sip_uui}}. Integrările terțe
documentează antetul ID-ului de contact; documentația AWS nu îl menționează, așadar verificați-l la primul
apel de test.
3. Preluați apelul înapoi
AWS nu documentează nicio metodă prin care Connect să citească anteturile din BYE sau să accepte un REFER de la agent. Prin urmare, agentul returnează apelul: își ia rămas-bun și închide, iar fluxul dumneavoastră reia execuția după blocul de transfer. Adăugați acest număr de transfer (consultați Adăugați numărul de transfer):
{"name": "Amazon Connect", "action": "return"}Apoi preluați transferul cu un bloc Invocați funcția AWS Lambda după transfer. Lambda caută apelul după ID-ul contactului:
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 "",
}Blocul returnează o mapare plată, astfel încât fluxul poate crea ramificații pe baza lui intent sau poate seta summary ca atribut de contact pentru persoana care preia apelul. Rulați blocul sincron (până la 8 secunde) și stocați cheia API criptată, de exemplu în AWS Secrets Manager. Câmpurile de răspuns sunt disponibile în Căutați un apel transferat.
Testați
Apelați un număr din instanța dumneavoastră Connect care ajunge la blocul de transfer, solicitați agentului o persoană și verificați că fluxul reia execuția. Apoi deschideți apelul cu GET /v1/calls/{call_id}: sip_headers trebuie să includă x-amzn-connectcontactid, iar external_call_id trebuie să fie egal cu ContactId primit de Lambda. Dacă transferul eșuează cu SIP 404, ThunderPhone nu a găsit partea de utilizator a endpointului: aceasta trebuie să fie atât în URI-ul cererii, cât și în antetul To.
Limite
- AWS nu documentează nicio metodă de a citi anteturile din
BYE, inclusivX-TP-Handoff-Id, astfel încât ID-ul contactului este singura legătură înapoi către apel. - AWS nu documentează o lungime UUI maximă pentru conector.
- Un bloc Lambda sincron expiră după 8 secunde.