---
title: "Připojení z Microsoft Dynamics 365"
description: "Směrujte hovory z Dynamics 365 Contact Center a Copilot Studio k agentovi ThunderPhone prostřednictvím svého SBC s hlavičkami X a vyhledejte předání agenta přes HTTP."
---

Dynamics 365 Contact Center odesílá volajícího k agentovi prostřednictvím vašeho
hraničního řadiče relací (SBC), a to až s pěti hlavičkami X včetně ID
konverzace. Když agent skončí, zavěsí, váš SBC přivede volajícího zpět do
Dynamics 365 a uzel požadavku HTTP načte předání.

## Než začnete

- Agent ThunderPhone a organizační [klíč API](/cs/guides/api-keys).
- Hlasový kanál Dynamics 365 Contact Center připojený přes Azure
  Communication Services **Přímé směrování** k SBC, který provozujete
  ([požadavky na SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  podporovaný SBC s veřejným certifikátem, TLS 1.2 na portu 5061 a SRTP
  směrem k Microsoftu.
- **Podpora hlaviček SIP X** v uzlu **Přesměrovat konverzaci**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Ověřte, že je ve vašem prostředí k dispozici.

Dynamics 365 přesměrovává pouze na telefonní číslo a Microsoft ověřuje
Přímé směrování pomocí certifikátu, nikoli hesla. Váš SBC stojí mezi
Microsoftem a ThunderPhone a přesměruje toto číslo na SIP adresu agenta.

## 1. Vytvořte koncový bod SIP

Hovor přichází do ThunderPhone z vašeho SBC, proto vytvořte standardní koncový
bod, který bude SBC používat:

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

Heslo `password` z odpovědi ihned uložte; zobrazí se pouze jednou a váš SBC jím
odpoví na výzvu ThunderPhone. Pokud váš SBC nepodporuje ověřování pomocí
mechanismu Digest, vytvořte místo toho koncový bod s hodnotou `auth` nastavenou
na `ip_allowlist` a veřejnou adresou vašeho SBC; viz
[Platformy ověřované podle zdrojové IP adresy](/cs/guides/sip-addresses).

## 2. Odesílejte hovory s kontextem

1. Na SBC vyberte telefonní číslo pro agenta, například `+14155550188`.
2. Na SBC směrujte hovory na toto číslo do `sip_uri` koncového bodu, například
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, přes TLS na portu
   `5061`. ThunderPhone vyhledá koncový bod podle uživatelské části
   (`agent-12-jhxmginwjx`), která musí být jak v identifikátoru URI požadavku,
   tak v hlavičce `To`. Hlavičky X předejte beze změny.
3. V Copilot Studio přidejte uzel **Přesměrovat konverzaci** s možností
   **Přesměrování na externí telefonní číslo** na toto číslo a přidejte
   hlavičky X:
   - `X-Call-ID`: ID konverzace Dynamics 365. Žádná hlavička Microsoftu je
     nepřenáší, proto je přidejte zde; ThunderPhone je uloží jako
     `external_call_id` hovoru. V Copilot Studio ověřte, která proměnná
     obsahuje ID konverzace.
   - Až čtyři další, například `X-Customer-Tier`.

Microsoft odesílá nejvýše pět hlaviček X, s názvy o délce až 64 znaků a
hodnotami o délce až 256 znaků, s použitím písmen, číslic a znaků
`= ; . ! % * _ + ~ -`. Prefix zapisuje malými písmeny jako `x-`; ThunderPhone
porovnává názvy hlaviček bez ohledu na velikost písmen, takže
`x-customer-tier` se do promptu dostane jako `{{sip_x_customer_tier}}`.

Pokud místo toho sestavujete hovor pomocí Azure Communication Services Call
Automation, `AddSipX` ve výchozím nastavení zapisuje názvy `X-MS-Custom-`.
Předejte `SipHeaderPrefix.X`, aby si `X-Call-ID` zachovalo svůj název
([vlastní kontext](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Vraťte hovor zpět

Agent hovor vrátí: rozloučí se a zavěsí. Přidejte toto číslo pro přepojení (viz
[Přidání čísla pro přepojení](/cs/guides/contact-centers/overview)):

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

Vrácení volajícího do Dynamics 365 zajišťuje vaše SBC. Microsoft
dokumentuje jeden způsob příchozího hovoru s kontextem: nový hovor přes SBC na
číslo registrované v Dynamics 365 s UUI, jehož klíče odpovídají proměnným
kontextu, které nastavíte v části **Pracovní proudy → Upřesnit nastavení**
([přepojení IVR třetí strany](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
S dodavatelem SBC si domluvte, jak se volající dostane na toto číslo, když
ThunderPhone zavěsí, a přeneste ID konverzace, které jste odeslali v `X-Call-ID`,
aby tok mohl hovor najít.

Poté načtěte předání pomocí uzlu **Požadavek HTTP** v Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  následované ID konverzace.
- Hlavička `Authorization: Bearer sk_live_…`.
- Odpověď analyzujte do proměnné a použijte `handoff.summary` a
  `handoff.intent`.

Viz [Vyhledání předaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolejte na číslo Dynamics 365, které vede k uzlu přepojení, požádejte agenta
o spojení s člověkem a ověřte, že se volající vrátí do Dynamics 365. Poté
otevřete hovor pomocí `GET /v1/calls/{call_id}`: `sip_headers` by mělo uvádět
`x-call-id` a `external_call_id` by mělo být ID konverzace. Pokud hovor nikdy
nedosáhne agenta a protokoly SBC obsahují SIP `404`, identifikátor URI požadavku
nebo hlavička `To` neobsahuje uživatelskou část koncového bodu.

## Omezení

- Je vyžadováno SBC. Microsoft nemůže volat na adresu SIP ani odpovídat na
  výzvu digest.
- Microsoft odesílá nejvýše pět hlaviček X a u příchozího hovoru zachová pouze
  prvních pět. Dynamics 365 přijímá nejvýše 128 znaků UUI.
- Microsoft nedokumentuje čtení hlaviček při `BYE`, takže předání se vrací
  pouze prostřednictvím vyhledání.
