Konfiguruj nagłówki SIP X dla agentów obsługujących głos

Note

W tym artykule opisano funkcje używane w agentach lub przepływach agentów obsługiwanych przez standardowe środowisko uruchomieniowe.

W tym artykule wyjaśniono, jak skonfigurować nagłówki X protokołu inicjowania sesji (SIP) dla połączeń przychodzących i wychodzących w agentach Copilot Studio do użycia w Dynamics 365 Contact Center.

Nagłówki SIP X pozwalają przesyłać niestandardowe metadane między systemami telefonicznymi a agentami obsługującymi głos. Dynamics 365 Contact Center agenci obsługujący połączenia głosowe obsługują zarówno przychodzące, jak i wychodzące nagłówki X. Ta konfiguracja umożliwia płynną wymianę danych podczas przełączania połączeń i routingu.

Wymagania wstępne

  • Dynamics 365 Contact Center z włączonymi agentami obsługującymi głos

  • Dostęp do Copilot Studio z odpowiednimi uprawnieniami

  • Routing bezpośredni dla konfiguracji telefonii

  • Podstawowa wiedza na temat tworzenia tematów w Copilot Studio oraz zarządzania zmiennymi.

Ważna

Nazwy i wartości nagłówka SIP X muszą zawierać tylko obsługiwane znaki. Dowiedz się więcej o obsługiwanych znakach w temacie Przekazywanie danych kontekstowych między wywołaniami.

Konfiguruj nadchodzące nagłówki X

Przychodzące nagłówki X zawierają metadane przekazywane z zewnętrznych systemów telefonii do agenta obsługującego głos. Aby otrzymywać i używać tych danych, musisz skonfigurować węzeł Parse Value, aby wyodrębnił informacje nagłówka X ze zmiennej systemowej Conversation.SipXHeader.

Wymagania dotyczące nagłówka X-przychodzącego

  • Maksymalna liczba: pięć nagłówków X na każde połączenie przychodzące.

  • Wymóg nazewnictwa: Wszystkie nazwy nagłówków X muszą zaczynać się na .x-

    Note

    W programie Copilot Studio wszystkie przychodzące nagłówki X muszą zaczynać się od małych liter x-, nawet jeśli system zewnętrzny wysyłający nagłówek X używa górnej litery X-. Wychodzący nagłówek X zdefiniowany w programie Copilot Studio może mieć małe litery lub wielkie litery, w zależności od tego, jakiego przypadku oczekuje system zewnętrzny.

  • Długość nazwy: Do 64 znaków.

  • Długość wartości: do 256 znaków.

  • Dla wszystkich oczekiwanych nagłówków X wymagany jest schemat JSON.

  • Aktualizuj schemat JSON, gdy zmieniają się nazwy nagłówków X.

  • Zależność danych kanałowych: nagłówki X muszą być obecne w Conversation.SipXHeader.

Dodaj zarządzanie zmiennymi — węzeł do parsowania wartości

  1. Przejdź do tematu swojego agenta z funkcjami głosowymi.

  2. Dodaj nowy węzeł tematyczny.

  3. Wybierz zarządzanie zmiennymi i wybierz wartość parsowania.

    Zrzut ekranu opcji zarządzania zmiennymi, podświetlający wartość Parse.

Konfiguruj węzeł parsowania wartości

  1. W menu System ustaw pole 'Parse value' na .Conversation.SipXHeader

  2. Ustaw typ danych na Z danych próbnych.

  3. Zdefiniuj oczekiwaną strukturę nagłówka X, wybierając Pobierz schemat z przykładowego JSON.

    Zrzut ekranu węzła wartości Parse, wyświetlający wartości konfiguracyjne.

Zdefiniuj schemat JSON dla nagłówków X

W oknie dialogowym Pobierz schemat z przykładowego JSON, podaj strukturę JSON, która zawiera oczekiwane nazwy nagłówków X. Na przykład, jeśli spodziewasz się nagłówków, takich jak X-CallID i X-AAI-Incoming, w połączeniu przychodzącym, dodaj je do schematu JSON.

Zrzut ekranu przykładowego okna dialogowego schematu JSON.

Wybierz Potwierdź, aby zastosować schemat.

Ważna

Platforma Dynamics 365 Contact Center zawsze normalizuje nazwy nagłówków X, stosując małe litery jako prefiks x-, niezależnie od sposobu, w jaki są one przesyłane przez system zewnętrzny. Oznacza to, że:

  • Jeśli zewnętrzny system wysyła X-CallID, musisz zdefiniować go jako x-CallID w swoim schemacie.

  • Jeśli zewnętrzny system wysyła X-AAI-Incoming, musisz zdefiniować go jako x-AAI-Incoming w swoim schemacie.

Nawet jeśli system zewnętrzny może używać wielkich liter X-, schemat musi zawsze używać małych liter, x- aby platforma mogła poprawnie mapować i przetwarzać nagłówki.

Przykładowy JSON dla nagłówków X

{

"x-CallID": "",

"x-AAI-Incoming": ""  
}

Zapisz dane parsowane

  1. Utwórz lub wybierz zmienną w polu Zapisz jako (na przykład IncomingSipXHeader).

    Zrzut ekranu konfiguracji właściwości zmiennej do użycia z X-headerem SIP.

  2. Ustaw zakres zmiennej na Globalny , aby umożliwić dostęp do wielu tematów w Twoim agencie.

Uzyskaj dostęp do wartości nagłówka X w swoich tematach

Po skonfigurowaniu możesz uzyskać dostęp do poszczególnych wartości nagłówka X za pomocą notacji kropkowej, podobnie jak w poniższych przykładach:

  • Global.IncomingSipXHeader.'x-AAI-Incoming'

  • IncomingSIPXHeaders.sipXHeader.'X-CallID'

Zachowanie środowiska uruchomieniowego

  • Copilot Studio odbiera tylko pierwsze pięć nagłówków typu X wysyłanych przez system zewnętrzny.

  • Copilot Studio automatycznie wypełnia rekord wartościami nagłówka X, gdy nazwy są zgodne ze schematem.

  • Brakujące nagłówki X mają puste wartości ciągów znaków.

  • Aktualizacje schematu są wymagane, gdy zmieniają się nazwy nagłówków X lub jeśli chcesz otrzymać dodatkowe nagłówki.

Skonfiguruj nagłówki X dla wiadomości wychodzących

Możesz przekazywać niestandardowe dane podczas przekazywania połączeń na zewnętrzne numery telefoniczne za pomocą wychodzących nagłówków X. Skonfiguruj te nagłówki w węźle Konwersacja przeniesienia.

Wymagania dotyczące nagłówka X-wychodzącego

  • Maksymalna liczba: pięć nagłówków X na transfer.

  • Wymóg nazewnictwa: Wszystkie nazwy nagłówków X mogą zaczynać się od X- lub x-, w zależności od przypadku, jakiego system zewnętrzny oczekuje.

    Note

    W programie Copilot Studio wszystkie przychodzące nagłówki X muszą zaczynać się od małych liter x-, nawet jeśli system zewnętrzny wysyłający nagłówek X używa górnej litery X-. Wychodzący nagłówek X zdefiniowany w programie Copilot Studio może mieć małe litery lub wielkie litery, w zależności od tego, jakiego przypadku oczekuje system zewnętrzny.

  • Długość nazwy: Do 64 znaków.

  • Długość wartości: do 256 znaków.

  • Typ transferu: Dostępny tylko dla zewnętrznego transferu numeru telefonu.

Skonfiguruj węzeł rozmowy transferowej

  1. Dodaj węzeł Konwersacja przeniesienia do przepływu swojego tematu.

  2. W obszarze Typ transferu wybierz opcję Przenoszenie rozmów na zewnętrzny numer telefonu i wprowadź numer transferu. Na przykład +18005551212.

Konfiguruj nagłówki X we właściwościach węzła Przeniesienie

  1. Wybierz ikonę menu Więcej (…) węzła, a następnie wybierz opcję Właściwości.

  2. Wybierz + Dodaj, aby dodać pary klucz-wartość nagłówka X.

    Zrzut ekranu węzła Transfer conversation.

  3. Zdefiniuj wpisy nagłówka X. Nazwy nagłówków X wychodzących są wysyłane dokładnie tak, jak zdefiniujesz je w węźle Konwersacja przeniesienia. Wybierz właściwy przypadek w oparciu o oczekiwania systemu odbiorczego.

    • Nazwa klucza: Musi zaczynać się od X- lub ( x- na przykład X-AAI-Outgoing lub X-CallID)
    • Wartość: Wprowadź wartość statyczną lub przypisz zmienną

    Zrzut ekranu właściwości rozmowy transferowej.

Najlepsze rozwiązania

Postępuj zgodnie z tymi wytycznymi dotyczącymi projektowania schematu, zarządzania zmiennymi, obsługi błędów i wydajności podczas pracy z nagłówkami X SIP w agentach obsługujących głos. Dowiedz się więcej w temacie Narzędzia, wiedza, MCP i API.

Projekt schematu

  • Używaj opisowych nazw nagłówków X, które jasno wskazują ich cel.

  • Aktualizuj schemat JSON, gdy zmieniają się wymagania nagłówka X.

  • Udokumentuj schemat X-header do celów zespołowych i do rozwiązywania problemów.

Zarządzanie zmiennymi

  • Używaj zmiennych globalnych dla danych nagłówka X, które muszą być dostępne w wielu tematach.

  • Wybierz znaczące nazwy zmiennych (na przykład IncomingSIPXHeaders lub CustomerXHeaders).

  • Inicjalizuj zmienne już na początku przebiegu rozmowy.

Obsługa błędów

  • Zawsze sprawdź obecność nagłówka X, zanim użyjesz wartości w logice.

  • Wprowadź zachowanie zapasowe dla brakujących lub nieprawidłowych danych nagłówka X.

  • Dokładnie przetestuj różne scenariusze nagłówka X.

Zagadnienia dotyczące wydajności

  • Analizuj nagłówki X na początku toku rozmowy.

  • Cache często używał wartości w osobnych zmiennych, jeśli było to potrzebne.

  • Unikaj wielokrotnego parsowania tych samych danych kanału.

Typowe problemy z otrzymywanymi nagłówkami X

Jeśli przychodzące nagłówki X nie działają zgodnie z oczekiwaniami, zapoznaj się z typowymi problemami i krokami rozwiązywania problemów.

Nie otrzymano wartości nagłówka X

  • Sprawdź, czy schemat JSON dokładnie odpowiada oczekiwanym nagłówkom X.

  • Sprawdź, czy węzeł Parse Value jest skonfigurowany z Conversation.SipXHeader.

  • Upewnij się, że zmienna jest ustawiona na zakres globalny, jeśli uzyskujesz do niej dostęp z wielu tematów.

  • Upewnij się, że nie więcej niż pięć nagłówków X jest oczekiwanych, a nagłówki X to pięć najlepszych nagłówków X wysyłanych przez system zewnętrzny.

Puste lub null wartości nagłówka X

  • Zweryfikuj, czy system zewnętrzny wysyła "nagłówki X" z oczekiwanymi nazwami.

  • Sprawdź, czy schemat JSON zawiera wszystkie wymagane nazwy nagłówków X z małym prefiksem x- .

Typowe problemy z wychodzącymi nagłówkami X

Jeśli wychodzące nagłówki X nie działają zgodnie z oczekiwaniami, zapoznaj się z typowymi problemami i krokami rozwiązywania problemów.

Nagłówki X nie są wysyłane podczas transferu

  • Sprawdź, czy wszystkie nazwy nagłówków X zaczynają się od X- lub x-.

  • Upewnij się, że typ transferu jest ustawiony na Zewnętrzny transfer numeru telefonu.

  • Upewnij się, że wartości nagłówka X są prawidłowo przypisane przed węzłem Konwersacja przeniesienia.

Niepowodzenie transferu w przypadku nagłówków X

  • Potwierdź, że nazwy i wartości nagłówków X nie przekraczają limitów długości.

  • Sprawdź, czy system odbiorczy jest w stanie obsłużyć wysyłane nagłówki X.

  • Sprawdź specjalne znaki, które mogą powodować problemy z parsowaniem.

Zarządzanie schematami

Dbaj o to, aby schemat nagłówka X był uporządkowany i zawsze aktualny w miarę zmieniających się wymagań.

Aktualizacja schematu nagłówka X

  • Last updated on