ThunderPhone v3 już działa.Uruchom samodzielnie, od 2¢/min.Przeczytaj komunikat

Contact centers

Połącz z Amazon Connect

Przekazuj połączenia z Amazon Connect do agenta ThunderPhone przez SIP z identyfikatorem kontaktu i UUI, a następnie wznawiaj przepływ po przekazaniu rozmowy przez agenta.

Przepływ Amazon Connect przekazuje rozmówcę do agenta wraz z identyfikatorem kontaktu i ustawionym przez Ciebie UUI. Gdy agent zakończy rozmowę, rozłącza się, przepływ jest kontynuowany, a funkcja Lambda pobiera przekazanie na podstawie identyfikatora kontaktu.

Zanim zaczniesz

  • Agent ThunderPhone i organizacyjny klucz API.
  • Konektor External voice transfer Amazon Connect. Najpierw poproś o zwiększenie limitu „External voice transfer connectors per account”: menu pozostaje ukryte, dopóki AWS go nie zatwierdzi. AWS nalicza opłatę dzienną za każdy konektor ($100 dziennie od 21 lipca 2025 r.) oraz opłatę za użycie naliczaną za minutę.

1. Utwórz punkt końcowy SIP

Konektor nie dokumentuje uwierzytelniania SIP Digest, dlatego utwórz punkt końcowy, który akceptuje połączenia według adresu źródłowego:

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

Pobierz z AWS zakresy sygnalizacji SIP konektora dla swojego regionu. Każdy z nich musi być publicznym zakresem IPv4 o prefiksie /16 lub węższym (IPv6 /48 lub węższym). Zobacz Platformy uwierzytelniane według źródłowego adresu IP aby poznać zasady oraz ryzyko związane z adresem współdzielonym przez wszystkich klientów platformy. Zachowaj sip_uri z odpowiedzi, na przykład sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Wysyłaj połączenia z kontekstem

  1. W konsoli Amazon Connect otwórz External Voice Systems → Voice Transfer Integrations i wybierz Create.
  2. Wybierz typ miejsca docelowego (SBC) i dodaj trasę wychodzącą z hostem sip.thunderphone.com, portem 5061 oraz protokołem TLS. Punkt końcowy wymaga TLS lub TCP (port 5060) i odrzuca UDP. AWS nie dokumentuje, które protokoły oferuje konektor, dlatego potwierdź z AWS, że może użyć jednego z nich.
  3. W swoim przepływie dodaj blok Transfer to phone number, w którym opcja Transfer to jest ustawiona na External voice system, a następnie ustaw:
    • Destination ARN: konektor.
    • To User: część użytkownika sip_uri punktu końcowego, na przykład agent-12-jhxmginwjx.
    • UUI (opcjonalnie): kontekst dla agenta. Connect wysyła go w kodowaniu szesnastkowym.
    • Resume flow after disconnect: Tak, aby przepływ był kontynuowany, gdy agent się rozłączy.

Connect wysyła identyfikator kontaktu w X-Amzn-ConnectContactId. ThunderPhone zapisuje go jako external_call_id połączenia, dzięki czemu przepływ może później znaleźć połączenie. UUI trafia do promptu jako {{sip_uui}}. Integracje innych firm dokumentują nagłówek identyfikatora kontaktu, ale dokumentacja AWS tego nie robi, dlatego sprawdź go podczas pierwszego połączenia testowego.

3. Odbierz połączenie z powrotem

AWS nie dokumentuje sposobu, aby Connect odczytał nagłówki w BYE lub zaakceptował REFER od agenta. Dlatego agent zwraca połączenie: żegna się i rozłącza, a przepływ jest wznawiany po bloku transferu. Dodaj ten numer transferowy (zobacz Dodaj numer transferowy):

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

Następnie pobierz przekazanie za pomocą bloku Wywołaj funkcję AWS Lambda po transferze. Funkcja Lambda wyszukuje połączenie według identyfikatora 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 zwraca płaską mapę, więc przepływ może rozgałęziać się na podstawie intent lub ustawić summary jako atrybut kontaktu dla osoby, która odbiera połączenie. Uruchom blok synchronicznie (do 8 sekund) i przechowuj klucz API w postaci zaszyfrowanej, na przykład w AWS Secrets Manager. Pola odpowiedzi opisano w Wyszukaj przekazane połączenie.

Przetestuj

Zadzwoń na numer w instancji Connect, który prowadzi do bloku transferu, poproś agenta o połączenie z osobą i sprawdź, czy przepływ zostanie wznowiony. Następnie otwórz połączenie za pomocą GET /v1/calls/{call_id}: sip_headers powinno zawierać x-amzn-connectcontactid, a external_call_id powinno być równe ContactId, które otrzymuje funkcja Lambda. Jeśli transfer zakończy się błędem SIP 404, ThunderPhone nie znalazł części użytkownika punktu końcowego: musi ona występować zarówno w URI żądania, jak i w nagłówku To.

Limity

  • AWS nie dokumentuje sposobu odczytu nagłówków w BYE, w tym X-TP-Handoff-Id, dlatego identyfikator kontaktu jest jedynym połączeniem zwrotnym z połączeniem.
  • AWS nie dokumentuje maksymalnej długości UUI dla konektora.
  • Synchroniczny blok Lambda przekracza limit czasu po 8 sekundach.