Senden von Aktivitätsfeedbenachrichtigungen an Benutzer in Microsoft Teams

Mit dem Microsoft Teams-Aktivitätsfeed können Benutzer Elemente, die Aufmerksamkeit erfordern, selektieren, indem sie über Änderungen benachrichtigt werden. Sie können die Aktivitätsfeed-Benachrichtigungs-APIs in Microsoft Graph verwenden, um diese Funktionalität auf Ihre Apps zu erweitern. Auf diese Weise können Ihre Apps umfangreichere Erfahrungen bieten und Benutzer besser einbeziehen, indem sie sie über Änderungen an den von ihnen verwendeten Tools und Workflows auf dem neuesten Stand halten.

Anwendungsfälle für Aktivitätsfeedbenachrichtigungen

• Neuigkeiten: Hilft Benutzern, mit den neuesten Informationen wie neuen Aufgaben oder neuen Beiträgen auf dem Laufenden zu bleiben.
• Zusammenarbeit: Wenn Sie eine Datei freigeben oder einen Benutzer in einem Kommentar @Erwähnung, können Benutzer eine Textvorschau im Benachrichtigungsbanner sehen.
• Erinnerungen: Eine Benachrichtigung, um Sie über ein Ereignis oder eine Aufgabe zu informieren. Beispielsweise haben Sie heute ein Fälligkeitsdatum für die Schulung, und die App sendet Ihnen eine Erinnerungsbenachrichtigung, damit Sie sich einfacher an die Aufgabe oder das Ereignis erinnern können.
• Warnungen: Benachrichtigungen, die dringende oder sofortige Aufmerksamkeit erfordern. Beispielsweise ist das Fälligkeitsdatum einer Schulung abgelaufen, oder ein Administrator hat eine Anfrage zur Behebung eines Fehlers mit der höchsten Priorität gesendet.

Vorteile von Aktivitätsfeedbenachrichtigungen

• Die Aktivitätsfeedbenachrichtigung ist eine native Teams-Integration, die Benutzer nahtlos in die Registerkarten-App bringt und so zusätzliche Benutzerinteraktionen von Aktivitäten in Ihre App ermöglicht.
• Die Aktivitätsfeedbenachrichtigung wird in Microsoft Teams-Desktop- und mobilen Clients mit einer Betriebssystembenachrichtigung bereitgestellt, sodass die Aufmerksamkeit der Benutzer über das Systempopup und den Sound geweckt wird.
• Der Inhalt von Benachrichtigungen ist in hohem Maße anpassbar, sodass Benutzer eine Vorschau der Zusammenfassung der angekündigten Ereignisse anzeigen können.
• Sie können Ihre App mit einer Benachrichtigung verknüpfen, sodass die Interaktion mit der App durch einen Benutzer erhöht wird, wenn ein Benutzer die Benachrichtigung auswählt.
• Sie können Aktivitätsfeedbenachrichtigungen an verschiedene Empfänger senden. Beispielsweise das Senden einer persönlichen Benachrichtigung oder das Senden von Batchbenachrichtigungen an eine Gruppe von Benutzern.
• Die Lokalisierung von App-Manifesten (früher als Teams-App-Manifeste bezeichnet) unterstützt den in Vorlagen enthaltenen Text in Aktivitätsfeedbenachrichtigungen.

Grundlagen von Aktivitätsfeedbenachrichtigungen

In Teams bestehen Aktivitätsfeedbenachrichtigungen aus mehreren Informationen, die zusammen angezeigt werden, wie in der folgenden Abbildung dargestellt:

Die Komponenten umfassen:

Im folgenden Beispiel stellen die Komponenten zusammen die Details zu einer Benachrichtigung bereit.

Arten von Benachrichtigungskarten für Aktivitätsfeeds

Die folgenden Varianten zeigen die Arten von Aktivitätsfeed-Benachrichtigungskarten, die Sie anzeigen können. Das App-Logo ersetzt den Benutzeravatar für App-generierte Benachrichtigungen:

Anforderungen für die Verwendung der Aktivitätsfeedbenachrichtigungs-APIs

Aktivitätsfeed-APIs funktionieren mit einer Teams-App. Im Folgenden finden Sie die Voraussetzungen zum Senden von Aktivitätsfeedbenachrichtigungen:

• Dem App-Manifest muss die Microsoft Entra-App-ID hinzugefügt webApplicationInfo werden. Weitere Informationen finden Sie unter App-Manifestschema.
• Die Aktivitätsbenachrichtigungen können mit oder ohne hinzugefügte Aktivitätstypen im App-Manifest gesendet werden.
  • Standardmäßig können Sie die APIs für Aktivitätsbenachrichtigungen verwenden, ohne den activities Abschnitt im App-Manifest hinzuzufügen. Der systemDefault Aktivitätstyp ist reserviert, sodass Sie in der Actor+Reason Zeile der Aktivitätsfeedbenachrichtigung Freiformtext bereitstellen können. Weitere Informationen finden Sie unter Senden anpassbarer Aktivitätsfeedbenachrichtigungen.

    Hinweis

    Der systemDefault Aktivitätstyp ist nur in der öffentlichen Entwicklervorschau verfügbar.

  • Wenn Sie eine Benachrichtigungsvorlage im herkömmlichen Modus senden möchten, muss die activityTypes Eigenschaft im Abschnitt "Aktivitäten" hinzugefügt werden. Weitere Informationen finden Sie unter App-Manifestschema.
• Die Teams-App muss für den Empfänger entweder persönlich oder in einem Team oder Chat installiert werden, an dem er beteiligt ist.

Berechtigungen

Verwenden Sie delegierte oder Anwendungsberechtigungen, um Aktivitätsfeedbenachrichtigungen zu senden. Wenn Sie Anwendungsberechtigungen verwenden, wird empfohlen, die ressourcenspezifische Zustimmung (RSC) zu verwenden, da die TeamsActivity.Send.User Berechtigung vom Benutzer zum Senden von Aktivitätsbenachrichtigungen erteilt wird. Stellen Sie sicher, dass Sie die RSC-Berechtigungen in Ihrer App-Manifestdatei hinzufügen.

Aktualisierung des App-Manifests

In diesem Abschnitt werden die Updates beschrieben, die dem App-Manifest hinzugefügt werden müssen. Stellen Sie sicher, dass Sie die App-Manifestversion1.7 oder höher verwenden.

"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.7/MicrosoftTeams.schema.json",
"manifestVersion": "1.7",

webApplicationInfo-Update

"webApplicationInfo":
{
    "id": "a3111f15-658e-457c-9689-fd20fe907330",
    "resource": "https://contosoapp.com"
}

Aktualisierung der Aktivitäten

"activities":
{
  "activityTypes": [
    {
      "type": "taskCreated",
      "description": "Task Created Activity",
      "templateText": "{actor} created task {taskId} for you"
    },
    {
      "type": "approvalRequired",
      "description": "Deployment requires your approval",
      "templateText": "{actor} created a new deployment {deploymentId}"
    }
  ]
}

Autorisierungs-Update

"authorization": 
{ 
  "permissions": { 
    "resourceSpecific": [ 
      {
        "type": "Application", 
         "name": "TeamsActivity.Send.User" 
      }, 
      { 
        "type": "Application",
        "name": "TeamsActivity.Send.Group"
      }, 
      { 
        "type": "Application", 
        "name": "TeamsActivity.Send.Chat" 
      } 
    ] 
  }
}

Installieren der Teams-App

Teams-Apps müssen in einem Team, Chat oder für einen Benutzer im persönlichen Bereich installiert sein, damit Benutzer Aktivitätsfeedbenachrichtigungen erhalten können. Ausführliche Informationen finden Sie unter Verteilungsmethoden für Teams-Apps. Für Entwicklungszwecke bevorzugen wir den benutzerdefinierten App-Upload. Nach der Entwicklung können Sie die richtige Verteilungsmethode auswählen, je nachdem, ob Sie für einen Mandanten oder für alle Mandanten veröffentlichen möchten.

Sie können auch Teams-App-Installations-APIs verwenden, um Teams-App-Installationen zu verwalten.

Aktivitätsfeedbenachrichtigungen an Benutzer senden

Da eine Teams-App für einen Benutzer, in einem Team oder in einem Chat installiert werden kann, kann sie auch Benachrichtigungen in den folgenden drei Kontexten senden:

• Benachrichtigung an Benutzer in einem Chat senden
• Benachrichtigung an Benutzer in einem Team senden
• Benachrichtigung an den Benutzer senden

Darüber hinaus können Sie Benachrichtigungen in einem Massenvorgang an bis zu 100 Benutzer gleichzeitig senden:

• Massensenden von Benachrichtigungen an mehrere Benutzer

Details zu den unterstützten Themen für jedes Szenario finden Sie in den spezifischen APIs. Benutzerdefinierte textbasierte Themen werden für alle Szenarien unterstützt.

Sie können die Aktivitätsfeedbenachrichtigung in den folgenden Szenarien verwenden:

• Benachrichtigen Sie Einzelpersonen über angepasste Inhalte, die ihre Aufmerksamkeit erfordern.
• Anzeigen umfangreicher Inhalte in Registerkarten, Apps oder URLs.
• Unterstützung komplexer Benutzerinteraktionen.
• Senden delegierter Benachrichtigungen von dem Benutzer, der die Benachrichtigung initiiert hat.
• Legen Sie die Vorlage in das App-Manifest ein.
• Teams übernimmt die Lokalisierung für Benachrichtigungen.

Anpassen der Benachrichtigungen

Teams-Benutzer können die Benachrichtigungen anpassen, die in ihrem Feed oder als Banner angezeigt werden. Über Aktivitätsfeed-APIs generierte Benachrichtigungen können ebenfalls angepasst werden. Benutzer können über Einstellungen in Teams auswählen, wie sie benachrichtigt werden. Teams-Apps werden in der Liste angezeigt, aus der der Benutzer auswählen kann, wie im folgenden Screenshot gezeigt:

Benutzer können neben einer App "Bearbeiten " auswählen und die Benachrichtigungen anpassen. Das App-Manifest zeigt das description Feld an.

Beispiele

Beispiele zum Senden einer Aktivitätsfeedbenachrichtigung finden Sie unter Beispiele für das Senden von Aktivitätsfeedbenachrichtigungen.

Reservierter Aktivitätstyp zum Senden von Aktivitätsfeedbenachrichtigungen

• Der systemDefault Aktivitätstyp ist reserviert und kann beim Hinzufügen von Aktivitäten nicht im App-Manifest verwendet werden.
• Es wird empfohlen, vorgefertigte Benachrichtigungen zu verwenden, da sie von Aktivitätsvorlagen im App-Manifest für wiederkehrende und große Blöcke von Benachrichtigungen abhängen.
• Der systemDefault reservierte Aktivitätstyp ist auch dann verfügbar, wenn die anderen Aktivitätstypen in Ihrem App-Manifest aufgeführt sind.

Im Folgenden finden Sie die Vorteile und Einschränkungen für den systemDefault Aktivitätstyp:

Codebeispiel

Schrittweise Anleitung

Folgen Sie der Schritt-für-Schritt-Anleitung zum Senden von Aktivitätsfeedbenachrichtigungen in Teams.

Siehe auch

• Benachrichtigungsbot in Teams
• Entwerfen von Aktivitätsfeedbenachrichtigungen für Ihre Microsoft Teams-App