---
title: "Yhdistä Microsoft Dynamics 365:stä"
description: "Ohjaa Dynamics 365 Contact Centerin ja Copilot Studion puhelut ThunderPhone-agentille SBC:si kautta X-otsakkeilla ja hae agentin puhelunsiirto HTTP:n kautta."
---

Dynamics 365 Contact Center lähettää soittajan agentille istuntorajakontrollerisi (SBC) kautta enintään viidellä X-otsakkeella, mukaan lukien keskustelutunnus. Kun agentti on valmis, se katkaisee puhelun, SBC:si palauttaa soittajan Dynamics 365:een, ja HTTP Request -solmu hakee siirron.

## Ennen kuin aloitat

- ThunderPhone-agentti ja organisaation [API-avain](/fi/guides/api-keys).
- Dynamics 365 Contact Centerin puhekanava, joka on yhdistetty Azure Communication Servicesin **Direct Routing** -toiminnolla käyttämääsi SBC:hen
  ([SBC-vaatimukset](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  tuettu SBC, jossa on julkinen varmenne, TLS 1.2 portissa 5061 ja SRTP Microsoftiin päin.
- **SIP X-otsaketuki** **Keskustelun siirto** -solmussa
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Varmista, että se on käytettävissä ympäristössäsi.

Dynamics 365 siirtää puhelun vain puhelinnumeroon, ja Microsoft todentaa Direct Routingin varmenteella, ei salasanalla. SBC:si sijaitsee Microsoftin ja ThunderPhonen välissä ja muuntaa kyseisen numeron agentin SIP-osoitteeksi.

## 1. Luo SIP-päätepiste

Puhelu saapuu ThunderPhoneen SBC:si kautta, joten luo SBC:n käytettäväksi tavallinen päätepiste:

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

Tallenna vastauksen `password` heti; se näytetään vain kerran, ja SBC:si vastaa sillä ThunderPhonen haasteeseen. Jos SBC:si ei tue digest-todennusta, luo päätepiste siten, että `auth` on `ip_allowlist` ja käytä sen sijaan SBC:si julkista osoitetta; katso
[Lähde-IP-osoitteella todentavat alustat](/fi/guides/sip-addresses).

## 2. Välitä puhelut kontekstin kanssa

1. Valitse SBC:ssä agentille puhelinnumero, esimerkiksi `+14155550188`.
2. Reititä SBC:ssä tähän numeroon tulevat puhelut päätepisteen `sip_uri`-osoitteeseen, esimerkiksi `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, TLS:llä portissa `5061`. ThunderPhone löytää päätepisteen käyttäjäosan (`agent-12-jhxmginwjx`) perusteella, jonka on oltava sekä pyyntö-URI:ssa että `To`-otsakkeessa. Välitä X-otsakkeet muuttamattomina.
3. Lisää Copilot Studiossa **Keskustelun siirto** -solmu, jossa **Siirto ulkoiseen puhelinnumeroon** on asetettu tähän numeroon, ja lisää X-otsakkeet:
   - `X-Call-ID`: Dynamics 365:n keskustelutunnus. Mikään Microsoftin otsake ei sisällä sitä, joten lisää se tähän; ThunderPhone tallentaa sen puhelun `external_call_id`-arvoksi. Varmista Copilot Studiossa, mikä muuttuja sisältää keskustelutunnuksen.
   - Enintään neljä muuta otsaketta, kuten `X-Customer-Tier`.

Microsoft lähettää enintään viisi X-otsaketta, joiden nimet ovat enintään 64 merkkiä ja arvot enintään 256 merkkiä ja joissa käytetään kirjaimia, numeroita sekä merkkejä `= ; . ! % * _ + ~ -`. Se kirjoittaa etuliitteen pienillä kirjaimilla `x-`; ThunderPhone vastaa otsakenimiä kirjainkoosta riippumatta, joten `x-customer-tier` päätyy kehotteeseen muodossa `{{sip_x_customer_tier}}`.

Jos rakennat puhelun sen sijaan Azure Communication Services Call Automationilla, `AddSipX` kirjoittaa oletusarvoisesti `X-MS-Custom-`-nimet. Välitä `SipHeaderPrefix.X`, jotta `X-Call-ID` säilyttää nimensä
([mukautettu konteksti](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Palauta puhelu

Agentti palauttaa puhelun: se hyvästelee ja katkaisee puhelun. Lisää tämä
siirtonumero (katso
[Lisää siirtonumero](/fi/guides/contact-centers/overview)):

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

Soittajan palauttaminen Dynamics 365:een on SBC:si tehtävä. Microsoft
dokumentoi yhden tavan tuoda kontekstia sisältävä puhelu takaisin: uusi puhelu SBC:n kautta
Dynamics 365:een rekisteröityyn numeroon, jossa on UUI, jonka avaimet vastaavat
kohdassa **Työvirrat → Lisäasetukset** määrittämiäsi kontekstimuuttujia
([kolmannen osapuolen IVR-siirto](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Selvitä SBC-toimittajasi kanssa, miten soittaja pääsee tähän numeroon, kun
ThunderPhone katkaisee puhelun, ja välitä lähettämäsi keskustelutunnus `X-Call-ID`-otsakkeessa,
jotta työnkulku löytää puhelun.

Nouda sitten luovutustiedot Copilot Studion **HTTP-pyyntö** -solmulla:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ja sen perään keskustelutunnus.
- Otsake `Authorization: Bearer sk_live_…`.
- Jäsennä vastaus muuttujaan ja käytä arvoja `handoff.summary` ja
  `handoff.intent`.

Katso [Siirretyn puhelun haku](/api-reference/calls#look-up-a-handed-off-call).

## Testaa

Soita Dynamics 365 -numeroon, joka saavuttaa siirtosolmun, pyydä agenttia
yhdistämään sinut henkilölle ja tarkista, että soittaja palaa Dynamics 365:een. Avaa sitten
puhelu komennolla `GET /v1/calls/{call_id}`: kohdan `sip_headers` pitäisi sisältää `x-call-id`, ja
kohdan `external_call_id` pitäisi olla keskustelutunnus. Jos puhelu ei koskaan saavuta
agenttia ja SBC-lokeissa näkyy SIP `404`, sen pyyntö-URI tai `To`-otsake ei sisällä
päätepisteen käyttäjäosaa.

## Rajoitukset

- SBC vaaditaan. Microsoft ei voi soittaa SIP-osoitteeseen eikä vastata digest-haasteeseen.
- Microsoft lähettää enintään viisi X-otsaketta ja säilyttää saapuvassa puhelussa
  vain viisi ensimmäistä. Dynamics 365 hyväksyy UUI:ssa enintään 128 merkkiä.
- Microsoft ei dokumentoi otsakkeiden lukemista `BYE`-viestistä, joten luovutustiedot
  palautuvat vain haun kautta.
