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 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. Шаљите позиве са контекстом

  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 секунди.