ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Contact centers

Pripojenie z Amazon Connect

Odosielajte hovory z Amazon Connect hlasovému agentovi ThunderPhone cez SIP s ID kontaktu a UUI a pokračujte vo svojom toku s odovzdaním agenta.

Váš tok Amazon Connect odošle volajúceho agentovi s identifikátorom kontaktu a ľubovoľným nastaveným UUI. Keď agent skončí, zavesí hovor, váš tok pokračuje a Lambda načíta odovzdanie podľa identifikátora kontaktu.

Skôr než začnete

  • Agent ThunderPhone a kľúč API organizácie.
  • Konektor Amazon Connect Externý hlasový prenos. Najprv požiadajte o zvýšenie kvóty „Konektory externého hlasového prenosu na účet“: ponuka zostane skrytá, kým ju AWS neschváli. AWS účtuje každý konektor za deň ($100 za deň od 21. júla 2025) plus používanie za minútu.

1. Vytvorte koncový bod SIP

Konektor nedokumentuje autentifikáciu SIP digest, preto vytvorte koncový bod, ktorý prijíma hovory podľa zdrojovej adresy:

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"]
  }'

Získajte od AWS signalizačné rozsahy SIP konektora pre váš región. Každý musí byť verejný rozsah IPv4 s maskou /16 alebo užšou (IPv6 /48 alebo užšou). Pravidlá a riziko adresy zdieľanej všetkými zákazníkmi platformy nájdete v časti Platformy, ktoré sa autentifikujú podľa zdrojovej IP. Uchovajte si sip_uri z odpovede, napríklad sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Odosielajte hovory s kontextom

  1. V konzole Amazon Connect otvorte Externé hlasové systémy → Integrácie prenosu hlasu a vyberte Vytvoriť.
  2. Vyberte typ cieľa (SBC) a pridajte odchádzajúcu trasu s hostiteľom sip.thunderphone.com, portom 5061 a protokolom TLS. Koncový bod vyžaduje TLS alebo TCP (port 5060) a odmieta UDP. AWS nedokumentuje, ktoré protokoly konektor ponúka, preto si u AWS overte, že môže použiť jeden z nich.
  3. Do toku pridajte blok Preniesť na telefónne číslo, nastavte Preniesť do na Externý hlasový systém a nastavte:
    • ARN cieľa: konektor.
    • Používateľ príjemcu: používateľská časť sip_uri koncového bodu, napríklad agent-12-jhxmginwjx.
    • UUI (voliteľné): kontext pre agenta. Connect ho odosiela v hexadecimálnom kódovaní.
    • Pokračovať v toku po odpojení: Áno, aby tok pokračoval, keď agent zavesí hovor.

Connect odosiela identifikátor kontaktu v X-Amzn-ConnectContactId. ThunderPhone ho ukladá ako external_call_id hovoru, podľa ktorého váš tok hovor neskôr nájde. UUI sa do výzvy dostane ako {{sip_uui}}. Integrácie tretích strán dokumentujú hlavičku identifikátora kontaktu; vlastná dokumentácia AWS nie, preto ju skontrolujte pri prvom testovacom hovore.

3. Získajte hovor späť

AWS neuvádza spôsob, ako môže Connect čítať hlavičky v BYE alebo prijať REFER od agenta. Agent preto hovor vráti: rozlúči sa a zavesí a váš tok pokračuje po bloku prenosu. Pridajte toto číslo prenosu (pozrite si Pridanie čísla prenosu):

{"name": "Amazon Connect", "action": "return"}

Potom po prenose získajte odovzdanie pomocou bloku Vyvolať funkciu AWS Lambda. Lambda vyhľadá hovor podľa ID kontaktu:

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 vráti plochú mapu, takže tok môže vetviť podľa intent alebo nastaviť summary ako atribút kontaktu pre osobu, ktorá hovor prevezme. Blok spúšťajte synchrónne (maximálne 8 sekúnd) a kľúč API ukladajte zašifrovaný, napríklad v službe AWS Secrets Manager. Polia odpovede sú uvedené v dokumentácii Vyhľadanie odovzdaného hovoru.

Otestujte to

Zavolajte na číslo vo svojej inštancii Connect, ktoré vedie k bloku prenosu, požiadajte agenta o spojenie s osobou a overte, že tok pokračuje. Potom otvorte hovor pomocou GET /v1/calls/{call_id}: sip_headers by malo obsahovať x-amzn-connectcontactid a external_call_id by sa malo rovnať hodnote ContactId, ktorú prijme vaša Lambda. Ak prenos zlyhá s chybou SIP 404, ThunderPhone nenašiel používateľskú časť koncového bodu: musí byť v URI požiadavky aj v hlavičke To.

Obmedzenia

  • AWS neuvádza spôsob, ako čítať hlavičky v BYE vrátane X-TP-Handoff-Id, takže ID kontaktu je jediným prepojením späť na hovor.
  • AWS neuvádza maximálnu dĺžku UUI pre konektor.
  • Synchrónny blok Lambda po 8 sekundách vyprší.