---
title: "Połącz z Microsoft Dynamics 365"
description: "Przekierowuj połączenia z Dynamics 365 Contact Center i Copilot Studio do agenta ThunderPhone przez SBC za pomocą nagłówków X oraz sprawdzaj przekazanie agenta przez HTTP."
---

Dynamics 365 Contact Center kieruje rozmówcę do agenta przez Twój kontroler
graniczny sesji (SBC), z maksymalnie pięcioma nagłówkami X, w tym identyfikatorem
rozmowy. Gdy agent zakończy pracę, rozłącza połączenie, Twój SBC przekazuje rozmówcę
z powrotem do Dynamics 365, a węzeł HTTP Request pobiera przekazanie.

## Zanim zaczniesz

- Agent ThunderPhone i organizacyjny [klucz API](/pl/guides/api-keys).
- Kanał głosowy Dynamics 365 Contact Center, połączony przez Azure
  Communication Services **Direct Routing** z obsługiwanym przez Ciebie SBC
  ([wymagania dotyczące SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  obsługiwany SBC z certyfikatem publicznym, TLS 1.2 na porcie 5061 i SRTP
  w kierunku Microsoft.
- **Obsługa nagłówków SIP X** w węźle **Transfer conversation**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Potwierdź, że jest dostępna w Twoim środowisku.

Dynamics 365 przekazuje połączenia wyłącznie na numer telefonu, a Microsoft uwierzytelnia
Direct Routing za pomocą certyfikatu, a nie hasła. Twój SBC znajduje się między
Microsoft a ThunderPhone i zamienia ten numer na adres SIP agenta.

## 1. Utwórz punkt końcowy SIP

Połączenie dociera do ThunderPhone z Twojego SBC, dlatego utwórz standardowy punkt
końcowy, którego SBC będzie używać:

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

Natychmiast zapisz `password` z odpowiedzi; jest wyświetlane tylko raz, a
Twój SBC odpowiada nim na żądanie uwierzytelnienia ThunderPhone. Jeśli Twój SBC nie obsługuje
uwierzytelniania digest, utwórz punkt końcowy z wartością `auth` ustawioną na
`ip_allowlist` i publicznym adresem SBC; zobacz
[Platformy uwierzytelniane według źródłowego adresu IP](/pl/guides/sip-addresses).

## 2. Przekazuj połączenia z kontekstem

1. Wybierz w SBC numer telefonu dla agenta, na przykład `+14155550188`.
2. W SBC kieruj połączenia na ten numer do `sip_uri` punktu końcowego, na
   przykład `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, przez TLS na porcie
   `5061`. ThunderPhone znajduje punkt końcowy na podstawie części użytkownika
   (`agent-12-jhxmginwjx`), która musi znajdować się zarówno w URI żądania, jak
   i w nagłówku `To`. Przekazuj nagłówki X bez zmian.
3. W Copilot Studio dodaj węzeł **Transfer conversation** z opcją
   **External phone number transfer** na ten numer, a następnie dodaj nagłówki X:
   - `X-Call-ID`: identyfikator rozmowy Dynamics 365. Żaden nagłówek Microsoft go nie zawiera,
     dlatego dodaj go tutaj; ThunderPhone zapisuje go jako
     `external_call_id` połączenia. Potwierdź w Copilot Studio, która zmienna zawiera
     identyfikator rozmowy.
   - Maksymalnie cztery kolejne, na przykład `X-Customer-Tier`.

Microsoft wysyła maksymalnie pięć nagłówków X, z nazwami o długości do 64 znaków i
wartościami o długości do 256 znaków, używając liter, cyfr oraz `= ; . ! % * _ + ~ -`.
Zapisuje prefiks małymi literami jako `x-`; ThunderPhone dopasowuje nazwy nagłówków bez
uwzględniania wielkości liter, dlatego `x-customer-tier` trafia do promptu jako
`{{sip_x_customer_tier}}`.

Jeśli zamiast tego tworzysz połączenie za pomocą Azure Communication Services Call Automation,
`AddSipX` domyślnie zapisuje nazwy `X-MS-Custom-`. Przekaż
`SipHeaderPrefix.X`, aby `X-Call-ID` zachował swoją nazwę
([kontekst niestandardowy](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Przekaż połączenie z powrotem

Agent kończy rozmowę: żegna się i rozłącza. Dodaj ten numer
przekierowania (zobacz
[Dodaj numer przekierowania](/pl/guides/contact-centers/overview)):

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

Za ponowne wprowadzenie rozmówcy do Dynamics 365 odpowiada SBC. Microsoft
dokumentuje jeden sposób przekazania połączenia z kontekstem: nowe połączenie
przez SBC na numer zarejestrowany w Dynamics 365, z UUI, którego klucze
odpowiadają zmiennym kontekstu skonfigurowanym w obszarze **Strumienie pracy → Ustawienia zaawansowane**
([przekazanie do zewnętrznego IVR](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Ustal z dostawcą SBC, jak rozmówca dociera do tego numeru, gdy ThunderPhone
się rozłącza, i przekaż identyfikator rozmowy wysłany w `X-Call-ID`,
aby przepływ mógł znaleźć połączenie.

Następnie pobierz dane przekazania za pomocą węzła **Żądanie HTTP** w Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  po którym podaj identyfikator rozmowy.
- Nagłówek `Authorization: Bearer sk_live_…`.
- Przetwórz odpowiedź i zapisz ją w zmiennej, a następnie użyj `handoff.summary` oraz
  `handoff.intent`.

Zobacz [Wyszukaj przekazane połączenie](/api-reference/calls#look-up-a-handed-off-call).

## Przetestuj

Zadzwoń na numer Dynamics 365, który prowadzi do węzła przekierowania, poproś
agenta o połączenie z człowiekiem i sprawdź, czy rozmówca wraca do Dynamics 365.
Następnie pobierz dane połączenia za pomocą `GET /v1/calls/{call_id}`: `sip_headers` powinno zawierać `x-call-id`, a
`external_call_id` powinno być identyfikatorem rozmowy. Jeśli połączenie nigdy
nie dociera do agenta, a logi SBC pokazują SIP `404`, identyfikator URI żądania
lub nagłówek `To` nie zawiera części użytkownika punktu końcowego.

## Ograniczenia

- SBC jest wymagany. Microsoft nie może wybierać adresu SIP ani odpowiadać na
  wyzwanie uwierzytelniania digest.
- Microsoft wysyła maksymalnie pięć nagłówków X i zachowuje tylko pierwszych
  pięć w połączeniu przychodzącym. Dynamics 365 przyjmuje maksymalnie 128 znaków UUI.
- Microsoft nie dokumentuje odczytywania nagłówków w komunikacie `BYE`, dlatego
  dane przekazania są zwracane wyłącznie przez wyszukiwanie.
