---
title: "Savienojiet no Microsoft Dynamics 365"
description: "Nosūtiet zvanus no Dynamics 365 Contact Center un Copilot Studio uz ThunderPhone balss aģentu, izmantojot savu SBC ar X galvenēm, un HTTP ceļā uzmeklējiet aģenta zvana pāradresēšanu."
---

Dynamics 365 Contact Center novirza zvanītāju uz balss aģentu, izmantojot jūsu
sesijas robežkontrolieri (SBC), ar līdz piecām X galvenēm, tostarp sarunas
ID. Kad balss aģents ir pabeidzis, tas noliek klausuli, jūsu SBC atgriež
zvanītāju pakalpojumā Dynamics 365, un HTTP pieprasījuma mezgls iegūst
pārsūtīšanas informāciju.

## Pirms sākat

- ThunderPhone balss aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- Dynamics 365 Contact Center balss kanāls, kas ar Azure
  Communication Services **Direct Routing** ir savienots ar jūsu pārvaldītu SBC
  ([SBC prasības](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  atbalstīts SBC ar publisku sertifikātu, TLS 1.2 portā 5061 un SRTP
  savienojumam ar Microsoft.
- **SIP X-galvenes atbalsts** mezglā **Transfer conversation**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Apstipriniet, ka tas ir pieejams jūsu vidē.

Dynamics 365 pārsūta tikai uz tālruņa numuru, un Microsoft autentificē
Direct Routing ar sertifikātu, nevis paroli. Jūsu SBC atrodas starp
Microsoft un ThunderPhone un pārvērš šo numuru par balss aģenta SIP adresi.

## 1. Izveidojiet SIP galapunktu

Zvans sasniedz ThunderPhone no jūsu SBC, tāpēc izveidojiet standarta galapunktu,
ko izmantot 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"}'
```

Nekavējoties saglabājiet atbildē saņemto `password`; tā tiek parādīta vienreiz,
un jūsu SBC ar to atbild uz ThunderPhone izaicinājumu. Ja jūsu SBC neatbalsta
digest autentifikāciju, tā vietā izveidojiet galapunktu ar `auth` iestatītu uz
`ip_allowlist` un norādiet sava SBC publisko adresi; skatiet
[Platformas, kas autentificē pēc avota IP](/lv/guides/sip-addresses).

## 2. Sūtiet zvanus ar kontekstu

1. Izvēlieties savā SBC balss aģentam tālruņa numuru, piemēram, `+14155550188`.
2. SBC maršrutējiet zvanus uz šo numuru uz galapunkta `sip_uri`, piemēram,
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, izmantojot TLS portā
   `5061`. ThunderPhone atrod galapunktu pēc lietotāja daļas
   (`agent-12-jhxmginwjx`), kurai jābūt gan pieprasījuma URI, gan
   `To` galvenē. Nododiet X-galvenes tālāk nemainītas.
3. Copilot Studio pievienojiet mezglu **Transfer conversation** ar
   **External phone number transfer** uz šo numuru un pievienojiet X-galvenes:
   - `X-Call-ID`: Dynamics 365 sarunas ID. Neviena Microsoft galvene to
     nenodod, tāpēc pievienojiet to šeit; ThunderPhone to saglabā kā zvana
     `external_call_id`. Copilot Studio apstipriniet, kurš mainīgais satur
     sarunas ID.
   - Līdz četrām papildu galvenēm, piemēram, `X-Customer-Tier`.

Microsoft nosūta ne vairāk kā piecas X-galvenes, kuru nosaukumi var būt līdz
64 rakstzīmēm gari un vērtības — līdz 256 rakstzīmēm garas, izmantojot burtus,
ciparus un `= ; . ! % * _ + ~ -`. Tā raksta prefiksu ar mazajiem burtiem
`x-`; ThunderPhone salīdzina galveņu nosaukumus, neņemot vērā reģistru,
tāpēc `x-customer-tier` uzvednē nonāk kā `{{sip_x_customer_tier}}`.

Ja tā vietā veidojat zvanu ar Azure Communication Services Call Automation,
`AddSipX` pēc noklusējuma raksta `X-MS-Custom-` nosaukumus. Nododiet
`SipHeaderPrefix.X`, lai `X-Call-ID` saglabātu savu nosaukumu
([pielāgots konteksts](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Saņemiet zvanu atpakaļ

Aģents atgriež zvanu: tas atvadās un noliek klausuli. Pievienojiet šo pārsūtīšanas
numuru (skatiet
[Pievienojiet pārsūtīšanas numuru](/lv/guides/contact-centers/overview)):

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

Par zvanītāja atgriešanu Dynamics 365 atbild jūsu SBC. Microsoft
dokumentē vienu veidu, kā ienākt zvanam ar kontekstu: jauns zvans caur SBC uz
Dynamics 365 reģistrētu numuru ar UUI, kura atslēgas atbilst konteksta
mainīgajiem, ko iestatījāt sadaļā **Darba plūsmas → Papildu iestatījumi**
([trešās puses IVR pārsūtīšana](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Saskaņojiet ar savu SBC piegādātāju, kā zvanītājs sasniedz šo numuru, kad
ThunderPhone noliek klausuli, un pārsūtiet sarunas ID, ko nosūtījāt laukā
`X-Call-ID`, lai plūsma varētu atrast zvanu.

Pēc tam izgūstiet nodošanu ar Copilot Studio **HTTP pieprasījuma** mezglu:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  kam seko sarunas ID.
- Galvene `Authorization: Bearer sk_live_…`.
- Parsējiet atbildi mainīgajā un izmantojiet `handoff.summary` un
  `handoff.intent`.

Skatiet [Meklējiet nodotu zvanu](/api-reference/calls#look-up-a-handed-off-call).

## Pārbaudiet

Zvaniet uz Dynamics 365 numuru, kas sasniedz pārsūtīšanas mezglu, palūdziet
aģentam savienot ar cilvēku un pārbaudiet, vai zvanītājs atgriežas Dynamics 365.
Pēc tam atveriet zvanu ar `GET /v1/calls/{call_id}`: laukā `sip_headers` jābūt
norādītam `x-call-id`, un `external_call_id` jābūt sarunas ID. Ja zvans nekad
nesasniedz aģentu un jūsu SBC žurnālos redzams SIP `404`, tā pieprasījuma URI
vai `To` galvenē nav galapunkta lietotāja daļas.

## Ierobežojumi

- Nepieciešams SBC. Microsoft nevar sastādīt SIP adresi vai atbildēt uz digest
  autentifikācijas pieprasījumu.
- Microsoft nosūta ne vairāk kā piecas X-galvenes un ienākošam zvanam saglabā
  tikai pirmās piecas. Dynamics 365 UUI pieņem ne vairāk kā 128 rakstzīmes.
- Microsoft nedokumentē galveņu nolasīšanu `BYE` ziņojumā, tāpēc nodošana tiek
  atgriezta tikai ar uzmeklēšanu.
