Open in
Повезивање из услуге Amazon Connect
Проследите позиве услуге Amazon Connect агенту ThunderPhone путем SIP-а са ИД-ом контакта и UUI-јем и наставите ток са преносом агента.
Ваш Amazon Connect ток шаље позиваоца агенту са ИД-ом контакта и свим UUI вредностима које подесите. Када агент заврши, прекида позив, ваш ток се наставља, а Lambda преузима податке о преусмеравању по ИД-у контакта.
Пре почетка
- ThunderPhone агент и API кључ организације.
- Конектор Amazon Connect-а Спољни пренос гласа. Прво затражите повећање квоте „Конектори за спољни пренос гласа по налогу“: мени остаје сакривен док га AWS не одобри. AWS наплаћује сваки конектор по дану ($100 дневно од 21. јула 2025.) плус коришћење по минуту.
1. Креирајте SIP крајњу тачку
Конектор не документује SIP digest аутентификацију, па креирајте крајњу тачку која прихвата позиве према изворној адреси:
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"]
}'Преузмите SIP сигналне опсеге конектора за ваш Регион од AWS-а. Сваки мора бити
јавни IPv4 опсег величине /16 или ужи (IPv6 /48 или ужи). Погледајте
Платформе које се аутентификују према изворној IP адреси
за правила и ризик адресе коју деле сви корисници платформе. Сачувајте sip_uri
из одговора, на пример
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Шаљите позиве са контекстом
- У Amazon Connect конзоли отворите Спољни гласовни системи → Интеграције преноса гласа и изаберите Креирајте.
- Изаберите тип одредишта (SBC) и додајте излазну руту са хостом
sip.thunderphone.com, портом5061и TLS протоколом. Крајња тачка захтева TLS или TCP (порт5060) и одбија UDP. AWS не документује које протоколе конектор нуди, па потврдите са AWS-ом да може да користи један од њих. - У свом току додајте блок Пренеси на број телефона са опцијом Пренеси на
постављеном на Спољни гласовни систем, а затим подесите:
- ARN одредишта: конектор.
- Кориснику: кориснички део
sip_uriкрајње тачке, као што јеagent-12-jhxmginwjx. - UUI (опционално): контекст за агента. Connect га шаље хексадецимално кодираног.
- Настави ток након прекида везе: Да, како би се ток наставио када агент прекине позив.
Connect шаље ИД контакта у X-Amzn-ConnectContactId. ThunderPhone га чува
као external_call_id позива, помоћу којег ваш ток касније проналази позив.
UUI стиже у упутство као {{sip_uui}}. Интеграције независних произвођача
документују заглавље ИД-а контакта; AWS-ова сопствена документација то не чини,
па га проверите при првом пробном позиву.
3. Вратите позив
AWS не документује начин да Connect чита заглавља у BYE поруци или да прихвати
REFER од агента. Зато агент враћа позив: поздравља се и прекида везу, а Ваш ток се наставља након блока за пренос. Додајте овај број за пренос (погледајте Додајте број за пренос):
{"name": "Amazon Connect", "action": "return"}Затим преузмите податке о предаји помоћу блока Позовите AWS Lambda функцију након преноса. Lambda проналази позив према 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 "",
}Блок враћа равну мапу, па ток може да се грана према intent или да постави
summary као атрибут контакта за особу која преузима позив. Покрените блок
синхроно (до 8 секунди) и чувајте API кључ шифрован, на пример у AWS Secrets Manager-у. Поља одговора су описана у
Потражите предати позив.
Тестирајте
Позовите број на Вашој Connect инстанци који води до блока за пренос, затражите од
агента да Вас повеже са особом и проверите да ли се ток наставља. Затим отворите позив помоћу
GET /v1/calls/{call_id}: sip_headers би требало да садржи
x-amzn-connectcontactid, а external_call_id би требало да буде једнак ContactId вредности
коју Ваша Lambda прима. Ако пренос не успе са SIP грешком 404, ThunderPhone није
пронашао кориснички део крајње тачке: мора бити и у URI-ју захтева и у заглављу To.
Ограничења
- AWS не документује начин за читање заглавља у
BYEпоруци, укључујућиX-TP-Handoff-Id, па је ID контакта једина веза назад до позива. - AWS не документује максималну дужину UUI вредности за конектор.
- Синхрони Lambda блок истиче након 8 секунди.