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 дайджест, затова създайте крайна точка, която приема обаждания според адреса на източника:
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 секунди.