Udostępnij za pośrednictwem

Wysyłanie proaktywnych wiadomości aplikacji Microsoft Teams

Po opublikowaniu swojego agenta i udostępnieniu go użytkownikom końcowym w Microsoft Teams, możesz powiadomić użytkowników („odbiorców”) w Microsoft Teams za pomocą proaktywnych wiadomości. Wiadomości proaktywne wykorzystują przepływy Power Automate do dostarczenia swojej treści i są przydatne w wielu scenariuszach, w tym:

  • Poinformowanie odbiorcy, że wcześniejsza prośba została zakończona. Na przykład, wniosek użytkownika o czas wolny został zatwierdzony.
  • Udostępnianie przypomnień i aktualizacji wiadomości. Na przykład, agent może wysłać wiadomość z przypomnieniem o ukończeniu szkolenia online.

Ważne

Proaktywne wiadomości można skonfigurować dla agentów i klasycznych czatbotów tworzonych i dostosowywanych w Copilot Studio.

Agent nie może dostarczać wiadomości, jeśli adresat:

  • Nie ma zainstalowanego agenta w Microsoft Teams.
  • Odinstalował agent.
  • Zablokował agent.
  • Nie ma uprawnień do czatowania z agentem, w takim przypadku musisz udostępnić agenta innym użytkownikom.

Wymagania wstępne

Znane ograniczenia

  • Jeśli agent jest odłączony i ponownie połączony z Microsoft Teams, użytkownicy nie będą otrzymywać aktywnych wiadomości, dopóki ponownie nie zainstalują agenta.
  • Wszystkie aktywne wiadomości Copilot Studio mogą podlegać ograniczeniom Power Automate dla łącznika i ograniczeniom łącznika Microsoft Teams.
  • Proaktywne wiadomości nie będą rejestrowane w transkrypcjach rozmów lub sesjach analityki.
  • Komunikaty proaktywne muszą znajdować się w tym samym środowisku, co przepływ Power Automate.
  • Wiadomości proaktywne mogą być wysyłane tylko na osobisty czat z agentem.

Wyślij proaktywną wiadomość

  1. W Power Automate otwórz przepływ, który chcesz wysłać w sposób aktywny.

  2. Dodaj łącznik Microsoft Teams i wybierz działanie Opublikuj wiadomość w czacie lub na kanale.

  3. Dla opcji Opublikuj jako wybierz pozycję Power Virtual Agents (podgląd).

  4. Dla opcji Opublikuj wybierz opcję Porozmawiaj z wideo.

  5. W polu Bot wybierz agent, z którego ma zostać wysłana wiadomość.

  6. W polu Odbiorca wprowadź nazwisko lub adres e-mail adresata. Możesz również użyć dynamicznej zawartości, jeśli informacje o odbiorcy pochodzą z wcześniejszego kroku w przepływie.

  7. W przypadku Wiadomość wpisz wiadomość, którą chcesz wysłać.

    Akcja Opublikuj wiadomość w Power Automate.

Kiedy przepływ jest uruchomiony, odbiorca otrzyma proaktywną wiadomość od agenta w Microsoft Teams.

Wysyłanie aktywnej karty adaptacyjnej

Ważne

W tej sekcji szczegółowo opisano sposób wysyłania aktywnych kart adaptacyjnych z przepływami Power Automate. Aktywne karty adaptacyjne umożliwiają użytkownikom odbieranie informacji z nieaktywnej rozmowy z agentem. Aby dowiedzieć się, jak wysyłać Karty adaptacyjne w aktywnej rozmowie , zobacz Wyświetlanie karty adaptacyjnej w Copilot Studio.

Oprócz wysyłania wiadomości aktywnych można także wysyłać aktywne karty adaptacyjne.

Zrzut ekranu karty adaptacyjnej.

Karty adaptacyjne to format wymiany kart otwartych, umożliwiający deweloperom spójną i spójną wymianę zawartości interfejsu użytkownika. Można ręcznie autorować karty adaptacyjne w JSON lub, jeśli wolisz interfejs przeciągania i upuszczania, możesz użyć Projektanta kart adaptacyjnych.

Uwaga

Power Automate nie obsługuje kart adaptacyjnych, które korzystają z funkcji szablonów.

W tym przykładzie do użytkownika zostanie przesłana karta podsumowania zamówienia, która będzie do przejrzenia.

  1. W Power Automate dodaj akcję łacznika Microsoft Teams Wysyłanie karty adaptacyjnej na czacie lub kanale w kroku, w którym chcesz wysłać kartę w swoim przepływie:

  2. Dla opcji Opublikuj jako wybierz pozycję Power Virtual Agents (podgląd).

  3. Dla opcji Opublikuj wybierz opcję Porozmawiaj z wideo.

  4. W polu Bot wybierz agent, z którego ma zostać wysłana wiadomość.

  5. W polu Odbiorca wprowadź nazwisko lub adres e-mail adresata. Możesz również użyć dynamicznej zawartości, jeśli informacje o odbiorcy pochodzą z wcześniejszego kroku w przepływie.

  6. Dla karty adaptacyjnej wprowadź następujący szablon JSON:

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.5",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order summary",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ]
}

    Publikowanie kart adaptacyjnych w Power Automate.

Kiedy przepływ jest uruchomiony, odbiorca otrzyma kartę adaptacyjną od agenta w Microsoft Teams.

Poczekaj na odpowiedź użytkownika

Ważne

W tej sekcji szczegółowo opisano sposób wysyłania aktywnych kart adaptacyjnych z przepływami Power Automate. Aktywne karty adaptacyjne umożliwiają użytkownikom odbieranie informacji z nieaktywnej rozmowy z agentem. Aby dowiedzieć się, jak wysyłać Karty adaptacyjne w aktywnej rozmowie , zobacz Wyświetlanie karty adaptacyjnej w Copilot Studio.

Karty adaptacyjne obsługują pobieranie danych wejściowych użytkowników. W tych scenariuszach trzeba poczekać na odpowiedź użytkownika, zanim będzie kontynuowany przepływ.

Zrzut ekranu karty adaptacyjnej zawierającej akcje użytkownika.

Uwaga

Power Automate nie obsługuje kart adaptacyjnych, które korzystają z funkcji szablonów.

W tym przykładzie należy wysłać do użytkownika kartę potwierdzenia zamówienia, która umożliwi użytkownikowi dokonać zmian przed wysłaniem zamówienia.

  1. W Power Automate dodaj akcję łacznika Microsoft Teams Opublikuj kartę adaptacyjną i czekaj na odpowiedź w kroku, w którym chcesz wysłać kartę w swoim przepływie:

  2. Dla opcji Opublikuj jako wybierz pozycję Power Virtual Agents (podgląd).

  3. Dla opcji Opublikuj wybierz opcję Porozmawiaj z wideo.

  4. Dla Wiadomości wprowadź następujący szablon JSON:

    Właściwości sekcji actions określają opcje prezentowane użytkownikowi.

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order confirmation",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ],
    "actions": [
        {
            "type": "Action.Submit",
            "title": "Submit Order"
        },
        {
            "type": "Action.Submit",
            "title": "Edit Order"
        }
    ]
}

  5. W przypadku Komunikat o aktualizacji wpisz wiadomość o aktualizacji, którą zobaczy odbiorca po udzieleniu odpowiedzi.

  6. W polu Odbiorca wprowadź nazwisko lub adres e-mail adresata. Możesz również użyć dynamicznej zawartości, jeśli informacje o odbiorcy pochodzą z wcześniejszego kroku w przepływie.

  7. W polu Bot wybierz agent, z którego ma zostać wysłana karta.

    Opublikuj kartę adaptacyjną i zaczekaj na odpowiedź – działanie w Power Automate.

Kiedy przepływ jest uruchomiony, odbiorca otrzyma kartę adaptacyjną od agenta w Microsoft Teams, na którą może odpowiedzieć.

Aby użyć odpowiedzi od odbiorcy, wybierz submitActionId z menu wysuwanego treści dynamicznej. Wartość tej zmiennej będzie akcją title wybraną przez użytkownika.

Wysyłanie aktywnych wiadomości do wielu adresatów

W niektórych scenariuszach możesz chcieć wysłać tę samą proaktywną wiadomość do wielu odbiorców.

Ta sekcja zawiera przykłady wysyłania wiadomości do wielu odbiorców.

Ważne

Wymagania wstępne opisane w tym temacie dotyczą każdego adresata.

Można na przykład wysłać tę samą wiadomość do 10 odbiorców w ramach jednej akcji. Jeśli trzech z 10 odbiorców nie ma zainstalowanego agenta, to ci trzej odbiorcy nie otrzymają wiadomości.

Wyślij do kolegów z zespołu

W tym przykładzie agent wyśle przypomnienie do członków zespołu, aby ukończyli swoje szkolenie online.

  1. Dodaj łącznik Microsoft Teams i wybierz akcję Pobierz zespół w przepływie Power Automate.

  2. W przypadku Team wybierz zespół składający się z członków, do których chcesz wysłać wiadomość.

  3. Dodaj łącznik Office 365 Groups i wybierz akcję Lista członków grupy.

  4. W Identyfikator grupy wybierz opcję Wartość niestandardowa.

  5. Wybierz Identyfikator zespołu z dynamicznej zawartości akcji Pozyskaj zespół.

  6. Dodaj łącznik Microsoft Teams i wybierz działanie Opublikuj wiadomość w czacie lub na kanale.

  7. Dla opcji Opublikuj jako wybierz pozycję Power Virtual Agents (podgląd).

  8. Dla opcji Opublikuj wybierz opcję Porozmawiaj z wideo.

  9. W polu Bot wybierz agenta, do którego chcesz wysłać wiadomość.

  10. W Odbiorca wybierz zawartość dynamiczną Nazwa zasady użytkownika z akcji Lista członków grupy.

    Wyślij do kolegów z zespołu – przykład.

  11. W przypadku Wiadomość wpisz wiadomość, którą chcesz wysłać.

Kiedy przepływ zostanie uruchomiony, każdy użytkownik w zespole otrzyma proaktywną wiadomość w prywatnym czacie z agentem.

Wyślij do grupy zabezpieczeń

W tym przykładzie agent wyśle przypomnienie do grupy zabezpieczeń, aby ukończyli swoje szkolenie online.

  1. Dodaj łącznik Tożsamość Microsoft Entra i wybierz akcję Pobierz członków grupy w przepływie Power Automate.

  2. W przypadku identyfikatora grupy wprowadź identyfikator GUID grupy zabezpieczeń.

  3. Dodaj łącznik Microsoft Teams i wybierz działanie Opublikuj wiadomość w czacie lub na kanale.

  4. Dla opcji Opublikuj jako wybierz pozycję Power Virtual Agents (podgląd).

  5. Dla opcji Opublikuj wybierz opcję Porozmawiaj z wideo.

  6. W polu Bot wybierz agenta, do którego chcesz wysłać wiadomość.

  7. W Odbiorca wybierz zawartość dynamiczną Nazwa zasady członków grupy z akcji Pobierz członków grupy.

  8. W przypadku Wiadomość wpisz wiadomość, którą chcesz wysłać.

    Opcja Wyślij do grupy zabezpieczeń.

Kiedy przepływ zostanie uruchomiony, każdy użytkownik w grupie otrzyma proaktywną wiadomość w prywatnym czacie z agentem.

Wysyłaj proaktywną wiadomość do wielu odbiorców równolegle

Zwykle, gdy wysyłasz proaktywną wiadomość do wielu odbiorców, Twój agent wysyła jedną wiadomość po drugiej. W niektórych sytuacjach lepiej jest jednak wysłać wiadomość do wielu adresatów jednocześnie.

Ostrzeżenie

Wszystkie aktywne wiadomości Copilot Studio mogą podlegać ograniczeniom Power Automate dla łącznika i ograniczeniom łącznika Microsoft Teams.

Jeśli wysyłasz wiadomości do dużej grupy adresatów, po przekroczeniu limitu danych zobaczysz błędy. Można zmniejszyć poziom równoległości lub zmniejszyć liczbę adresatów w grupie.

  1. W poszczególnych akcjach wybierz trzy poziome kropki (. . .), a następnie pozycję Ustawienia.

    Ustawienia w menu Więcej opcji.

  2. Włącz kontrolkę współbieżność i ustaw poziom równoległości.

    Kontrolka suwaka dla ustawiania poziomu lub współbieżności.

Konfigurowanie opcji zaawansowanych dla wiadomości aktywnych

Copilot Studio pozwala na kontrolowanie zachowania szczegółów agenta pod menu Pokaż opcje zaawansowane w łączniku Microsoft Teams.

Rozwinięte okienko opcji w łączniku.

Etykieta wysłanej wiadomości jako powiadomienia

Etykieta jako powiadomienie określa, czy wiadomość będzie miała tekst „Powiadomienie przez” przed nazwą agenta. Etykietowanie odpowiedzi agenta pozwala odbiorcy zidentyfikować odpowiedź agenta na jego zapytanie.

Ustawienie pokazuje Powiadamianie poprzez nazwę agenta.

Gdy odbiorca jest w trakcie aktywnego czatu z agentem

Czasami agent może wysyłać proaktywną wiadomość lub kartę, gdy odbiorca jest w aktywnej konwersacji z agentem.

Możesz chcieć odłożyć wysłanie proaktywnej wiadomości aż do zakończenia rozmowy, aby nie zakłócać przepływu rozmowy.

Pole Jeśli rozmowa jest aktywna, umożliwia kontrolowanie zachowania:

  • Wyślij: agent będzie wysyłał proaktywną wiadomość w normalny sposób.

  • Nie wysyłaj i oznacz jako powodzenie: agent nie wyśle proaktywnej wiadomości, gdy odbiorca jest w trakcie aktywnej rozmowy. Zwrócony zostanie kod stanu 300.

  • Nie wysyłaj i oznacz jako niepowodzenie: agent nie wyśle proaktywnej wiadomości, gdy odbiorca jest w trakcie aktywnej rozmowy. Przebieg przepływu zostanie oznaczony jako niepowodzenie.

Gdy odbiorca nie ma zainstalowanego agenta

Agent może dostarczać wiadomości lub karty tylko do odbiorców, którzy zainstalowali agent w Microsoft Teams. Odbiorcy mogą nie chcieć instalować agenta lub mogą go odinstalować.

W przypadku wiadomości lub kart o mniejszym znaczeniu można ustawić, aby przepływ był oznaczany jako udany, nawet jeśli odbiorca nie ma zainstalowanego agenta.

Pole Jeśli bot nie jest zainstalowany, umożliwia kontrolowanie zachowania:

  • Niepowodzenie: uruchamianie przepływu będzie oznaczane jako niepowodzenie, jeśli odbiorca nie zainstalował agenta w Microsoft Teams.

  • Pomyślnie z kodem stanu: przepływ zostanie oznaczony jako zakończony sukcesem, nawet jeśli odbiorca nie może otrzymać wiadomości lub kartki, ponieważ nie zainstalował agenta. Zwrócony zostanie kod stanu 100.

Definicja: Kod stanu

Możesz użyć zwróconego kodu statusu do zdefiniowania różnych zachowań następczych w Twoim przepływie. Na przykład, można określić, że przepływ powinien próbować ponownie przez pewien okres czasu lub rejestrować zapis o niepowodzeniu.

Kod stanu Udało się (wartość logiczna) Podpis
200 Prawda Wiadomość dostarczona pomyślnie.
100 Fałsz Wiadomość nie mogła zostać dostarczona, ponieważ odbiorca nie ma zainstalowanego agenta.
300 Fałsz Wiadomość nie mogła zostać dostarczona, ponieważ odbiorca jest w trakcie aktywnej rozmowy z agentem.