---
title: "Подключение из Microsoft Dynamics 365"
description: "Направляйте звонки Dynamics 365 Contact Center и Copilot Studio агенту ThunderPhone через ваш SBC с X-заголовками и запрашивайте передачу звонка агентом по HTTP."
---

Dynamics 365 Contact Center направляет звонящего к агенту через ваш контроллер границы сеанса (SBC), передавая до пяти X-заголовков, включая идентификатор диалога. Когда агент завершает звонок, ваш SBC возвращает звонящего в Dynamics 365, а узел HTTP-запроса получает данные передачи.

## Перед началом работы

- Агент ThunderPhone и [ключ API](/ru/guides/api-keys) организации.
- Голосовой канал Dynamics 365 Contact Center, подключенный через Azure
  Communication Services **прямую маршрутизацию** к управляемому вами SBC
  ([требования к SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  поддерживаемый SBC с общедоступным сертификатом, TLS 1.2 на порту 5061 и SRTP
  в направлении Microsoft.
- **Поддержка SIP X-заголовков** в узле **Передача беседы**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Убедитесь, что она доступна в вашей среде.

Dynamics 365 передает вызовы только на номер телефона, а Microsoft проверяет
подлинность для прямой маршрутизации по сертификату, а не по паролю. Ваш SBC
располагается между Microsoft и ThunderPhone и преобразует этот номер в SIP-адрес
агента.

## 1. Создайте SIP-конечную точку

Вызов поступает в ThunderPhone с вашего SBC, поэтому создайте обычную конечную
точку для использования SBC:

```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": "Dynamics 365 SBC"}'
```

Сразу сохраните `password` из ответа: он отображается один раз, и ваш SBC
отвечает им на запрос проверки ThunderPhone. Если ваш SBC не поддерживает
дайджест-аутентификацию, вместо этого создайте конечную точку с `auth`,
установленным в `ip_allowlist`, и общедоступным адресом вашего SBC; см.
[Платформы, выполняющие аутентификацию по исходному IP-адресу](/ru/guides/sip-addresses).

## 2. Отправляйте вызовы с контекстом

1. Выберите на SBC номер телефона для агента, например `+14155550188`.
2. На SBC направьте вызовы на этот номер к `sip_uri` конечной точки, например
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, по TLS на порту
   `5061`. ThunderPhone находит конечную точку по пользовательской части
   (`agent-12-jhxmginwjx`), которая должна быть указана и в URI запроса, и в
   заголовке `To`. Передавайте X-заголовки без изменений.
3. В Copilot Studio добавьте узел **Передача беседы** с параметром
   **Перенаправление на внешний номер телефона** на этот номер и добавьте X-заголовки:
   - `X-Call-ID`: идентификатор диалога Dynamics 365. Ни один заголовок Microsoft
     его не содержит, поэтому добавьте его здесь; ThunderPhone сохраняет его как
     `external_call_id` вызова. Уточните в Copilot Studio, какая переменная содержит
     идентификатор диалога.
   - До четырех дополнительных заголовков, например `X-Customer-Tier`.

Microsoft отправляет не более пяти X-заголовков с именами длиной до 64 символов и
значениями длиной до 256 символов, используя буквы, цифры и `= ; . ! % * _ + ~ -`.
Префикс записывается в нижнем регистре как `x-`; ThunderPhone сопоставляет имена
заголовков без учета регистра, поэтому `x-customer-tier` попадает в промпт как
`{{sip_x_customer_tier}}`.

Если вместо этого вы создаете вызов с помощью Azure Communication Services Call
Automation, `AddSipX` по умолчанию записывает имена `X-MS-Custom-`. Передайте
`SipHeaderPrefix.X`, чтобы `X-Call-ID` сохранил свое имя
([пользовательский контекст](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Верните звонящего

Агент возвращает звонящего: прощается и завершает вызов. Добавьте этот номер
перевода (см.
[Добавление номера перевода](/ru/guides/contact-centers/overview)):

```json
{"name": "Dynamics 365", "action": "return"}
```

Возврат звонящего в Dynamics 365 — задача вашего SBC. Microsoft
документирует один способ входящего вызова с контекстом: новый вызов через SBC на
номер, зарегистрированный в Dynamics 365, с UUI, ключи которого соответствуют
переменным контекста, настроенным в разделе **Рабочие потоки → Расширенные настройки**
([перевод через стороннюю IVR](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Согласуйте с поставщиком SBC, как звонящий попадёт на этот номер после того, как
ThunderPhone завершит вызов, и передавайте идентификатор беседы, который вы отправили в `X-Call-ID`,
чтобы поток мог найти вызов.

Затем получите данные передачи с помощью узла Copilot Studio **HTTP-запрос**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  с идентификатором беседы после знака равенства.
- Заголовок `Authorization: Bearer sk_live_…`.
- Разберите ответ в переменную и используйте `handoff.summary` и
  `handoff.intent`.

См. [Поиск переданного вызова](/api-reference/calls#look-up-a-handed-off-call).

## Проверьте работу

Позвоните на номер Dynamics 365, который ведёт к узлу перевода, попросите агента
соединить с человеком и убедитесь, что звонящий возвращается в Dynamics 365. Затем откройте
вызов с помощью `GET /v1/calls/{call_id}`: в `sip_headers` должен быть указан `x-call-id`, а
`external_call_id` должен содержать идентификатор беседы. Если вызов не доходит до
агента и в журналах SBC есть SIP `404`, URI запроса или заголовок `To` не содержит
пользовательскую часть конечной точки.

## Ограничения

- Требуется SBC. Microsoft не может набрать SIP-адрес или ответить на digest
  challenge.
- Microsoft отправляет не более пяти X-заголовков и сохраняет только первые пять
  во входящем вызове. Dynamics 365 принимает не более 128 символов UUI.
- Microsoft не документирует чтение заголовков при `BYE`, поэтому данные передачи
  можно получить только через поиск.
