---
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 кључ](/sr/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 не подржава digest
потврду идентитета, уместо тога направите крајњу тачку са `auth` подешеним на
`ip_allowlist` и јавном адресом Вашег SBC-а; погледајте
[Платформе које потврђују идентитет према изворној IP адреси](/sr/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. Вратите позив

Агент враћа позив: поздравља се и прекида везу. Додајте овај број за
пренос (погледајте
[Додајте број за пренос](/sr/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`, па се пренос
  враћа само путем претраге.
