ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Contact centers

Свързване от 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. Изпращайте обаждания с контекст

  1. В конзолата на Amazon Connect отворете Външни гласови системи → Интеграции за прехвърляне на глас и изберете Създаване.
  2. Изберете типа на местоназначението (SBC) и добавете изходящ маршрут с хост sip.thunderphone.com, порт 5061 и протокол TLS. Крайната точка изисква TLS или TCP (порт 5060) и отказва UDP. AWS не документира кои протоколи предлага конекторът, затова потвърдете с AWS, че може да използва един от тях.
  3. Във вашия поток добавете блок Прехвърляне към телефонен номер, като зададете Прехвърляне към на Външна гласова система, и задайте:
    • 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 секунди.