---
title: "Prisijungimas iš Microsoft Dynamics 365"
description: "Per savo SBC siųskite Dynamics 365 Contact Center ir Copilot Studio skambučius balso agentui ThunderPhone naudodami X antraštes ir per HTTP gaukite agento perdavimo duomenis."
---

Dynamics 365 Contact Center nukreipia skambinantįjį į agentą per jūsų sesijos
sieninį valdiklį (SBC), perduodamas iki penkių X antraščių, įskaitant pokalbio
identifikatorių. Kai agentas baigia skambutį, jūsų SBC grąžina skambinantįjį į
Dynamics 365, o HTTP Request mazgas gauna perdavimo informaciją.

## Prieš pradėdami

- ThunderPhone agentas ir organizacijos [API raktas](/lt/guides/api-keys).
- Dynamics 365 Contact Center balso kanalas, prijungtas per Azure
  Communication Services **Tiesioginį maršrutizavimą** prie jūsų valdomo SBC
  ([SBC reikalavimai](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  palaikomas SBC su viešuoju sertifikatu, TLS 1.2 per 5061 prievadą ir SRTP
  ryšiu su Microsoft.
- **SIP X antraščių palaikymas** **Pokalbio perkėlimo** mazge
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Patvirtinkite, kad jis pasiekiamas jūsų aplinkoje.

Dynamics 365 perkelia tik į telefono numerį, o Microsoft autentifikuoja
tiesioginį maršrutizavimą sertifikatu, o ne slaptažodžiu. Jūsų SBC yra tarp
Microsoft ir ThunderPhone bei paverčia šį numerį agento SIP adresu.

## 1. Sukurkite SIP galinį tašką

Skambutis ThunderPhone pasiekia iš jūsų SBC, todėl sukurkite standartinį galinį
tašką, kurį naudos 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"}'
```

Iš karto išsaugokite atsakyme pateiktą `password`; jis rodomas vieną kartą, o
jūsų SBC juo atsako į ThunderPhone užklausą. Jei jūsų SBC nepalaiko digest
autentifikavimo, vietoje to sukurkite galinį tašką, nustatę `auth` į
`ip_allowlist` ir nurodę viešąjį SBC adresą; žr.
[Platformos, kurios autentifikuoja pagal šaltinio IP](/lt/guides/sip-addresses).

## 2. Siųskite skambučius su kontekstu

1. SBC pasirinkite agento telefono numerį, pavyzdžiui, `+14155550188`.
2. SBC nukreipkite skambučius į šį numerį į galinio taško `sip_uri`, pavyzdžiui,
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, naudodami TLS per prievadą
   `5061`. ThunderPhone galinį tašką randa pagal naudotojo dalį
   (`agent-12-jhxmginwjx`), kuri turi būti ir užklausos URI, ir
   `To` antraštėje. Perduokite X antraštes nepakeistas.
3. Copilot Studio pridėkite **Pokalbio perkėlimo** mazgą su
   **Perkėlimu į išorinį telefono numerį** į šį numerį ir pridėkite X antraštes:
   - `X-Call-ID`: Dynamics 365 pokalbio identifikatorius. Jokia Microsoft
     antraštė jo neperduoda, todėl pridėkite jį čia; ThunderPhone išsaugo jį kaip
     skambučio `external_call_id`. Copilot Studio patvirtinkite, kuriame
     kintamajame saugomas pokalbio identifikatorius.
   - Dar iki keturių antraščių, pavyzdžiui, `X-Customer-Tier`.

Microsoft siunčia daugiausia penkias X antraštes, kurių pavadinimai gali būti iki
64 simbolių, o reikšmės iki 256 simbolių; naudojamos raidės, skaitmenys ir
`= ; . ! % * _ + ~ -`. Priešdėlį ji rašo mažosiomis raidėmis kaip `x-`;
ThunderPhone antraščių pavadinimus lygina nepaisydamas didžiųjų ir mažųjų
raidžių, todėl `x-customer-tier` raginimą pasiekia kaip `{{sip_x_customer_tier}}`.

Jei skambutį kuriate naudodami Azure Communication Services Call Automation,
`AddSipX` pagal numatytuosius nustatymus įrašo `X-MS-Custom-` pavadinimus.
Perduokite `SipHeaderPrefix.X`, kad `X-Call-ID` išlaikytų savo pavadinimą
([pasirinktinis kontekstas](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Grąžinkite skambutį

Agentas grąžina skambutį: jis atsisveikina ir nutraukia ryšį. Pridėkite šį perdavimo
numerį (žr.
[Pridėkite perdavimo numerį](/lt/guides/contact-centers/overview)):

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

Skambinančiojo grąžinimas į Dynamics 365 yra jūsų SBC užduotis. Microsoft
dokumentuoja vieną būdą, kaip priimti skambutį su kontekstu: naują skambutį per SBC į
Dynamics 365 užregistruotą numerį su UUI, kurio raktai atitinka konteksto kintamuosius,
kuriuos nustatėte skiltyje **Darbo srautai → Išplėstiniai nustatymai**
([trečiosios šalies IVR perdavimas](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Su SBC tiekėju išsiaiškinkite, kaip skambinantysis pasiekia šį numerį, kai
ThunderPhone nutraukia ryšį, ir perduokite pokalbio identifikatorių, kurį išsiuntėte
per `X-Call-ID`, kad srautas galėtų rasti skambutį.

Tada gaukite perdavimo duomenis naudodami Copilot Studio **HTTP užklausos** mazgą:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  po kurio nurodomas pokalbio identifikatorius.
- Antraštė `Authorization: Bearer sk_live_…`.
- Išanalizuokite atsakymą į kintamąjį ir naudokite `handoff.summary` bei
  `handoff.intent`.

Žr. [Raskite perduotą skambutį](/api-reference/calls#look-up-a-handed-off-call).

## Išbandykite

Paskambinkite į Dynamics 365 numerį, kuris pasiekia perdavimo mazgą, paprašykite agento
žmogaus ir patikrinkite, ar skambinantysis grįžta į Dynamics 365. Tada atidarykite
skambutį naudodami `GET /v1/calls/{call_id}`: `sip_headers` turėtų nurodyti
`x-call-id`, o `external_call_id` turėtų būti pokalbio identifikatorius. Jei skambutis
niekada nepasiekia agento ir jūsų SBC žurnaluose matomas SIP `404`, jo užklausos URI
arba `To` antraštėje nėra galinio taško naudotojo dalies.

## Ribojimai

- Reikalingas SBC. Microsoft negali skambinti SIP adresu ar atsakyti į Digest
  autentifikavimo iššūkį.
- Microsoft siunčia ne daugiau kaip penkias X antraštes ir įeinančiame skambutyje
  išsaugo tik pirmąsias penkias. Dynamics 365 priima ne daugiau kaip 128 UUI simbolius.
- Microsoft nedokumentuoja antraščių nuskaitymo iš `BYE`, todėl perdavimo duomenys
  grąžinami tik per paiešką.
