---
title: "Контакт-центры"
description: "Перенаправляйте звонки из Amazon Connect, Five9, Genesys Cloud, Talkdesk, Twilio, Microsoft Dynamics 365, NICE CXone или Zoom Contact Center голосовому агенту ThunderPhone по SIP и возвращайте их обратно при передаче звонка агентом."
---

Агент ThunderPhone может отвечать на звонки в сценарии обработки вызовов вашего контактного центра.
Ваша платформа направляет вызов на [SIP-адрес](/ru/guides/sip-addresses) агента
с SIP-заголовками, которые содержат собственный идентификатор вызова и всё остальное, что ей известно
о звонящем. Когда звонящему нужен человек, агент передаёт вызов обратно
с передачей: сводкой потребностей звонящего, краткой меткой намерения и идентификатором,
который ваш сценарий может найти.

## Платформы

| Платформа | Как поступает вызов | Заголовок ID вызова | Как вызов возвращается | Как возвращается контекст |
|---|---|---|---|---|
| [Amazon Connect](/ru/guides/contact-centers/amazon-connect) | Внешний коннектор передачи голосовых вызовов; список разрешённых IP-адресов | `X-Amzn-ConnectContactId` | Возврат: агент завершает вызов, и сценарий продолжается | Lambda вызывает поиск передачи |
| [Five9](/ru/guides/contact-centers/five9) | Подключение AI-агента, настроенное Five9, к номеру для входящих вызовов; список разрешённых IP-адресов | `X-CallID` | Возврат: агент завершает вызов с заголовками маршрутизации в `BYE` | Заголовки `X-Route*` и `X-CustomMetaData` передаются в переменные вызова IVR |
| [Genesys Cloud](/ru/guides/contact-centers/genesys-cloud) | Транк BYOC Cloud; digest-аутентификация | `x-inin-cnv` | `REFER`, принимаемый функциями возврата и передачи | Шестнадцатеричный UUI в адресе передачи, затем действие с данными |
| [Talkdesk](/ru/guides/contact-centers/talkdesk) | Подключение к Autopilot Voice; список разрешённых IP-адресов | `X-Talkdesk-Interaction-Id` | `REFER` на адрес эскалации Talkdesk | Шестнадцатеричный UUI в адресе передачи, затем выполнение действия |
| [Twilio](/ru/guides/contact-centers/twilio) | `<Dial><Sip>`; digest-аутентификация | `X-Call-ID`, который вы добавляете | `REFER` в ваш обработчик `referUrl` | Заголовки в адресе передачи (`ReferTransferTarget`) |
| [Microsoft Dynamics 365](/ru/guides/contact-centers/microsoft-dynamics-365) | Передача на номер телефона через ваш SBC; digest-аутентификация | `X-Call-ID`, который вы добавляете | Возврат, затем ваш SBC направляет звонящего обратно | Узел HTTP-запроса вызывает поиск передачи |
| [NICE CXone](/ru/guides/contact-centers/nice-cxone) | Studio `Placecall` с `Sipputheader` на номер для входящих вызовов; список разрешённых IP-адресов | `X-Call-ID`, который вы добавляете | Возврат: агент завершает вызов (уточните у NICE, как сценарий возвращает звонящего) | Действие REST API вызывает поиск передачи |
| [Zoom Contact Center](/ru/guides/contact-centers/zoom-contact-center) | Виджет бота на транке, созданном Zoom, к номеру для входящих вызовов; список разрешённых IP-адресов с SRTP | `X-ZOOM-Call-Sid` | `REFER` на адрес оператора Zoom | Виджет HTTP-вызова вызывает поиск передачи |

## Как это работает

1. **Создайте SIP-конечную точку** для агента через API, в разделе **Телефон и веб**
   → **SIP-конечные точки** в приложении или через Zeus. Платформы, которые могут отвечать на
   запрос пароля, используют имя пользователя и пароль конечной точки. Платформы,
   которые идентифицируют себя только по исходным адресам, используют конечную точку с
   `auth`, установленным в `ip_allowlist`; см.
   [Платформы, аутентифицирующиеся по исходному IP-адресу](/ru/guides/sip-addresses).
   Платформы, которые набирают номер телефона, а не SIP-адрес, подключаются к
   конечной точке через её
   [номера для входящих звонков](/ru/guides/sip-addresses).
2. **Отправляйте вызовы с контекстом.** Платформа набирает `sip_uri` конечной точки или
   номер для входящих звонков.
   Каждый отправленный ею заголовок `X-` и `User-to-User` становится переменной вызова
   `{{sip_…}}`, которую может использовать промпт, а заголовок call-id сохраняется как
   `external_call_id` вызова. См.
   [Передача контекста вызова в SIP-заголовках](/ru/guides/sip-addresses).
3. **Добавьте один номер перевода для возврата вызова** — либо SIP-адрес
   на вашей платформе (агент отправляет `REFER`), либо
   [возврат](/ru/guides/call-transfers)
   (агент завершает вызов, а ваш сценарий продолжается). Его заголовки могут передавать
   `{{handoff_summary}}`, `{{handoff_intent}}` и `{{handoff_id}}`; см.
   [Передача контекста в ваш контакт-центр](/ru/guides/call-transfers).
4. **Получите данные о передаче** там, где их размещает ваша платформа, или найдите их по
   идентификатору вызова вашей платформы.

### Добавьте номер перевода

SIP-адреса, возвраты и их заголовки задаются через
[Agents API](/api-reference/agents#transfer-numbers). Запись заменяет весь
список, поэтому включите другие номера перевода агента, затем выполните
развёртывание:

```bash
curl -X PATCH https://api.thunderphone.com/v1/agents/12 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transfer_destinations": [{"name": "Contact center", "action": "return"}]}'

curl -X POST https://api.thunderphone.com/v1/agents/12/deploy \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Затем укажите агенту в промпте, когда использовать этот номер, по имени: «Когда звонящий
просит соединить с человеком или вы не можете обработать запрос, переведите вызов в Contact
center».

### Найдите данные передачи

Ваш сценарий может получить данные передачи с помощью API-ключа организации и
идентификатора вызова вашей платформы:

```bash
curl "https://api.thunderphone.com/v1/calls/handoff?external_call_id=YOUR_PLATFORM_CALL_ID" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Ответ содержит `handoff.summary`, `handoff.intent` и `handoff.handoff_id`,
SIP-заголовки и переменные, с которыми начался вызов, а после завершения
вызова — его сводку и извлечённые данные. Также можно найти вызов по
`handoff_id`. См.
[Поиск переданного вызова](/api-reference/calls#look-up-a-handed-off-call).

Храните API-ключ в хранилище учётных данных вашей платформы, а не в самом
сценарии.

<Warning>
  Значения заголовков поступают от того, кто отправляет вызов. Используйте их
  как контекст в промпте, а не для определения личности звонящего или того,
  какие действия ему разрешены.
</Warning>

## Руководства

<CardGroup cols={2}>
  <Card title="Amazon Connect" icon="phone" href="/ru/guides/contact-centers/amazon-connect">
    Внешняя передача голосового вызова туда, возврат и поиск через Lambda обратно.
  </Card>
  <Card title="Five9" icon="phone" href="/ru/guides/contact-centers/five9">
    AI Agent Connect туда, заголовки маршрутизации при завершении вызова обратно.
  </Card>
  <Card title="Genesys Cloud" icon="phone" href="/ru/guides/contact-centers/genesys-cloud">
    Транк BYOC Cloud туда, Take Back и Transfer с UUI обратно.
  </Card>
  <Card title="Talkdesk" icon="phone" href="/ru/guides/contact-centers/talkdesk">
    Подключение к Autopilot Voice туда, эскалация с UUI обратно.
  </Card>
  <Card title="Twilio" icon="phone" href="/ru/guides/contact-centers/twilio">
    TwiML Dial туда, REFER к вашему обработчику referUrl обратно.
  </Card>
  <Card title="Microsoft Dynamics 365" icon="phone" href="/ru/guides/contact-centers/microsoft-dynamics-365">
    Передача через ваш SBC туда, возврат и HTTP-поиск обратно.
  </Card>
  <Card title="NICE CXone" icon="phone" href="/ru/guides/contact-centers/nice-cxone">
    Studio Placecall туда, возврат и REST-поиск обратно.
  </Card>
  <Card title="Zoom Contact Center" icon="phone" href="/ru/guides/contact-centers/zoom-contact-center">
    Виджет бота туда, REFER к оператору обратно.
  </Card>
</CardGroup>
