Bewährte Methoden für die Verwendung von Microsoft Teams-Aktivitätsfeedbenachrichtigungen
In diesem Artikel werden bewährte Methoden für die Verwendung von Microsoft Teams-Aktivitätsfeedbenachrichtigungen in Microsoft Graph behandelt. Diese bewährten Methoden gelten für:
- Erstellen von Handlungsaufrufbenachrichtigungen
- Anfordern von Antworten auf Benachrichtigungen
- Erstellen von Benachrichtigungen zu externen Ereignissen
Die folgende Abbildung zeigt ein Beispiel für eine Aktivitätsfeedbenachrichtigung in Teams:
Beachten Sie beim Implementieren von Aktivitätsfeedbenachrichtigungen die folgenden Punkte:
- Popupbenachrichtigungen leiten Benutzer zum Aktivitätsfeed und nicht zur App um. Um eine andere Aktivität anzuzeigen, müssen Benutzer die zugeordnete Benachrichtigung im Aktivitätsfeed auswählen.
- Benutzer können Benachrichtigungseinstellungen erst verwalten, nachdem die ausgewählte App eine Benachrichtigung gesendet hat.
- Das Symbol für jede Benachrichtigung ist im App-Manifest enthalten. Microsoft Graph unterstützt das Anpassen des Symbols nicht.
- Prioritätsbenachrichtigungen werden nicht unterstützt.
Verbessern der Benachrichtigungserfahrung
Microsoft Teams zeigt Benachrichtigungen sowohl im Aktivitätsfeed als auch im Popupformat an. Benutzer erhalten Benachrichtigungen von mehreren Quellen über Chats, Kanäle, Besprechungen oder andere Apps hinweg. Wenden Sie die folgenden Empfehlungen an, um die Benutzererfahrung zu verbessern:
- Lokalisieren Sie den Inhalt in einem Benachrichtigungs-Popup oder Feed. Die Lokalisierung erfolgt nur, wenn der Inhalt der App lokalisiert ist.
- Geben Sie geeignete Titel und Beschreibungen für Ihre Aktivitätstypen an. Verwenden Sie kurze Titel, z. B. @Erwähnung und Ankündigungen. Vermeiden Sie lange Titel, z. B. Aktivitäten nach der Benutzererstellung und Nach der Erstellung.
- Benachrichtigungen sollten wichtige Informationen vermitteln, die für den Benutzer relevant sind. Diego hat Ihnen beispielsweise ein Verkaufsticket zugewiesen , ist eine relevante Nachricht; Joni verließ das Vertriebsteam nicht.
- Vermeiden Sie das Senden von Werbebenachrichtigungen, z . B. Testen Sie das neue Feature in der Fahrrad-App.
- Vermeiden Sie doppelte Benachrichtigungen von Botnachrichten und Aktivitätsfeedbenachrichtigungen. Weitere Informationen finden Sie unter Auswählen von Aktivitätsfeedbenachrichtigungen oder Bot Framework-Nachrichten.
- Verwenden Sie den Textvorschauabschnitt in Benachrichtigungen. Stellen Sie Informationen bereit, die dem Benutzer helfen, die Wichtigkeit der Benachrichtigung zu bestimmen und ggf. Maßnahmen zu ergreifen.
- Fügen Sie am Ende des Benachrichtigungstitels keinen Punkt hinzu, um mit allen anderen Benachrichtigungseinstellungen in Teams konsistent zu sein.
- Stellen Sie dem Benutzer die Beziehung zwischen der Benachrichtigung und ihrem Inhalt klar. Wenn ein Benutzer beispielsweise eine Benachrichtigung für die Genehmigung eines Urlaubs empfängt, sollte die Benachrichtigung den Benutzer an den entsprechenden Abschnitt der App umleiten. Wenn sich die Benachrichtigung auf das Entfernen oder Löschen von Entitäten bezieht, z. B. Benutzer und Aufgaben, leiten Sie den Empfänger an den Inhalt weiter, und geben Sie die erforderliche Aktion an.
- Stellen Sie sicher, dass die Feederfahrung eigenständig ist. Beispielsweise müssen alle Popups und Modalen in der App verbleiben.
- Stellen Sie sicher, dass Ihre App pro Minute und Benutzer nicht mehr als 20 Benachrichtigungen sendet. Benachrichtigungen werden automatisch gedrosselt, wenn die Anzahl 20 überschreitet.
- Stellen Sie sicher, dass sich die Ladezeit Ihrer App nicht negativ auf die Erfahrung für Benutzer auswirkt, wenn sie zwischen Benachrichtigungen im Feed wechseln.
- Informieren Sie den Benutzer über den Speicherzeitraum für Benachrichtigungen im Aktivitätsfeed. In Microsoft Teams beträgt der Speicherzeitraum 30 Tage.
Hinweis
Das Speicherlimit von 30 Tagen gilt für alle Benachrichtigungen. Sie ist nicht spezifisch für Benachrichtigungen, die über die API für Aktivitätsfeedbenachrichtigungen gesendet werden.
Auswählen von Aktivitätsfeedbenachrichtigungen oder Bot Framework-Nachrichten
Sie können entweder Aktivitätsfeedbenachrichtigungen oder Bot-Framework-Nachrichten verwenden, aber nicht beide Benachrichtigungstypen. In den folgenden Abschnitten werden die Benachrichtigungstypen und deren Verwendung beschrieben.
Aktivitätsfeed-Benachrichtigungen
Aktivitätsfeedbenachrichtigungen werden im Teams-Aktivitätsfeed angezeigt und können Links zu verschiedenen Speicherorten enthalten. Diese Benachrichtigungen:
- Erlauben Sie dem Benutzer, maßnahmen zu ergreifen oder die Benachrichtigung zu selektieren.
- Führen Sie den Benutzer zu einer Registerkarte in einem Chat oder Kanal, einer persönlichen App oder einer Chat- oder Kanalnachricht.
Mit der Benachrichtigungs-API für Aktivitätsfeeds können Benutzer Benachrichtigungen für jeden Benachrichtigungstyp über Benachrichtigungseinstellungen konfigurieren.
Wenn Sie Aktivitätsfeedbenachrichtigungen verwenden, beachten Sie, dass Ihre App möglicherweise doppelte Benachrichtigungen sendet, wenn sie Botbenachrichtigungen an Chats oder Kanäle und auch an den Aktivitätsfeed sendet. Senden Sie doppelte Benachrichtigungen nur, wenn ihr Szenario dies erfordert.
Verwenden Sie delegierte Benachrichtigungen, um eine bessere Benachrichtigungserfahrung zu schaffen. Die Aktivitätsfeedbenachrichtigungs-API kann entweder delegierte oder nur anwendungsbezogene Aufrufe senden. In delegierten Anrufen wird der Absender der Benachrichtigung als der Benutzer angezeigt, der die Benachrichtigung initiiert hat, und in Aufrufen nur der Anwendung wird der Absender als App angezeigt.
Sie können eine vorhandene Aktivitätsfeedbenachrichtigung aktualisieren, anstatt eine neue Benachrichtigung mithilfe des parameters chainId zu erstellen.
Bot Framework-Nachrichten
Botnachrichten werden als Chat- oder Kanalnachrichten übermittelt. Wenn der Benutzer Chat- oder Kanalbenachrichtigungen aktiviert, werden die ausgelösten Benachrichtigungen als Chat- oder Kanalnachrichten gesendet. Um Botnachrichten zu senden, Erwähnung den Namen des Benutzers, damit die Benachrichtigung im Aktivitätsfeed angezeigt wird.
Es ist nützlich, dass die Warnung als Chat- oder Kanalnachricht verwendet wird. Beispielsweise eine Nachricht, die von allen Kanalmitgliedern genutzt wird.