---
title: "Povežite se iz Microsoft Dynamics 365"
description: "Usmjerite pozive iz rješenja Dynamics 365 Contact Center i Copilot Studio prema agentu ThunderPhone putem svojeg SBC-a s X-zaglavlima te putem HTTP-a dohvatite prijenos poziva agenta."
---

Dynamics 365 Contact Center šalje pozivatelja agentu putem Vašeg kontrolera
granice sesije (SBC), s najviše pet X-zaglavlja, uključujući ID razgovora. Kada
agent završi, prekida poziv, Vaš SBC vraća pozivatelja u
Dynamics 365, a čvor HTTP zahtjeva dohvaća predaju.

## Prije početka

- ThunderPhone agent i organizacijski [API ključ](/hr/guides/api-keys).
- Glasovni kanal za Dynamics 365 Contact Center, povezan putem usluge Azure
  Communication Services **Izravno usmjeravanje** sa SBC-om kojim upravljate
  ([zahtjevi za SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  podržani SBC s javnim certifikatom, TLS 1.2 na priključku 5061 i SRTP-om
  prema Microsoftu.
- **Podrška za SIP X-zaglavlja** na čvoru **Prijenos razgovora**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Potvrdite da je dostupna u Vašem okruženju.

Dynamics 365 prenosi samo na telefonski broj, a Microsoft provjerava autentičnost
Izravnog usmjeravanja certifikatom, a ne lozinkom. Vaš SBC nalazi se između
Microsofta i ThunderPhonea te taj broj pretvara u SIP adresu agenta.

## 1. Izradite SIP krajnju točku

Poziv dolazi do ThunderPhonea s Vašeg SBC-a, stoga izradite standardnu krajnju
točku koju će SBC upotrebljavati:

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

Odmah spremite `password` iz odgovora; prikazuje se samo jednom, a Vaš SBC njime
odgovara na ThunderPhoneov izazov. Ako Vaš SBC ne podržava digest
autentifikaciju, umjesto toga izradite krajnju točku s postavkom `auth` na
`ip_allowlist` i javnom adresom Vašeg SBC-a; pogledajte
[Platforme koje provjeravaju autentičnost prema izvornoj IP adresi](/hr/guides/sip-addresses).

## 2. Šaljite pozive s kontekstom

1. Odaberite telefonski broj za agenta na Vašem SBC-u, primjerice `+14155550188`.
2. Na SBC-u usmjerite pozive na taj broj prema `sip_uri` krajnje točke, na
   primjer `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, putem TLS-a na
   priključku `5061`. ThunderPhone pronalazi krajnju točku prema korisničkom
   dijelu (`agent-12-jhxmginwjx`), koji mora biti i u URI-ju zahtjeva i u
   zaglavlju `To`. Proslijedite X-zaglavlja nepromijenjena.
3. U alatu Copilot Studio dodajte čvor **Prijenos razgovora** s opcijom
   **Prijenos na vanjski telefonski broj** na taj broj te dodajte X-zaglavlja:
   - `X-Call-ID`: ID razgovora u sustavu Dynamics 365. Nijedno Microsoftovo
     zaglavlje ne sadrži ga, stoga ga dodajte ovdje; ThunderPhone ga pohranjuje
     kao `external_call_id` poziva. U alatu Copilot Studio potvrdite koja
     varijabla sadrži ID razgovora.
   - Do četiri dodatna zaglavlja, kao što je `X-Customer-Tier`.

Microsoft šalje najviše pet X-zaglavlja, s nazivima do 64 znaka i vrijednostima
do 256 znakova, koristeći slova, znamenke i `= ; . ! % * _ + ~ -`. Prefiks
zapisuje malim slovima kao `x-`; ThunderPhone uspoređuje nazive zaglavlja bez
obzira na velika i mala slova, pa `x-customer-tier` dolazi u prompt kao
`{{sip_x_customer_tier}}`.

Ako poziv umjesto toga izradite pomoću usluge Azure Communication Services Call
Automation, `AddSipX` prema zadanim postavkama zapisuje nazive `X-MS-Custom-`.
Proslijedite `SipHeaderPrefix.X` kako bi `X-Call-ID` zadržao svoj naziv
([prilagođeni kontekst](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Vratite poziv

Agent vraća poziv: pozdravlja se i prekida vezu. Dodajte ovaj broj za
preusmjeravanje (pogledajte
[Dodajte broj za preusmjeravanje](/hr/guides/contact-centers/overview)):

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

Vraćanje pozivatelja u Dynamics 365 zadatak je vašeg SBC-a. Microsoft
dokumentira jedan način ulaska za poziv s kontekstom: novi poziv preko SBC-a na
broj registriran u Dynamics 365, s UUI-jem čiji ključevi odgovaraju varijablama
konteksta koje ste postavili u odjeljku **Tijekovi rada → Napredne postavke**
([prijenos IVR-a treće strane](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Dogovorite s dobavljačem SBC-a kako pozivatelj dolazi do tog broja kada
ThunderPhone prekine vezu te prenesite ID razgovora koji ste poslali u
`X-Call-ID` kako bi tijek mogao pronaći poziv.

Zatim dohvatite podatke o predaji čvorom Copilot Studio **HTTP zahtjev**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  nakon kojeg slijedi ID razgovora.
- Zaglavlje `Authorization: Bearer sk_live_…`.
- Raščlanite odgovor u varijablu i upotrijebite `handoff.summary` i
  `handoff.intent`.

Pogledajte [Potražite predani poziv](/api-reference/calls#look-up-a-handed-off-call).

## Testirajte

Nazovite broj u sustavu Dynamics 365 koji vodi do čvora za preusmjeravanje,
zatražite od agenta osobu i provjerite vraća li se pozivatelj u Dynamics 365.
Zatim otvorite poziv pomoću `GET /v1/calls/{call_id}`: `sip_headers` bi trebao
navesti `x-call-id`, a `external_call_id` bi trebao biti ID razgovora. Ako poziv
nikada ne dođe do agenta, a zapisi vašeg SBC-a prikazuju SIP `404`, URI zahtjeva
ili zaglavlje `To` ne sadrži korisnički dio krajnje točke.

## Ograničenja

- SBC je obavezan. Microsoft ne može uspostaviti poziv na SIP adresu ni
  odgovoriti na digest provjeru autentičnosti.
- Microsoft šalje najviše pet X-zaglavlja i zadržava samo prvih pet u dolaznom
  pozivu. Dynamics 365 prihvaća najviše 128 znakova UUI-ja.
- Microsoft ne dokumentira čitanje zaglavlja u poruci `BYE`, stoga se podaci o
  predaji vraćaju samo putem pretraživanja.
