Open in
Pripojenie z Amazon Connect
Odosielajte hovory z Amazon Connect hlasovému agentovi ThunderPhone cez SIP s ID kontaktu a UUI a pokračujte vo svojom toku s odovzdaním agenta.
Váš tok Amazon Connect odošle volajúceho agentovi s identifikátorom kontaktu a ľubovoľným nastaveným UUI. Keď agent skončí, zavesí hovor, váš tok pokračuje a Lambda načíta odovzdanie podľa identifikátora kontaktu.
Skôr než začnete
- Agent ThunderPhone a kľúč API organizácie.
- Konektor Amazon Connect Externý hlasový prenos. Najprv požiadajte o zvýšenie kvóty „Konektory externého hlasového prenosu na účet“: ponuka zostane skrytá, kým ju AWS neschváli. AWS účtuje každý konektor za deň ($100 za deň od 21. júla 2025) plus používanie za minútu.
1. Vytvorte koncový bod SIP
Konektor nedokumentuje autentifikáciu SIP digest, preto vytvorte koncový bod, ktorý prijíma hovory podľa zdrojovej adresy:
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"]
}'Získajte od AWS signalizačné rozsahy SIP konektora pre váš región. Každý musí byť
verejný rozsah IPv4 s maskou /16 alebo užšou (IPv6 /48 alebo užšou). Pravidlá
a riziko adresy zdieľanej všetkými zákazníkmi platformy nájdete v časti
Platformy, ktoré sa autentifikujú podľa zdrojovej IP.
Uchovajte si sip_uri z odpovede, napríklad
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Odosielajte hovory s kontextom
- V konzole Amazon Connect otvorte Externé hlasové systémy → Integrácie prenosu hlasu a vyberte Vytvoriť.
- Vyberte typ cieľa (SBC) a pridajte odchádzajúcu trasu s hostiteľom
sip.thunderphone.com, portom5061a protokolom TLS. Koncový bod vyžaduje TLS alebo TCP (port5060) a odmieta UDP. AWS nedokumentuje, ktoré protokoly konektor ponúka, preto si u AWS overte, že môže použiť jeden z nich. - Do toku pridajte blok Preniesť na telefónne číslo, nastavte Preniesť do
na Externý hlasový systém a nastavte:
- ARN cieľa: konektor.
- Používateľ príjemcu: používateľská časť
sip_urikoncového bodu, napríkladagent-12-jhxmginwjx. - UUI (voliteľné): kontext pre agenta. Connect ho odosiela v hexadecimálnom kódovaní.
- Pokračovať v toku po odpojení: Áno, aby tok pokračoval, keď agent zavesí hovor.
Connect odosiela identifikátor kontaktu v X-Amzn-ConnectContactId. ThunderPhone ho ukladá
ako external_call_id hovoru, podľa ktorého váš tok hovor neskôr nájde.
UUI sa do výzvy dostane ako {{sip_uui}}. Integrácie tretích strán dokumentujú
hlavičku identifikátora kontaktu; vlastná dokumentácia AWS nie, preto ju skontrolujte pri
prvom testovacom hovore.
3. Získajte hovor späť
AWS neuvádza spôsob, ako môže Connect čítať hlavičky v BYE alebo prijať
REFER od agenta. Agent preto hovor vráti: rozlúči sa a zavesí a váš tok
pokračuje po bloku prenosu. Pridajte toto číslo prenosu (pozrite si Pridanie čísla prenosu):
{"name": "Amazon Connect", "action": "return"}Potom po prenose získajte odovzdanie pomocou bloku Vyvolať funkciu AWS Lambda. Lambda vyhľadá hovor podľa ID 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 vráti plochú mapu, takže tok môže vetviť podľa intent alebo nastaviť
summary ako atribút kontaktu pre osobu, ktorá hovor prevezme. Blok spúšťajte
synchrónne (maximálne 8 sekúnd) a kľúč API ukladajte zašifrovaný, napríklad v
službe AWS Secrets Manager. Polia odpovede sú uvedené v dokumentácii
Vyhľadanie odovzdaného hovoru.
Otestujte to
Zavolajte na číslo vo svojej inštancii Connect, ktoré vedie k bloku prenosu,
požiadajte agenta o spojenie s osobou a overte, že tok pokračuje. Potom otvorte
hovor pomocou GET /v1/calls/{call_id}: sip_headers by malo obsahovať
x-amzn-connectcontactid a external_call_id by sa malo rovnať hodnote
ContactId, ktorú prijme vaša Lambda. Ak prenos zlyhá s chybou SIP 404,
ThunderPhone nenašiel používateľskú časť koncového bodu: musí byť v URI
požiadavky aj v hlavičke To.
Obmedzenia
- AWS neuvádza spôsob, ako čítať hlavičky v
BYEvrátaneX-TP-Handoff-Id, takže ID kontaktu je jediným prepojením späť na hovor. - AWS neuvádza maximálnu dĺžku UUI pre konektor.
- Synchrónny blok Lambda po 8 sekundách vyprší.