ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Contact centers

Povežite se iz Amazon Connecta

Klice iz Amazon Connecta usmerite h glasovnemu agentu ThunderPhone prek SIP-a z ID-jem stika in UUI ter nadaljujte svoj potek z agentovim predajanjem.

Vaš tok Amazon Connect usmeri klicatelja k agentu z ID-jem stika in nastavljenimi podatki UUI. Ko agent konča, prekine klic, vaš tok se nadaljuje, Lambda pa pridobi predajo po ID-ju stika.

Preden začnete

  • Agent ThunderPhone in ključ API organizacije.
  • Priključek Amazon Connect Zunanji prenos glasu. Najprej zahtevajte povečanje kvote »Priključki za zunanji prenos glasu na račun«: meni ostane skrit, dokler ga AWS ne odobri. AWS vsak priključek zaračunava na dan ($100 na dan od 21. julija 2025) ter uporabo na minuto.

1. Ustvarite končno točko SIP

Priključek ne dokumentira preverjanja pristnosti SIP digest, zato ustvarite končno točko, ki sprejema klice z izvornega naslova:

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

Obsege signalizacije SIP priključka za svojo regijo pridobite pri AWS. Vsak mora biti javni obseg IPv4 velikosti /16 ali ožji (IPv6 /48 ali ožji). Oglejte si Platforme, ki preverjajo pristnost po izvornem IP-ju za pravila in tveganje naslova, ki si ga delijo vse stranke platforme. Shranite sip_uri iz odgovora, na primer sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Pošljite klice s kontekstom

  1. V konzoli Amazon Connect odprite Zunanji glasovni sistemi → Integracije prenosa glasu in izberite Ustvarite.
  2. Izberite vrsto cilja (SBC) in dodajte odhodno pot z gostiteljem sip.thunderphone.com, vrati 5061 in protokolom TLS. Končna točka zahteva TLS ali TCP (vrata 5060) in zavrača UDP. AWS ne dokumentira, katere protokole priključek ponuja, zato pri AWS potrdite, da lahko uporablja enega od njih.
  3. V svojem toku dodajte blok Prenos na telefonsko številko, pri čemer nastavite Prenos na na Zunanji glasovni sistem, nato pa nastavite:
    • ARN cilja: priključek.
    • Uporabniku: uporabniški del sip_uri končne točke, na primer agent-12-jhxmginwjx.
    • UUI (izbirno): kontekst za agenta. Connect ga pošlje šestnajstiško kodiranega.
    • Nadaljujte tok po prekinitvi: Da, da se tok nadaljuje, ko agent prekine klic.

Connect pošlje ID stika v X-Amzn-ConnectContactId. ThunderPhone ga shrani kot external_call_id klica, s čimer vaš tok pozneje najde klic. UUI doseže poziv kot {{sip_uui}}. Integracije tretjih oseb dokumentirajo glavo ID-ja stika; dokumentacija AWS je ne, zato jo preverite pri prvem testnem klicu.

3. Pridobite klic nazaj

AWS ne dokumentira načina, kako bi Connect prebral glave v BYE ali sprejel REFER od agenta. Zato agent vrne klic: poslovi se in prekine klic, vaš potek pa se nadaljuje po bloku prenosa. Dodajte to številko za prenos (glejte Dodajte številko za prenos):

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

Nato po prenosu pridobite predajo z blokom Prikličite funkcijo AWS Lambda. Lambda poišče klic po ID-ju stika:

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 vrne ploski zemljevid, zato lahko potek razveji glede na intent ali nastavi summary kot atribut stika za osebo, ki prevzame klic. Blok zaženite sinhrono (do 8 sekund) in ključ API shranite šifrirano, na primer v AWS Secrets Manager. Polja odgovora so opisana v Iskanje predanega klica.

Preizkusite

Pokličite številko v svoji instanci Connect, ki doseže blok prenosa, agenta prosite za osebo in preverite, ali se potek nadaljuje. Nato odprite klic z GET /v1/calls/{call_id}: sip_headers mora navajati x-amzn-connectcontactid, external_call_id pa mora biti enak ContactId, ki ga prejme vaša Lambda. Če prenos ne uspe s SIP 404, ThunderPhone ni našel uporabniškega dela končne točke: biti mora tako v URI-ju zahteve kot v glavi To.

Omejitve

  • AWS ne dokumentira načina za branje glav v BYE, vključno z X-TP-Handoff-Id, zato je ID stika edina povezava nazaj do klica.
  • AWS ne dokumentira največje dolžine UUI za priključek.
  • Sinhroni blok Lambda poteče po 8 sekundah.