---
title: "Povežite se iz Microsoft Dynamics 365"
description: "Klice iz Dynamics 365 Contact Center in Copilot Studio usmerite do glasovnega agenta ThunderPhone prek svojega SBC-ja z glavami X ter prek HTTP pridobite podatke o predaji agenta."
---

Dynamics 365 Contact Center pošlje klicatelja agentu prek vašega mejnega
krmilnika sej (SBC) z do petimi X-glavami, vključno z ID-jem pogovora. Ko agent
konča, prekine klic, vaš SBC klicatelja vrne v Dynamics 365, vozlišče HTTP Request
pa pridobi predajo.

## Preden začnete

- Agent ThunderPhone in organizacijski [ključ API](/sl/guides/api-keys).
- Glasovni kanal Dynamics 365 Contact Center, povezan prek storitve Azure
  Communication Services **Direct Routing** s SBC-jem, ki ga upravljate
  ([zahteve za SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  podprt SBC z javnim potrdilom, TLS 1.2 na vratih 5061 in SRTP proti Microsoftu.
- **Podpora za SIP X-glave** v vozlišču **Transfer conversation**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Potrdite, da je na voljo v vašem okolju.

Dynamics 365 prenese klic samo na telefonsko številko, Microsoft pa Direct Routing
preverja s potrdilom, ne z geslom. Vaš SBC je med Microsoftom in ThunderPhone ter
to številko pretvori v SIP-naslov agenta.

## 1. Ustvarite končno točko SIP

Klic doseže ThunderPhone z vašega SBC-ja, zato ustvarite standardno končno točko,
ki jo bo uporabljal 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"}'
```

Takoj shranite `password` iz odgovora; prikaže se samo enkrat, vaš SBC pa z njim
odgovori na izziv ThunderPhone. Če vaš SBC ne podpira avtentikacije digest,
namesto tega ustvarite končno točko z `auth`, nastavljenim na `ip_allowlist`, in
javnim naslovom vašega SBC-ja; glejte
[Platforme, ki preverjajo pristnost po izvornem IP-ju](/sl/guides/sip-addresses).

## 2. Pošiljajte klice s kontekstom

1. Na SBC-ju izberite telefonsko številko za agenta, na primer `+14155550188`.
2. Na SBC-ju usmerite klice na to številko v `sip_uri` končne točke, na
   primer `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, prek TLS na vratih
   `5061`. ThunderPhone najde končno točko po uporabniškem delu
   (`agent-12-jhxmginwjx`), ki mora biti v URI-ju zahteve in glavi
   `To`. X-glave posredujte nespremenjene.
3. V Copilot Studio dodajte vozlišče **Transfer conversation** z možnostjo
   **External phone number transfer** na to številko in dodajte X-glave:
   - `X-Call-ID`: ID pogovora Dynamics 365. Nobena Microsoftova glava ga ne
     vsebuje, zato ga dodajte tukaj; ThunderPhone ga shrani kot
     `external_call_id` klica. V Copilot Studio potrdite, katera spremenljivka
     vsebuje ID pogovora.
   - Do štiri dodatne, na primer `X-Customer-Tier`.

Microsoft pošlje največ pet X-glav z imeni do 64 znakov in vrednostmi do 256
znakov, pri čemer uporablja črke, številke in `= ; . ! % * _ + ~ -`. Predpono
zapiše z malimi črkami kot `x-`; ThunderPhone imena glav primerja ne glede na
velikost črk, zato `x-customer-tier` doseže poziv kot `{{sip_x_customer_tier}}`.

Če klic namesto tega ustvarite z Azure Communication Services Call Automation,
`AddSipX` privzeto zapiše imena `X-MS-Custom-`. Posredujte
`SipHeaderPrefix.X`, da `X-Call-ID` ohrani svoje ime
([kontekst po meri](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Prejmite klic nazaj

Agent vrne klic: poslovi se in prekine povezavo. Dodajte to številko za
preusmeritev (glejte
[Dodajte številko za preusmeritev](/sl/guides/contact-centers/overview)):

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

Za vrnitev klicatelja v Dynamics 365 je odgovoren vaš SBC. Microsoft
dokumentira en način za dohodni klic s kontekstom: nov klic prek SBC-ja na
številko, registrirano v Dynamics 365, z UUI, katerega ključi se ujemajo s
spremenljivkami konteksta, ki jih nastavite v razdelku **Delovni tokovi → Napredne nastavitve**
([prenos iz IVR-ja tretje osebe](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Z dobaviteljem SBC-ja uskladite, kako klicatelj doseže to številko, ko
ThunderPhone prekine povezavo, in prenesite ID pogovora, ki ste ga poslali v `X-Call-ID`,
da lahko tok najde klic.

Nato pridobite predajo z vozliščem **Zahteva HTTP** v Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ki mu sledi ID pogovora.
- Glava `Authorization: Bearer sk_live_…`.
- Razčlenite odgovor v spremenljivko ter uporabite `handoff.summary` in
  `handoff.intent`.

Glejte [Poiščite predani klic](/api-reference/calls#look-up-a-handed-off-call).

## Preizkusite

Pokličite številko Dynamics 365, ki doseže vozlišče za preusmeritev, prosite
agenta za osebo in preverite, da se klicatelj vrne v Dynamics 365. Nato odprite
klic z `GET /v1/calls/{call_id}`: `sip_headers` mora vsebovati `x-call-id`, medtem ko
mora biti `external_call_id` ID pogovora. Če klic nikoli ne doseže agenta in dnevniki
vašega SBC-ja prikazujejo SIP `404`, URI zahteve ali glava `To` ne vsebujeta
uporabniškega dela končne točke.

## Omejitve

- SBC je obvezen. Microsoft ne more klicati naslova SIP ali odgovoriti na izziv
  digest.
- Microsoft pošlje največ pet glav X in ob dohodnem klicu ohrani le prvih pet.
  Dynamics 365 sprejme največ 128 znakov UUI.
- Microsoft ne dokumentira branja glav pri `BYE`, zato se predaja vrne le prek
  poizvedbe.
