Freigeben über

Proaktive Microsoft Teams-Nachrichten senden

Nachdem Sie Ihren Agenten veröffentlicht und den Agenten Benutzenden in Microsoft Teams zur Verfügung gestellt haben, können Sie Benutzende („Empfänger“) in Microsoft Teams mit proaktiven Nachrichten benachrichtigen. Proaktive Nachrichten verwenden Power Automate-Flows, um ihre Inhalte bereitzustellen, und sind in vielen Szenarien nützlich, darunter:

  • Einen Empfänger darüber informieren, dass seine frühere Anfrage abgeschlossen wurde. Beispielsweise wurde der Urlaubsantrag des Benutzers genehmigt.
  • Bereitstellung von Erinnerungen oder Nachrichten-Updates. Der Agent könnte beispielsweise eine Erinnerungsnachricht wegen des Abschlusses des Onlinetrainings senden.

Wichtig

Für Agenten und klassische Chatbots, die in Copilot Studio erstellt und angepasst werden, können proaktive Nachrichten konfiguriert werden.

Ein Agent kann keine Nachrichten zustellen, wenn der Empfänger:

  • Den Agenten nicht in Microsoft Teams installiert hat.
  • Den Agenten deinstalliert hat.
  • Den Agenten gesperrt hat.
  • Der Empfänger hat keine Berechtigung, mit dem Agenten zu chatten. In diesem Fall müssen Sie den Agenten an andere Benutzende freigeben.

Anforderungen

Bekannte Einschränkungen

  • Wenn die Verbindung des Agenten zu Microsoft Teams getrennt und wiederhergestellt wird, erhalten Benutzende erst nach der Neuinstallation des Agenten proaktive Nachrichten.
  • Alle proaktiven Nachrichten aus Copilot Studio sind Grenzen auf Power Automate und Drosselungsgrenzen des Microsoft Teams-Connectors unterworfen.
  • Proaktive Nachrichten und Karten werden nicht in Gesprächsprotokollen oder Analytics-Sitzungen protokolliert.
  • Proaktive Nachrichten müssen sich in der gleichen Umgebung befinden wie der Power Automate-Flow.
  • Proaktive Nachrichten können nur in einem persönlichen Chat mit dem Agenten gepostet werden.

Proaktive Nachricht senden

  1. In Power Automate öffnen Sie den Flow, dem Sie eine proaktive Nachricht senden möchten.

  2. Fügen Sie die Microsoft Teams-Konnektoraktion Nachricht in einem Chat oder Kanal veröffentlichen hinzu.

  3. Für Veröffentlichen als wählen Sie Power Virtual Agents (Vorschauversion).

  4. Für Veröffentlichen in wählen Sie Chat mit Bot.

  5. Wählen Sie als Bot den Agenten aus, von dem die Nachricht gesendet werden soll.

  6. Geben Sie für Empfänger den Namen oder die E-Mail-Adresse des Empfängers ein. Sie können auch dynamische Inhalte verwenden, wenn die Empfängerinformationen aus einem früheren Schritt im Flow stammen.

  7. Geben Sie für Nachricht die Nachricht ein, die Sie senden möchten.

    Nachrichtenaktion posten in Power Automate.

Wenn der Flow ausgeführt wird, erhält der Empfänger die proaktive Nachricht vom Agenten in Microsoft Teams.

Senden Sie eine proaktive adaptive Karte

Wichtig

In diesem Abschnitt wird beschrieben, wie Sie proaktive adaptive Karten mit Power Automate-Flows senden. Proaktive adaptive Karten ermöglichen es Benutzenden, Informationen aus einer inaktiven Unterhaltung mit einem Agenten zu erhalten. Informationen zum Senden adaptiver Karten in einer aktiven Unterhaltung finden Sie unter Adaptive Karte in Copilot Studio anzeigen.

Zusätzlich zum Senden proaktiver Nachrichten können Sie auch proaktive adaptive Karten senden.

Screenshot einer adaptive Karte.

Adaptive Karten sind ein offenes Kartenaustauschformat, das es Entwicklern ermöglicht, UI-Inhalte auf gemeinsame und konsistente Weise auszutauschen. Sie können adaptive Karten manuell in JSON erstellen, oder wenn Sie eine Drag-and-Drop-Oberfläche bevorzugen, können Sie den Designer für adaptive Karten verwenden.

Notiz

Power Automate unterstützt keine adaptiven Karten, die die Vorlagenerstellungsfunktion verwenden.

In diesem Beispiel senden Sie dem Benutzer eine Bestellübersichtskarte zur Überprüfung.

  1. Ergänzen Sie in Power Automate die Microsoft Teams-Connectoraktion Adaptive Karte in einem Chat oder Kanal posten in dem Schritt, in dem Sie eine Karte in Ihrem Flow senden möchten.

  2. Für Veröffentlichen als wählen Sie Power Virtual Agents (Vorschauversion).

  3. Für Veröffentlichen in wählen Sie Chat mit Bot.

  4. Wählen Sie als Bot den Agenten aus, von dem die Nachricht gesendet werden soll.

  5. Geben Sie für Empfänger den Namen oder die E-Mail-Adresse des Empfängers ein. Sie können auch dynamische Inhalte verwenden, wenn die Empfängerinformationen aus einem früheren Schritt im Flow stammen.

  6. Geben Sie für Adaptive Karte die folgende JSON-Vorlage ein:

    {
    "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"
        }
    ]
}

    Adaptive Kartenaktion in Power Automate posten.

Wenn der Flow ausgeführt wird, erhält der Empfänger die adaptive Karte vom Agenten in Microsoft Teams.

Warten Sie auf die Antwort des Benutzers

Wichtig

In diesem Abschnitt wird beschrieben, wie Sie proaktive adaptive Karten mit Power Automate-Flows senden. Proaktive adaptive Karten ermöglichen es Benutzenden, Informationen aus einer inaktiven Unterhaltung mit einem Agenten zu erhalten. Informationen zum Senden adaptiver Karten in einer aktiven Unterhaltung finden Sie unter Adaptive Karte in Copilot Studio anzeigen.

Adaptive Karten unterstützen das Sammeln von Benutzereingaben. In diesen Szenarien sollten Sie auf die Antwort des Benutzers warten, bevor der Flow fortgesetzt wird.

Screenshot einer adaptiven Karte, die Aktionen für den Benutzer enthält.

Notiz

Power Automate unterstützt keine adaptiven Karten, die die Vorlagenerstellungsfunktion verwenden.

In diesem Beispiel senden Sie eine Bestellbestätigungskarte, die es dem Benutzer ermöglicht, Änderungen vorzunehmen, bevor die Bestellung übermittelt wird.

  1. Ergänzen Sie in Power Automate die Microsoft Teams-Connectoraktion Adaptive Karte posten und auf eine Antwort warten in dem Schritt, in dem Sie eine Karte in Ihrem Flow senden möchten.

  2. Für Veröffentlichen als wählen Sie Power Virtual Agents (Vorschauversion).

  3. Für Veröffentlichen in wählen Sie Chat mit Bot.

  4. Geben Sie für Nachricht die folgende JSON-Vorlage ein:

    Die Eigenschaften im Abschnitt actions bestimmen die Optionen, die dem Benutzer angezeigt werden.

    {
    "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. Geben Sie für Aktualisierungsnachricht die Aktualisierungsnachricht ein, die der Empfänger nach der Antwort sehen wird.

  6. Geben Sie für Empfänger den Namen oder die E-Mail-Adresse des Empfängers ein. Sie können auch dynamische Inhalte verwenden, wenn die Empfängerinformationen aus einem früheren Schritt im Flow stammen.

  7. Wählen Sie als Bot den Agenten aus, von dem die Karte gesendet werden soll.

    Adaptive Karte veröffentlichen und auf eine Antwortaktion in Power Automate warten

Wenn der Flow ausgeführt wird, erhält der Empfänger die adaptive Karte vom Agenten in Microsoft Teams, auf die er dann antworten kann.

Um die Antwort des Empfängers zu verwenden, wählen Sie submitActionId aus dem Flyout-Menü für dynamische Inhalte aus. Der Wert dieser Variable ist der title der Aktion, die der Benutzer gewählt hat.

Senden Sie proaktive Nachrichten an mehrere Empfänger

In einigen Szenarien möchten Sie möglicherweise dieselbe proaktive Nachricht oder Karte gleichzeitig an mehrere Empfänger senden.

Dieser Abschnitt enthält Beispiele für das Senden von Nachrichten an mehrere Empfänger.

Wichtig

Die in diesem Thema beschriebenen Voraussetzungen gelten für jeden Empfänger.

Beispielsweise können Sie mit einer Aktion dieselbe Nachricht an 10 Empfänger senden. Wenn drei der zehn Empfänger den Agenten nicht installiert haben, erhalten diese drei Empfänger die Nachricht nicht.

An Teamkollegen senden

In diesem Beispiel sendet der Agent eine Erinnerung an die Mitglieder eines Teams wegen des Abschlusses ihres Onlinetrainings.

  1. Ergänzen Sie den Microsoft Teams-Connector und wählen Sie die Aktion Holen Sie sich ein Team in Ihrem Power Automate-Flow.

  2. Wählen Sie für Team das Team mit den Mitgliedern aus, an die Sie die Nachricht senden möchten.

  3. Ergänzen Sie den Connector Office 365-Gruppen und wählen Sie die Aktion Gruppenmitglieder auflisten aus.

  4. Wählen Sie für Gruppen-ID die Option Benutzerdefinierter Wert aus.

  5. Wählen Sie Team-ID aus dem dynamischen Inhalt der Aktion Holen Sie sich ein Team.

  6. Fügen Sie den Connector Microsoft Teams hinzu und wählen Sie die Aktion Nachricht in einem Chat oder Kanal posten.

  7. Für Veröffentlichen als wählen Sie Power Virtual Agents (Vorschauversion).

  8. Für Veröffentlichen in wählen Sie Chat mit Bot.

  9. Wählen Sie als Bot den Agenten aus, von dem die Nachricht gesendet werden soll.

  10. Wählen Sie für Empfänger den dynamischen Inhalt Benutzerprinzipalname aus der Aktion Gruppenmitglieder auflisten aus.

    An Teamkollegenbeispiel senden.

  11. Geben Sie für Nachricht die Nachricht ein, die Sie senden möchten.

Wenn der Flow ausgeführt wird, erhält jeder Benutzende im Team die proaktive Nachricht zu einem privaten Chat mit dem Agenten.

An Sicherheitsgruppe senden

In diesem Beispiel sendet der Agent eine Erinnerung an die Sicherheitsgruppe wegen des Abschlusses ihres Onlinetrainings.

  1. Ergänzen Sie den Microsoft Entra ID-Konnektor und wählen Sie dann die Aktion Holen Sie sich Gruppenmitglieder in Ihrem Power Automate-Flow aus.

  2. Geben Sie für Gruppen-ID die GUID der Sicherheitsgruppe ein.

  3. Fügen Sie den Connector Microsoft Teams hinzu und wählen Sie die Aktion Nachricht in einem Chat oder Kanal posten.

  4. Für Veröffentlichen als wählen Sie Power Virtual Agents (Vorschauversion).

  5. Für Veröffentlichen in wählen Sie Chat mit Bot.

  6. Wählen Sie als Bot den Agenten aus, von dem die Nachricht gesendet werden soll.

  7. Wählen Sie für Empfänger den dynamischen Inhalt Benutzerprinzipalname für Gruppenmitglieder aus der Aktion Gruppenmitglieder abrufen aus.

  8. Geben Sie für Nachricht die Nachricht ein, die Sie senden möchten.

    An Sicherheitsgruppenoption senden.

Wenn der Flow ausgeführt wird, erhält jeder Benutzende in der Sicherheitsgruppe die proaktive Nachricht in einem privaten Chat mit dem Agenten.

Senden Sie proaktive Nachrichten an mehrere Empfänger parallel

Wenn Sie eine proaktive Nachricht an mehrere Empfänger senden, sendet Ihr Agent normalerweise eine Nachricht nach der anderen. In manchen Situationen kann es jedoch vorzuziehen sein, die Nachricht gleichzeitig an mehrere Empfänger zu senden.

Warnung

Alle proaktiven Nachrichten aus Copilot Studio sind Grenzen auf Power Automate und Drosselungsgrenzen des Microsoft Teams-Connectors unterworfen.

Wenn Sie Nachrichten an eine große Empfängergruppe senden, werden Fehler angezeigt, wenn Sie das Drosselungslimit erreichen. Sie können den Grad der Parallelität verringern oder die Anzahl der Empfänger in der Gruppe reduzieren.

  1. Wählen Sie in der Aktion Auf alle anwenden die drei horizontalen Punkte (. . .) und dann Einstellungen aus.

    Einstellungen im Menü „Weitere Optionen“.

  2. Aktivieren Sie Parallelitätskontrolle und stellen Sie den Grad der Parallelität ein.

    Schieberegler zum Einstellen des Pegels oder der Parallelität.

Konfigurieren Sie erweiterte Optionen für proaktive Nachrichten

Copilot Studio ermöglicht Ihnen die Steuerung des detaillierten Verhaltens Ihres Agenten unter Erweiterte Optionen anzeigen in dem Microsoft Teams-Connector.

Erweiterter Optionsbereich im Connector.

Gesendete Nachricht als Benachrichtigung kennzeichnen

Als Benachrichtigung kennzeichnen steuert, ob die Nachricht oder Karte den Text „Benachrichtigung über“ vor dem Namen des Agenten enthält. Das Kennzeichnen der Antwort des Agenten ermöglicht es dem Empfänger, die Antwort des Agenten auf seine Anfrage zu identifizieren.

Die Einstellung zeigt Benachrichtigung über Agentenname.

Wenn sich der Empfänger gerade in einem aktiven Chat mit dem Agenten befindet

Manchmal sendet der Agent eine proaktive Nachricht oder Karte, wenn sich der Empfänger in einer aktiven Unterhaltung mit dem Agenten befindet.

Möglicherweise möchten Sie das Senden der proaktiven Nachricht verschieben, bis die Unterhaltung beendet ist, um den Gesprächsfluss nicht zu unterbrechen.

Über das Feld Wenn Chat aktiv ist können Sie das Verhalten steuern:

  • Senden: Der Agent sendet die proaktive Nachricht oder Karte wie gewohnt.

  • Nicht senden und erfolgreich: Der Agent sendet keine proaktive Nachricht oder Karte, wenn sich der Empfänger in einer aktiven Unterhaltung befindet. Der Statuscode 300 wird zurückgegeben.

  • Nicht senden und fehlgeschlagen: Der Agent sendet keine proaktive Nachricht oder Karte, wenn sich der Empfänger in einer aktiven Unterhaltung befindet. Die Flowausführung wird als fehlgeschlagen markiert.

Wenn der Empfänger den Agenten nicht installiert hat

Der Agent kann nur Nachrichten oder Karten an Empfänger senden, die den Agenten in Microsoft Teams installiert haben. Empfänger möchten den Agenten möglicherweise nicht installieren oder haben den Agenten deinstalliert.

Für Nachrichten mit geringerer Bedeutung können Sie festlegen, dass die Flowausführung als erfolgreich gekennzeichnet wird, auch wenn der Empfänger den Agenten nicht installiert hat.

Über das Feld Falls Bot nicht installiert können Sie das Verhalten steuern:

  • Fehler: Die Flowausführung wird als fehlgeschlagen gekennzeichnet, wenn der Empfänger den Agenten nicht in Microsoft Teams installiert hat.

  • Erfolgreich mit Statuscode: Die Flowausführung wird als erfolgreich markiert, obwohl der Empfänger die Nachricht oder Karte nicht empfangen kann, weil er den Agenten nicht installiert hat. Der Statuscode 100 wird zurückgegeben.

Statuscodedefinition

Sie können den zurückgegebenen Statuscode verwenden, um verschiedene Folgeverhalten in Ihrem Flow zu definieren. Sie können beispielsweise angeben, dass der Flow über einen bestimmten Zeitraum erneut versuchen soll, oder einen Datensatz über den Fehler protokollieren.

Statuscode Erfolgreich (boolesch) Beschreibung
200 true Nachricht wurde erfolgreich zugestellt.
100 False Nachricht oder Karte konnte nicht zugestellt werden, weil der Empfänger den Agenten nicht installiert hat.
300 False Nachricht konnte nicht zugestellt werden, weil der Empfänger sich in einer aktiven Unterhaltung mit dem Agenten befindet.