Open in
Opret forbindelse fra Amazon Connect
Send Amazon Connect-opkald til en ThunderPhone-agent via SIP med kontakt-id
Dit Amazon Connect-flow sender opkalderen til agenten med kontakt-id'et og eventuel UUI, du angiver. Når agenten er færdig, lægger den på, dit flow fortsætter, og en Lambda henter overdragelsen via kontakt-id'et.
Før du starter
- En ThunderPhone-agent og en API-nøgle til organisationen.
- Amazon Connects connector til ekstern stemmeoverførsel. Anmod først om en forhøjelse af kvoten "Connectors til ekstern stemmeoverførsel pr. konto": menuen forbliver skjult, indtil AWS godkender den. AWS fakturerer hver connector pr. dag ($100 om dagen siden 21. juli 2025) plus brug pr. minut.
1. Opret SIP-endpointet
Connectoren dokumenterer ikke SIP-digestgodkendelse, så opret et endpoint, der accepterer opkald efter kildeadresse:
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"]
}'Hent connectorens SIP-signalområder for din region fra AWS. Hvert område skal
være et offentligt IPv4-område på /16 eller snævrere (IPv6 /48 eller
snævrere). Se
Platforme, der godkender efter kilde-IP
for reglerne og risikoen ved en adresse, der deles af alle platformens kunder.
Gem svarets sip_uri, for eksempel
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Send opkald med kontekst
- Åbn Eksterne stemmesystemer → Integrationer til stemmeoverførsel i Amazon Connect-konsollen, og vælg Opret.
- Vælg destinationstypen (en SBC), og tilføj en udgående rute med værten
sip.thunderphone.com, port5061og protokollen TLS. Endpointet kræver TLS eller TCP (port5060) og afviser UDP. AWS dokumenterer ikke, hvilke protokoller connectoren tilbyder, så bekræft med AWS, at den kan bruge en af dem. - Tilføj blokken Overfør til telefonnummer i dit flow med Overfør til
angivet til Eksternt stemmesystem, og angiv:
- Destinations-ARN: connectoren.
- Til bruger: brugerdelen af endpointets
sip_uri, for eksempelagent-12-jhxmginwjx. - UUI (valgfrit): kontekst til agenten. Connect sender den hex-kodet.
- Genoptag flow efter afbrydelse: Ja, så flowet fortsætter, når agenten lægger på.
Connect sender kontakt-id'et i X-Amzn-ConnectContactId. ThunderPhone gemmer
det som opkaldets external_call_id, hvilket gør det muligt for dit flow at
finde opkaldet senere. UUI'en når prompten som {{sip_uui}}.
Tredjepartsintegrationer dokumenterer kontakt-id-headeren; AWS' egen
dokumentation gør ikke, så kontrollér den ved dit første testopkald.
3. Få opkaldet tilbage
AWS dokumenterer ingen måde, hvorpå Connect kan læse headers på BYE eller acceptere en
REFER fra agenten. Derfor returnerer agenten opkaldet: den siger farvel og
lægger på, og dit flow fortsætter efter overførselsblokken. Tilføj dette overførselsnummer
(se Tilføj overførselsnummeret):
{"name": "Amazon Connect", "action": "return"}Hent derefter overleveringen med en Kald AWS Lambda-funktion-blok efter overførslen. Lambdaen slår opkaldet op efter kontakt-id:
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 "",
}Blokken returnerer et fladt map, så flowet kan forgrene på intent eller angive
summary som en kontaktattribut for den person, der overtager opkaldet. Kør
blokken synkront (op til 8 sekunder), og gem API-nøglen krypteret, for eksempel
i AWS Secrets Manager. Svarfelterne findes i
Slå et overleveret opkald op.
Test det
Ring til et nummer på din Connect-instans, der når overførselsblokken, bed
agenten om en person, og kontrollér, at flowet fortsætter. Åbn derefter opkaldet med
GET /v1/calls/{call_id}: sip_headers skal indeholde
x-amzn-connectcontactid, og external_call_id skal svare til det ContactId,
din Lambda modtager. Hvis overførslen fejler med SIP 404, fandt ThunderPhone
ikke endpointets brugerdel: den skal være i både request-URI'en og To-headeren.
Begrænsninger
- AWS dokumenterer ingen måde at læse headers på
BYE, herunderX-TP-Handoff-Id, så kontakt-id'et er det eneste link tilbage til opkaldet. - AWS dokumenterer ikke en maksimal UUI-længde for connectoren.
- En synkron Lambda-blok får timeout efter 8 sekunder.