Open in
Połącz z Microsoft Dynamics 365
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.
- 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): 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). 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ć:
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.
2. Przekazuj połączenia z kontekstem
- Wybierz w SBC numer telefonu dla agenta, na przykład
+14155550188. - W SBC kieruj połączenia na ten numer do
sip_uripunktu końcowego, na przykładsip:agent-12-jhxmginwjx@sip.thunderphone.com, przez TLS na porcie5061. 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łówkuTo. Przekazuj nagłówki X bez zmian. - 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 jakoexternal_call_idpołą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).
3. Przekaż połączenie z powrotem
Agent kończy rozmowę: żegna się i rozłącza. Dodaj ten numer przekierowania (zobacz Dodaj numer przekierowania):
{"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).
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.summaryorazhandoff.intent.
Zobacz Wyszukaj przekazane połączenie.
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.