---
title: "Pripojenie z Microsoft Dynamics 365"
description: "Odosielajte hovory z Dynamics 365 Contact Center a Copilot Studio k hlasovému agentovi ThunderPhone prostredníctvom svojho SBC s hlavičkami X a vyhľadajte odovzdanie hovoru agentom cez HTTP."
---

Dynamics 365 Contact Center odošle volajúceho k agentovi cez váš hraničný riadiaci prvok relácie (SBC) s až piatimi X-hlavičkami vrátane ID konverzácie. Keď agent skončí, ukončí hovor, váš SBC vráti volajúceho do Dynamics 365 a uzol požiadavky HTTP načíta odovzdanie.

## Skôr než začnete

- Agent ThunderPhone a [kľúč API](/sk/guides/api-keys) organizácie.
- Hlasový kanál Dynamics 365 Contact Center pripojený cez Azure Communication Services **Priame smerovanie** k SBC, ktorý prevádzkujete
  ([požiadavky na SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  podporovaný SBC s verejným certifikátom, TLS 1.2 na porte 5061 a SRTP
  smerom k Microsoftu.
- **Podpora SIP X-hlavičiek** v uzle **Preniesť konverzáciu**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Potvrďte, že je vo vašom prostredí dostupná.

Dynamics 365 prenáša len na telefónne číslo a Microsoft overuje Priame smerovanie certifikátom, nie heslom. Váš SBC sa nachádza medzi Microsoftom a ThunderPhone a prevádza toto číslo na SIP adresu agenta.

## 1. Vytvorte koncový bod SIP

Hovor prichádza do ThunderPhone z vášho SBC, preto vytvorte štandardný koncový bod, ktorý bude SBC používať:

```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"}'
```

Heslo `password` z odpovede si ihneď uložte; zobrazí sa iba raz a váš SBC ním odpovie na výzvu ThunderPhone. Ak váš SBC nepodporuje autentifikáciu Digest, vytvorte koncový bod s hodnotou `auth` nastavenou na `ip_allowlist` a namiesto toho uveďte verejnú adresu vášho SBC; pozrite si
[platformy overované podľa zdrojovej IP adresy](/sk/guides/sip-addresses).

## 2. Odosielajte hovory s kontextom

1. Vyberte pre agenta na vašom SBC telefónne číslo, napríklad `+14155550188`.
2. Na SBC smerujte hovory na toto číslo do `sip_uri` koncového bodu, napríklad
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, cez TLS na porte
   `5061`. ThunderPhone nájde koncový bod podľa používateľskej časti
   (`agent-12-jhxmginwjx`), ktorá musí byť v URI požiadavky aj v
   hlavičke `To`. X-hlavičky odovzdajte bez zmien.
3. V Copilot Studio pridajte uzol **Preniesť konverzáciu** s možnosťou
   **Prenos na externé telefónne číslo** na toto číslo a pridajte X-hlavičky:
   - `X-Call-ID`: ID konverzácie Dynamics 365. Žiadna hlavička Microsoftu ho
     nenesie, preto ho pridajte tu; ThunderPhone ho uloží ako
     `external_call_id` hovoru. V Copilot Studio potvrďte, ktorá premenná obsahuje
     ID konverzácie.
   - Až štyri ďalšie, napríklad `X-Customer-Tier`.

Microsoft odosiela najviac päť X-hlavičiek s názvami dlhými až 64 znakov a
hodnotami dlhými až 256 znakov, pričom používa písmená, číslice a `= ; . ! % * _ + ~ -`. Predponu zapisuje malými písmenami ako `x-`; ThunderPhone porovnáva názvy hlavičiek bez ohľadu na veľkosť písmen, takže `x-customer-tier` sa dostane do promptu ako `{{sip_x_customer_tier}}`.

Ak hovor namiesto toho vytvárate pomocou Azure Communication Services Call Automation,
`AddSipX` predvolene zapisuje názvy `X-MS-Custom-`. Odovzdajte
`SipHeaderPrefix.X`, aby si `X-Call-ID` zachovalo svoj názov
([vlastný kontext](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Vráťte hovor späť

Hlasový agent vráti hovor: rozlúči sa a zavesí. Pridajte toto číslo pre
presmerovanie (pozrite si
[Pridanie čísla pre presmerovanie](/sk/guides/contact-centers/overview)):

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

Vrátenie volajúceho do Dynamics 365 je úlohou vášho SBC. Microsoft
dokumentuje jeden spôsob prichádzajúceho hovoru s kontextom: nový hovor cez SBC na
číslo zaregistrované v Dynamics 365 s UUI, ktorého kľúče zodpovedajú premenným kontextu,
ktoré nastavíte v časti **Pracovné toky → Rozšírené nastavenia**
([presmerovanie IVR tretej strany](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
S dodávateľom SBC si dohodnite, ako volajúci dosiahne toto číslo, keď
ThunderPhone zavesí, a preneste ID konverzácie, ktoré ste odoslali v `X-Call-ID`,
aby tok mohol hovor nájsť.

Potom načítajte odovzdanie pomocou uzla **Požiadavka HTTP** v Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  nasledované ID konverzácie.
- Hlavička `Authorization: Bearer sk_live_…`.
- Odpoveď spracujte do premennej a použite `handoff.summary` a
  `handoff.intent`.

Pozrite si časť [Vyhľadanie odovzdaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolajte na číslo Dynamics 365, ktoré vedie k uzlu presmerovania, požiadajte
agenta o spojenie s človekom a overte, že sa volajúci vráti do Dynamics 365. Potom otvorte
hovor pomocou `GET /v1/calls/{call_id}`: položka `sip_headers` by mala obsahovať `x-call-id` a
`external_call_id` by malo byť ID konverzácie. Ak hovor nikdy nedorazí k
agentovi a protokoly SBC zobrazujú SIP `404`, identifikátor URI požiadavky alebo hlavička `To`
neobsahuje používateľskú časť koncového bodu.

## Obmedzenia

- Vyžaduje sa SBC. Microsoft nemôže vytočiť adresu SIP ani odpovedať na výzvu
  digest.
- Microsoft odosiela najviac päť hlavičiek X a pri prichádzajúcom hovore uchová iba prvých päť. Dynamics 365 prijíma v UUI najviac 128 znakov.
- Microsoft nedokumentuje čítanie hlavičiek pri `BYE`, takže odovzdanie sa
  vráti iba prostredníctvom vyhľadania.
