ThunderPhone v3 je venku.Spustíte sami, od 2 ¢/min.Přečíst oznámení

Contact centers

Připojení z Amazon Connect

Přesměrujte hovory z Amazon Connect k agentovi ThunderPhone přes SIP s ID kontaktu a UUI a pokračujte ve svém toku po předání agentem.

Váš tok Amazon Connect odešle volajícího agentovi s ID kontaktu a libovolným UUI, které nastavíte. Když agent skončí, zavěsí, váš tok pokračuje a Lambda načte předání podle ID kontaktu.

Než začnete

  • Agent ThunderPhone a klíč API organizace.
  • Konektor Externí hlasový přenos služby Amazon Connect. Nejprve požádejte o zvýšení kvóty „Konektory externího hlasového přenosu na účet“: nabídka zůstane skrytá, dokud ji AWS neschválí. AWS účtuje každý konektor za den ($100 za den od 21. července 2025) plus využití za minutu.

1. Vytvořte koncový bod SIP

Konektor nedokumentuje ověřování SIP digest, proto vytvořte koncový bod, který přijímá hovory podle zdrojové 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ískejte od AWS rozsahy signalizace SIP konektoru pro váš Region. Každý musí být veřejný rozsah IPv4 o velikosti /16 nebo menší (IPv6 /48 nebo menší). Pravidla a riziko adresy sdílené všemi zákazníky platformy najdete v části Platformy ověřované podle zdrojové IP. Uložte si sip_uri z odpovědi, například sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Odesílejte hovory s kontextem

  1. V konzoli Amazon Connect otevřete Externí hlasové systémy → Integrace přenosu hlasu a zvolte Vytvořit.
  2. Vyberte typ cíle (SBC) a přidejte odchozí trasu s hostitelem sip.thunderphone.com, portem 5061 a protokolem TLS. Koncový bod vyžaduje TLS nebo TCP (port 5060) a odmítá UDP. AWS nedokumentuje, které protokoly konektor nabízí, proto u AWS ověřte, že může použít jeden z nich.
  3. Do toku přidejte blok Přenos na telefonní číslo, u možnosti Přenést do nastavte Externí hlasový systém a zadejte:
    • ARN cíle: konektor.
    • Uživateli: uživatelskou část sip_uri koncového bodu, například agent-12-jhxmginwjx.
    • UUI (volitelné): kontext pro agenta. Connect jej odesílá v hexadecimálním kódování.
    • Pokračovat v toku po odpojení: Ano, aby tok pokračoval, když agent zavěsí.

Connect odesílá ID kontaktu v X-Amzn-ConnectContactId. ThunderPhone jej ukládá jako external_call_id hovoru, podle kterého váš tok hovor později najde. UUI se do promptu dostane jako {{sip_uui}}. Integrace třetích stran hlavičku ID kontaktu dokumentují; vlastní dokumentace AWS nikoli, proto ji zkontrolujte při prvním testovacím hovoru.

3. Nechte hovor vrátit

AWS nepopisuje žádný způsob, jak může Connect číst hlavičky v BYE nebo přijmout REFER od agenta. Agent proto hovor vrátí: rozloučí se a zavěsí a váš tok se obnoví po bloku přesměrování. Přidejte toto číslo přesměrování (viz Přidání čísla přesměrování):

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

Poté po přesměrování načtěte předání pomocí bloku Vyvolat funkci AWS Lambda. Funkce Lambda vyhledá hovor podle 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 vrací plochou mapu, takže tok se může větvit podle intent nebo nastavit summary jako atribut kontaktu pro osobu, která hovor převezme. Spusťte blok synchronně (až 8 sekund) a klíč API ukládejte zašifrovaný, například ve službě AWS Secrets Manager. Pole odpovědi jsou popsána v části Vyhledání předaného hovoru.

Otestujte to

Zavolejte na číslo ve své instanci Connect, které vede k bloku přesměrování, požádejte agenta o spojení s osobou a ověřte, že se tok obnoví. Poté otevřete hovor pomocí GET /v1/calls/{call_id}: sip_headers by mělo obsahovat x-amzn-connectcontactid a external_call_id by se mělo rovnat ContactId, které přijme vaše Lambda. Pokud přesměrování selže se SIP 404, ThunderPhone nenašel uživatelskou část koncového bodu: musí být v identifikátoru URI požadavku i v hlavičce To.

Omezení

  • AWS nepopisuje žádný způsob, jak číst hlavičky v BYE, včetně X-TP-Handoff-Id, takže ID kontaktu je jediným odkazem zpět na hovor.
  • AWS neuvádí maximální délku UUI pro konektor.
  • Synchronní blok Lambda vyprší po 8 sekundách.