ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

Povežite se iz Amazon Connecta

Šaljite pozive iz Amazon Connecta glasovnom agentu ThunderPhonea putem SIP-a s ID-jem kontakta i UUI-jem te nastavite tijek rada s predajom agenta.

Vaš Amazon Connect tijek šalje pozivatelja agentu s ID-jem kontakta i svim UUI podacima koje postavite. Kada agent završi, prekida poziv, vaš se tijek nastavlja, a Lambda dohvaća primopredaju prema ID-ju kontakta.

Prije početka

  • ThunderPhone agent i organizacijski API ključ.
  • Konektor Amazon Connecta Prijenos vanjskog glasa. Najprije zatražite povećanje kvote „Konektori za prijenos vanjskog glasa po računu”: izbornik ostaje skriven dok ga AWS ne odobri. AWS svaki konektor naplaćuje po danu ($100 dnevno od 21. srpnja 2025.) uz korištenje po minuti.

1. Izradite SIP krajnju točku

Konektor ne dokumentira SIP digest autentikaciju, stoga izradite krajnju točku koja prihvaća pozive prema izvornoj adresi:

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

Od AWS-a pribavite SIP signalizacijske raspone konektora za svoju regiju. Svaki mora biti javni IPv4 raspon /16 ili uži (IPv6 /48 ili uži). Pogledajte Platforme koje se autentikiraju prema izvornoj IP adresi za pravila i rizik adrese koju dijele svi korisnici platforme. Sačuvajte sip_uri iz odgovora, na primjer sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Šaljite pozive s kontekstom

  1. U konzoli Amazon Connect otvorite Vanjski glasovni sustavi → Integracije prijenosa glasa i odaberite Izradite.
  2. Odaberite vrstu odredišta (SBC) i dodajte odlaznu rutu s hostom sip.thunderphone.com, portom 5061 i protokolom TLS. Krajnja točka zahtijeva TLS ili TCP (port 5060) i odbija UDP. AWS ne dokumentira koje protokole konektor nudi, stoga potvrdite s AWS-om da može koristiti jedan od njih.
  3. U svojem tijeku dodajte blok Prijenos na telefonski broj s opcijom Prijenos na postavljenom na Vanjski glasovni sustav i postavite:
    • ARN odredišta: konektor.
    • Za korisnika: korisnički dio sip_uri krajnje točke, kao što je agent-12-jhxmginwjx.
    • UUI (neobavezno): kontekst za agenta. Connect ga šalje heksadekadski kodiranog.
    • Nastavi tijek nakon prekida veze: Da, kako bi se tijek nastavio kada agent prekine poziv.

Connect šalje ID kontakta u X-Amzn-ConnectContactId. ThunderPhone ga pohranjuje kao external_call_id poziva, što vašem tijeku omogućuje da kasnije pronađe poziv. UUI dolazi do upute kao {{sip_uui}}. Integracije trećih strana dokumentiraju zaglavlje ID-ja kontakta; AWS-ova vlastita dokumentacija to ne navodi, stoga ga provjerite pri prvom testnom pozivu.

3. Dohvatite poziv natrag

AWS ne dokumentira način na koji Connect može čitati zaglavlja u BYE zahtjevu ni prihvatiti REFER od agenta. Zato agent vraća poziv: pozdravi se i prekine vezu, a vaš se tijek nastavlja nakon bloka za prijenos. Dodajte ovaj broj za prijenos (pogledajte Dodajte broj za prijenos):

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

Zatim dohvatite predaju pomoću bloka Pokrenite funkciju AWS Lambda nakon prijenosa. Lambda traži poziv prema ID-u kontakta:

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 vraća ravnu mapu, pa se tijek može granati prema intent ili postaviti summary kao atribut kontakta za osobu koja preuzima poziv. Pokrenite blok sinkrono (do 8 sekundi) i API ključ pohranite šifriran, primjerice u AWS Secrets Manageru. Polja odgovora opisana su u Potražite predani poziv.

Testirajte

Nazovite broj na svojoj instanci Connect koji vodi do bloka za prijenos, zatražite od agenta osobu i provjerite nastavlja li se tijek. Zatim otvorite poziv pomoću GET /v1/calls/{call_id}: sip_headers treba navesti x-amzn-connectcontactid, a external_call_id treba biti jednak ContactId koji prima vaša Lambda. Ako prijenos ne uspije sa SIP-om 404, ThunderPhone nije pronašao korisnički dio krajnje točke: mora biti i u URI-ju zahtjeva i u zaglavlju To.

Ograničenja

  • AWS ne dokumentira način čitanja zaglavlja u BYE zahtjevu, uključujući X-TP-Handoff-Id, pa je ID kontakta jedina poveznica natrag na poziv.
  • AWS ne dokumentira najveću duljinu UUI-ja za poveznik.
  • Sinkroni Lambda blok istječe nakon 8 sekundi.