ThunderPhone v3 este disponibil.Self-service, de la 2 ¢/min.Citiți anunțul

Contact centers

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

  1. În consola Amazon Connect, deschideți Sisteme vocale externe → Integrări de transfer vocal și alegeți Creare.
  2. Alegeți tipul de destinație (un SBC) și adăugați o rută de ieșire cu gazda sip.thunderphone.com, portul 5061 și protocolul TLS. Punctul terminal necesită TLS sau TCP (portul 5060) și refuză UDP. AWS nu documentează ce protocoale oferă conectorul, așadar confirmați cu AWS că poate utiliza unul dintre acestea.
  3. Î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_uri al punctului terminal, precum agent-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, inclusiv X-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.