Open in
Connettiti da Amazon Connect
Invia le chiamate Amazon Connect a un agente ThunderPhone tramite SIP con l
Il flusso Amazon Connect invia il chiamante all'agente con l'ID contatto e qualsiasi UUI impostato. Quando l'agente ha terminato, riaggancia, il flusso prosegue e una Lambda recupera il passaggio tramite ID contatto.
Prima di iniziare
- Un agente ThunderPhone e una chiave API dell'organizzazione.
- Il connettore Trasferimento vocale esterno di Amazon Connect. Richiedi prima l'aumento della quota "External voice transfer connectors per account": il menu rimane nascosto finché AWS non lo approva. AWS fattura ogni connettore al giorno ($100 al giorno dal 21 luglio 2025) più l'utilizzo al minuto.
1. Crea l'endpoint SIP
Il connettore non documenta l'autenticazione digest SIP, quindi crea un endpoint che accetti chiamate in base all'indirizzo sorgente:
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"]
}'Recupera da AWS gli intervalli di segnalazione SIP del connettore per la tua
Regione. Ciascuno deve essere un intervallo IPv4 pubblico di /16 o più
ristretto (IPv6 /48 o più ristretto). Consulta
piattaforme che eseguono l'autenticazione tramite IP sorgente
per le regole e il rischio di un indirizzo condiviso da tutti i clienti della
piattaforma. Conserva il valore sip_uri della risposta, ad esempio
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Invia chiamate con contesto
- Nella console Amazon Connect, apri Sistemi vocali esterni → Integrazioni di trasferimento vocale e scegli Crea.
- Seleziona il tipo di destinazione (un SBC) e aggiungi una route in uscita con
host
sip.thunderphone.com, porta5061e protocollo TLS. L'endpoint richiede TLS o TCP (porta5060) e rifiuta UDP. AWS non documenta quali protocolli offra il connettore, quindi conferma con AWS che possa utilizzare uno di essi. - Nel flusso, aggiungi un blocco Trasferisci a numero di telefono con
Trasferisci a impostato su Sistema vocale esterno, quindi imposta:
- ARN di destinazione: il connettore.
- A utente: la parte utente dell'
sip_uridell'endpoint, ad esempioagent-12-jhxmginwjx. - UUI (facoltativo): contesto per l'agente. Connect lo invia con codifica esadecimale.
- Riprendi il flusso dopo la disconnessione: Sì, affinché il flusso continui quando l'agente riaggancia.
Connect invia l'ID contatto in X-Amzn-ConnectContactId. ThunderPhone lo
memorizza come external_call_id della chiamata, che consente al flusso di
trovare la chiamata in seguito. L'UUI raggiunge il prompt come {{sip_uui}}.
Le integrazioni di terze parti documentano l'header dell'ID contatto; la
documentazione AWS non lo fa, quindi verificalo con la prima chiamata di test.
3. Riprendi la chiamata
AWS non documenta alcun modo per consentire a Connect di leggere le intestazioni sul BYE o di accettare un
REFER dall'agente. L'agente quindi restituisce la chiamata: saluta e
riaggancia, e il flusso riprende dopo il blocco di trasferimento. Aggiungi questo numero di trasferimento (vedi Aggiungi il numero di trasferimento):
{"name": "Amazon Connect", "action": "return"}Quindi recupera il passaggio con un blocco Invoca funzione AWS Lambda dopo il trasferimento. Lambda cerca la chiamata tramite l'ID contatto:
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 "",
}Il blocco restituisce una mappa piatta, quindi il flusso può diramarsi in base a intent o impostare
summary come attributo di contatto per la persona che prende la chiamata. Esegui il
blocco in modo sincrono (fino a 8 secondi) e archivia la chiave API crittografata, ad
esempio in AWS Secrets Manager. I campi della risposta sono descritti in
Cerca una chiamata passata.
Provalo
Chiama un numero nella tua istanza Connect che raggiunge il blocco di trasferimento, chiedi
all'agente di una persona e verifica che il flusso riprenda. Quindi apri la chiamata con
GET /v1/calls/{call_id}: sip_headers dovrebbe elencare
x-amzn-connectcontactid e external_call_id dovrebbe corrispondere al ContactId
ricevuto dalla tua Lambda. Se il trasferimento fallisce con SIP 404, ThunderPhone non ha
trovato la parte utente dell'endpoint: deve essere presente sia nell'URI della richiesta sia
nell'intestazione To.
Limiti
- AWS non documenta alcun modo per leggere le intestazioni sul
BYE, inclusoX-TP-Handoff-Id, quindi l'ID contatto è l'unico collegamento alla chiamata. - AWS non documenta una lunghezza UUI massima per il connettore.
- Un blocco Lambda sincrono va in timeout dopo 8 secondi.