ThunderPhone v3 już działa.Uruchom samodzielnie, od 2¢/min.Przeczytaj komunikat

Contact centers

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

  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).

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.summary oraz handoff.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.