---
title: "Ühenda Microsoft Dynamics 365-st"
description: "Suuna Dynamics 365 Contact Centeri ja Copilot Studio kõned X-päiste abil oma SBC kaudu ThunderPhone'i agendile ning otsi agendi üleandmist HTTP kaudu."
---

Dynamics 365 Contact Center saadab helistaja sinu seansipiirikontrolleri (SBC) kaudu häälagendile koos kuni viie X-päisega, sealhulgas vestluse ID-ga. Kui häälagent lõpetab, katkestab see kõne, sinu SBC suunab helistaja tagasi Dynamics 365-sse ning HTTP-päringu sõlm toob üleandmise andmed.

## Enne alustamist

- ThunderPhone'i häälagent ja organisatsiooni [API-võti](/et/guides/api-keys).
- Dynamics 365 Contact Centeri häälkanal, mis on Azure Communication Servicesi **otse marsruutimise** kaudu ühendatud sinu hallatava SBC-ga
  ([SBC nõuded](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  toetatud SBC avaliku sertifikaadiga, TLS 1.2 pordis 5061 ja SRTP Microsofti suunas.
- **SIP-i X-päiste tugi** sõlmes **Vestluse edastamine**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Veendu, et see on sinu keskkonnas saadaval.

Dynamics 365 edastab kõnesid ainult telefoninumbrile ning Microsoft autentib otsest marsruutimist sertifikaadiga, mitte parooliga. Sinu SBC paikneb Microsofti ja ThunderPhone'i vahel ning teisendab selle numbri häälagendi SIP-aadressiks.

## 1. Loo SIP-lõpp-punkt

Kõne jõuab ThunderPhone'i sinu SBC-st, seega loo SBC kasutamiseks tavaline lõpp-punkt:

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

Salvesta vastusest kohe `password`; seda kuvatakse üks kord ning sinu SBC vastab sellega ThunderPhone'i väljakutsele. Kui sinu SBC ei toeta digesta autentimist, loo lõpp-punkt hoopis väärtusega `auth` `ip_allowlist` ning määra oma SBC avalik aadress; vt [platvormid, mis autentivad lähte-IP järgi](/et/guides/sip-addresses).

## 2. Saada kõned koos kontekstiga

1. Vali oma SBC-s häälagendile telefoninumber, näiteks `+14155550188`.
2. Marsruudi SBC-s sellele numbrile saabuvad kõned lõpp-punkti `sip_uri`-le, näiteks `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, TLS-i kaudu pordis `5061`. ThunderPhone leiab lõpp-punkti kasutajaosa (`agent-12-jhxmginwjx`) järgi, mis peab olema nii päringu URI-s kui ka `To`-päises. Edasta X-päised muutmata kujul.
3. Lisa Copilot Studios sõlm **Vestluse edastamine**, mille valikuks on **Edastamine välisele telefoninumbrile**, sellele numbrile, ning lisa X-päised:
   - `X-Call-ID`: Dynamics 365 vestluse ID. Ükski Microsofti päis seda ei sisalda, seega lisa see siin; ThunderPhone salvestab selle kõne `external_call_id`-na. Kontrolli Copilot Studios, milline muutuja sisaldab vestluse ID-d.
   - Kuni neli täiendavat päist, näiteks `X-Customer-Tier`.

Microsoft saadab kuni viis X-päist, mille nimed on kuni 64 märki ja väärtused kuni 256 märki ning mis kasutavad tähti, numbreid ja märke `= ; . ! % * _ + ~ -`. See kirjutab eesliite väiketähtedega `x-`; ThunderPhone võrdleb päiste nimesid tõstutundeta, seega jõuab `x-customer-tier` viibani kujul `{{sip_x_customer_tier}}`.

Kui lood kõne selle asemel Azure Communication Services Call Automationiga, kirjutab `AddSipX` vaikimisi nimed kujul `X-MS-Custom-`. Edasta `SipHeaderPrefix.X`, et `X-Call-ID` säilitaks oma nime
([kohandatud kontekst](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Too kõne tagasi

Häälagent tagastab kõne: jätab hüvasti ja lõpetab kõne. Lisa see
edastusnumber (vt
[Edastusnumbri lisamine](/et/guides/contact-centers/overview)):

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

Helistaja tagasi Dynamics 365-sse toomine on sinu SBC ülesanne. Microsoft
dokumenteerib ühe viisi kontekstiga kõne sisenemiseks: uus kõne SBC kaudu
Dynamics 365-s registreeritud numbrile koos UUI-ga, mille võtmed vastavad
kontekstimuutujatele, mille seadistasid jaotises **Töövood → Täpsemad sätted**
([kolmanda osapoole IVR-i edastus](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Lepi oma SBC pakkujaga kokku, kuidas helistaja selleni numbrini jõuab, kui
ThunderPhone kõne lõpetab, ja edasta vestluse ID, mille saatsid `X-Call-ID`
päises, et voog saaks kõne üles leida.

Seejärel hangi üleandmise andmed Copilot Studio **HTTP-päringu** sõlmega:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  millele järgneb vestluse ID.
- Päis `Authorization: Bearer sk_live_…`.
- Pars i vastus muutujaks ning kasuta väärtusi `handoff.summary` ja
  `handoff.intent`.

Vt [Üleantud kõne otsimine](/api-reference/calls#look-up-a-handed-off-call).

## Testi seda

Helista Dynamics 365 numbrile, mis jõuab edastussõlmeni, palu häälagendilt
inimest ja kontrolli, et helistaja jõuab tagasi Dynamics 365-sse. Seejärel ava
kõne päringuga `GET /v1/calls/{call_id}`: `sip_headers` peaks sisaldama
väärtust `x-call-id` ning `external_call_id` peaks olema vestluse ID. Kui kõne
ei jõua kunagi häälagendini ja sinu SBC logides on SIP `404`, ei sisalda selle
päringu URI ega päis `To` lõpp-punkti kasutajaosa.

## Piirangud

- SBC on nõutav. Microsoft ei saa helistada SIP-aadressile ega vastata
  digest-autentimise väljakutsele.
- Microsoft saadab kuni viis X-päist ja säilitab sissetuleval kõnel ainult
  esimesed viis. Dynamics 365 aktsepteerib UUI-s kuni 128 märki.
- Microsoft ei dokumenteeri päiste lugemist `BYE` korral, seega tuleb
  üleandmise andmed tagasi ainult otsingu kaudu.