---
title: "Свързване от Amazon Connect"
description: "Изпращайте обаждания от Amazon Connect към агент на ThunderPhone през SIP с идентификатора на контакта и UUI и продължавайте потока си с прехвърлянето от агента."
---

Вашият поток в Amazon Connect изпраща обаждащия се към агента с
идентификатора на контакта и зададения от вас UUI. Когато агентът приключи,
той прекратява разговора, потокът ви продължава, а Lambda извлича предаването
по идентификатора на контакта.

## Преди да започнете

- Агент в ThunderPhone и [API ключ за организацията](/bg/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 дайджест, затова създайте
крайна точка, която приема обаждания според адреса на източника:

```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 адрес на източника](/bg/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` от агента. Затова агентът връща обаждането: сбогува се и
затваря, а вашият поток се възобновява след блока за прехвърляне. Добавете този номер за прехвърляне (вижте [Добавяне на номера за прехвърляне](/bg/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 секунди.
