Open in
Připojení z Amazon Connect
Přesměrujte hovory z Amazon Connect k agentovi ThunderPhone přes SIP s ID kontaktu a UUI a pokračujte ve svém toku po předání agentem.
Váš tok Amazon Connect odešle volajícího agentovi s ID kontaktu a libovolným UUI, které nastavíte. Když agent skončí, zavěsí, váš tok pokračuje a Lambda načte předání podle ID kontaktu.
Než začnete
- Agent ThunderPhone a klíč API organizace.
- Konektor Externí hlasový přenos služby Amazon Connect. Nejprve požádejte o zvýšení kvóty „Konektory externího hlasového přenosu na účet“: nabídka zůstane skrytá, dokud ji AWS neschválí. AWS účtuje každý konektor za den ($100 za den od 21. července 2025) plus využití za minutu.
1. Vytvořte koncový bod SIP
Konektor nedokumentuje ověřování SIP digest, proto vytvořte koncový bod, který přijímá hovory podle zdrojové 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ískejte od AWS rozsahy signalizace SIP konektoru pro váš Region. Každý musí být
veřejný rozsah IPv4 o velikosti /16 nebo menší (IPv6 /48 nebo menší). Pravidla
a riziko adresy sdílené všemi zákazníky platformy najdete v části
Platformy ověřované podle zdrojové IP.
Uložte si sip_uri z odpovědi, například
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Odesílejte hovory s kontextem
- V konzoli Amazon Connect otevřete Externí hlasové systémy → Integrace přenosu hlasu a zvolte Vytvořit.
- Vyberte typ cíle (SBC) a přidejte odchozí trasu s hostitelem
sip.thunderphone.com, portem5061a protokolem TLS. Koncový bod vyžaduje TLS nebo TCP (port5060) a odmítá UDP. AWS nedokumentuje, které protokoly konektor nabízí, proto u AWS ověřte, že může použít jeden z nich. - Do toku přidejte blok Přenos na telefonní číslo, u možnosti Přenést do
nastavte Externí hlasový systém a zadejte:
- ARN cíle: konektor.
- Uživateli: uživatelskou část
sip_urikoncového bodu, napříkladagent-12-jhxmginwjx. - UUI (volitelné): kontext pro agenta. Connect jej odesílá v hexadecimálním kódování.
- Pokračovat v toku po odpojení: Ano, aby tok pokračoval, když agent zavěsí.
Connect odesílá ID kontaktu v X-Amzn-ConnectContactId. ThunderPhone jej ukládá
jako external_call_id hovoru, podle kterého váš tok hovor později najde.
UUI se do promptu dostane jako {{sip_uui}}. Integrace třetích stran hlavičku
ID kontaktu dokumentují; vlastní dokumentace AWS nikoli, proto ji zkontrolujte
při prvním testovacím hovoru.
3. Nechte hovor vrátit
AWS nepopisuje žádný způsob, jak může Connect číst hlavičky v BYE nebo přijmout
REFER od agenta. Agent proto hovor vrátí: rozloučí se a zavěsí a váš tok se
obnoví po bloku přesměrování. Přidejte toto číslo přesměrování (viz Přidání čísla přesměrování):
{"name": "Amazon Connect", "action": "return"}Poté po přesměrování načtěte předání pomocí bloku Vyvolat funkci AWS Lambda. Funkce Lambda vyhledá hovor podle 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 vrací plochou mapu, takže tok se může větvit podle intent nebo nastavit
summary jako atribut kontaktu pro osobu, která hovor převezme. Spusťte blok
synchronně (až 8 sekund) a klíč API ukládejte zašifrovaný, například ve službě
AWS Secrets Manager. Pole odpovědi jsou popsána v části
Vyhledání předaného hovoru.
Otestujte to
Zavolejte na číslo ve své instanci Connect, které vede k bloku přesměrování,
požádejte agenta o spojení s osobou a ověřte, že se tok obnoví. Poté otevřete
hovor pomocí GET /v1/calls/{call_id}: sip_headers by mělo obsahovat
x-amzn-connectcontactid a external_call_id by se mělo rovnat ContactId,
které přijme vaše Lambda. Pokud přesměrování selže se SIP 404, ThunderPhone
nenašel uživatelskou část koncového bodu: musí být v identifikátoru URI požadavku
i v hlavičce To.
Omezení
- AWS nepopisuje žádný způsob, jak číst hlavičky v
BYE, včetněX-TP-Handoff-Id, takže ID kontaktu je jediným odkazem zpět na hovor. - AWS neuvádí maximální délku UUI pro konektor.
- Synchronní blok Lambda vyprší po 8 sekundách.