---
title: "Повезивање из услуге Amazon Connect"
description: "Проследите позиве услуге Amazon Connect агенту ThunderPhone путем SIP-а са ИД-ом контакта и UUI-јем и наставите ток са преносом агента."
---

Ваш Amazon Connect ток шаље позиваоца агенту са ИД-ом контакта и свим UUI вредностима које подесите. Када агент заврши, прекида позив, ваш ток се наставља, а Lambda преузима податке о преусмеравању по ИД-у контакта.

## Пре почетка

- ThunderPhone агент и [API кључ](/sr/guides/api-keys) организације.
- Конектор Amazon Connect-а **Спољни пренос гласа**. Прво затражите повећање квоте „Конектори за спољни пренос гласа по налогу“: мени остаје сакривен док га AWS не одобри. AWS наплаћује сваки конектор по дану
  ([$100 дневно од 21. јула 2025.](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  плус коришћење по минуту.

<Warning>
  Тренутни AWS водич за администраторе више нема странице за спољни пренос гласа.
  Пре него што га примените, потврдите са AWS-ом да је конектор доступан за вашу инстанцу и Регион.
</Warning>

## 1. Креирајте SIP крајњу тачку

Конектор не документује SIP digest аутентификацију, па креирајте
крајњу тачку која прихвата позиве према изворној адреси:

```bash
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 адреси](/sr/guides/sip-addresses)
за правила и ризик адресе коју деле сви корисници платформе. Сачувајте `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` од агента. Зато агент враћа позив: поздравља се и прекида везу, а Ваш ток се наставља након блока за пренос. Додајте овај број за пренос (погледајте [Додајте број за пренос](/sr/guides/contact-centers/overview)):

```json
{"name": "Amazon Connect", "action": "return"}
```

Затим преузмите податке о предаји помоћу блока **Позовите AWS Lambda функцију** након
преноса. Lambda проналази позив према ID-у контакта:

```python
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-у. Поља одговора су описана у
[Потражите предати позив](/api-reference/calls#look-up-a-handed-off-call).

## Тестирајте

Позовите број на Вашој 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 секунди.
