---
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 ключ](/bg/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 адрес на източника](/bg/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,
`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. Върнете обаждането

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

След това извлечете предаването с възел **HTTP заявка** в Copilot Studio:

- `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 удостоверяване.
- Microsoft изпраща най-много пет X-заглавки и запазва само първите пет при
  входящо обаждане. Dynamics 365 приема най-много 128 знака UUI.
- Microsoft не документира четенето на заглавки при `BYE`, затова предаването се
  връща само чрез търсенето.
