Open in
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
- W konsoli Amazon Connect otwórz External Voice Systems → Voice Transfer Integrations i wybierz Create.
- Wybierz typ miejsca docelowego (SBC) i dodaj trasę wychodzącą z hostem
sip.thunderphone.com, portem5061oraz protokołem TLS. Punkt końcowy wymaga TLS lub TCP (port5060) i odrzuca UDP. AWS nie dokumentuje, które protokoły oferuje konektor, dlatego potwierdź z AWS, że może użyć jednego z nich. - 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_uripunktu końcowego, na przykładagent-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 tymX-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.