Freigeben über


Senden von Aktivitätsfeedbenachrichtigungen an Benutzer in Microsoft Teams

Der Microsoft Teams-Aktivitätsfeed benachrichtigt Benutzer über Änderungen, damit sie Elemente selektieren können, die Aufmerksamkeit erfordern. Aktivitätsfeedbenachrichtigungen in Teams enthalten die folgenden Features:

  • Native Integration in Teams, die den Benutzer nahtlos in die Tab-App bringt und zusätzliche Benutzerbindung über den Teams-Aktivitätsbereich zu Ihrer App bietet.
  • Betriebssystembenachrichtigungen in Teams-Desktop- und mobilen Clients, die ein Popup- und Soundelement enthalten.
  • Anpassbare Benachrichtigungsinhalte, mit denen Sie dem Benutzer mehr oder weniger Vorschauinhalte anzeigen können.
  • Möglichkeit, eine Deep-Link-Verknüpfung zwischen Registerkarte, persönlicher App, Botnachricht oder adaptiver Karte mit einer Benachrichtigung zu erstellen, um die Benutzerbindung mit Ihrer App zu erhöhen.
  • Möglichkeit zum Senden von Aktivitätsfeedbenachrichtigungen an mehrere Empfänger, z. B. Batchbenachrichtigungen an eine Gruppe von Benutzern.

Sie können die Benachrichtigungs-APIs für Aktivitätsfeeds in Microsoft Graph verwenden, um diese Funktionalität auf Ihre Apps zu erweitern. Auf diese Weise können Sie umfangreichere Erfahrungen bereitstellen und Benutzer einbinden, indem Sie sie dabei unterstützen, über Änderungen in den von ihnen verwendeten Tools und Workflows auf dem laufenden zu bleiben.

Die Benachrichtigungs-APIs für Aktivitätsfeeds in Microsoft Graph ermöglichen die folgenden Anwendungsfälle:

  • Neuigkeiten : Halten Sie Benutzer mit den neuesten Informationen auf dem Laufenden, z. B. neue Aufgaben oder neue Beiträge.
  • Zusammenarbeit : Zeigt Benutzern eine Vorschau im Benachrichtigungsbanner an, wenn jemand eine Datei freigibt oder @ sie in einem Kommentar erwähnt.
  • Erinnerungen : Senden von Benachrichtigungen zu Ereignissen oder Aufgaben an Benutzer.
  • Warnungen : Senden Sie Benachrichtigungen, die dringende oder sofortige Aufmerksamkeit erfordern, z. B. ein überfälliges Fälligkeitsdatum oder ein Arbeitselement mit hoher Priorität.

Mithilfe von Aktivitätsfeedbenachrichtigungen können Sie folgende Aktionen ausführen:

  • Informieren Sie Einzelpersonen über angepasste Inhalte, die ihre Aufmerksamkeit erfordern.
  • Zeigen Sie umfangreiche Inhalte in einer Tab-App oder URL an.
  • Unterstützung komplexer Benutzerinteraktionen.
  • Senden delegierter Benachrichtigungen von dem Benutzer, der eine Benachrichtigung initiiert hat.

Teams übernimmt die Lokalisierung für Benachrichtigungen.

Komponenten von Aktivitätsfeedbenachrichtigungen

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

Abbildung der Komponenten einer Aktivitätsfeedbenachrichtigung, einschließlich Akteur, Grund, Zeitstempel, Vorschau und Thema.

In der folgenden Tabelle werden die Komponenten beschrieben.

Komponente Beschreibung
Avatar Zeigt an, wer die Aktivität initiiert hat.
Aktivitätstyp oder App-Symbol Der Typ der Aktivität. Bei App-Benachrichtigungen wird das Liniensymbol durch ein App-Symbol ersetzt.
Titel: Akteur + Grund Actor ist der Name des Benutzers oder der App, der die Aktivität initiiert hat. Reason beschreibt die Aktivität.
Timestamp Zeigt an, wann die Aktivität aufgetreten ist.
Textvorschau Zeigt eine abgeschnittene Zeile am Anfang der Benachrichtigung an.
Thema Zugeordnete Ressource oder der Textwert des Themas aus dem Anforderungstext.

Die folgende Abbildung zeigt ein Beispiel für eine Aktivitätsfeedbenachrichtigung in Teams. In diesem Beispiel hat ein Benutzer einen Beitrag in einer App freigegeben.

Abbildung einer Yammer-Aktivitätsfeedbenachrichtigung

Typen von Aktivitätsfeed-Benachrichtigungskarten

Die folgenden Registerkarten zeigen die Typen von Aktivitätsfeed-Benachrichtigungskarten an, die Sie anzeigen können. Bei von der App generierten Benachrichtigungen wird das Benutzerlogo durch das App-Logo ersetzt.

Teams benutzerdefiniert

Screenshot: Aktivitätsfeedbenachrichtigungen in einem benutzerdefinierten Teams-Desktop

Windows

Screenshot, der Aktivitätsfeedbenachrichtigungen in einem Windows-Desktop-Teams zeigt.

Mac

Screenshot: Benachrichtigungen zu Aktivitätsfeeds in Teams auf einem Mac-Desktop

Anforderungen für die Verwendung der Benachrichtigungs-APIs für Aktivitätsfeeds

Aktivitätsfeed-APIs funktionieren mit einer Teams-App. Im Folgenden sind die Anforderungen für das Senden von Aktivitätsfeedbenachrichtigungen aufgeführt:

  • Im Teams-App-Manifest muss die Microsoft Entra App-ID dem webApplicationInfo Abschnitt hinzugefügt werden. Weitere Informationen finden Sie unter Manifestschema.
  • Aktivitätsbenachrichtigungen können mit oder ohne Aktivitätstypen gesendet werden, die im App-Manifest deklariert sind.
    • Standardmäßig können Sie die Aktivitätsbenachrichtigungs-APIs verwenden, ohne den activities Abschnitt im Manifest zu deklarieren. Der systemDefault Aktivitätstyp ist reserviert, sodass Sie textfrei in der Actor+Reason Zeile der Aktivitätsfeedbenachrichtigung bereitstellen können. Weitere Informationen finden Sie unter Senden anpassbarer Aktivitätsfeedbenachrichtigungen.
    • Wenn Sie eine vorlagenbasierte Benachrichtigung im herkömmlichen Modus senden möchten, müssen Aktivitätstypen im Abschnitt Aktivitäten deklariert werden. Weitere Informationen finden Sie unter Manifestschema.
  • Die Teams-App muss für den Empfänger installiert werden, entweder persönlich oder in einem Team oder Chat , dem er angehört. Weitere Informationen finden Sie unter Microsoft Teams-App-Installation.

Berechtigungen

Sie können delegierte Oder Anwendungsberechtigungen verwenden, um Aktivitätsbenachrichtigungen zu senden. Wenn Sie Anwendungsberechtigungen verwenden, empfiehlt es sich, die ressourcenspezifische Zustimmung (RESOURCE-Specific Consent, RSC) zu verwenden, da die TeamsActivity.Send.User Berechtigung dem Benutzer die Zustimmung zum Senden von Aktivitätsbenachrichtigungen ermöglicht. Sie müssen RSC-Berechtigungen in Ihrem Teams-App-Manifestschema deklarieren.

Updates des Teams-App-Manifests

In diesem Abschnitt werden die Änderungen beschrieben, die Sie am Teams-App-Manifest vornehmen müssen, um Aktivitätsfeedbenachrichtigungen zu implementieren. Sie müssen mindestens die Version des Teams-App-Manifests1.7 verwenden.

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

webApplicationInfo-Update

Sie müssen Microsoft Entra id und resource Informationen in Ihrer App-Manifesteigenschaft webApplicationInfo aktualisieren.

"webApplicationInfo":
{
    "id": "a3111f15-658e-457c-9689-fd20fe907330",
    "resource": "https://contosoapp.com"
}
Parameter Typ Beschreibung
id string Microsoft Entra (Client-ID).
resource string Ressource, die der Azure AD-App zugeordnet ist. Er wird auch als Antwort- oder Umleitungs-URI in der Übersicht über die Microsoft Entra Admin Center App-Registrierung bezeichnet.

Hinweis

Möglicherweise erhalten Sie einen Fehler, wenn mehrere Teams-Apps im gleichen Bereich (Team, Chat oder Benutzer) dieselbe Microsoft Entra-App verwenden. Stellen Sie sicher, dass Sie eindeutige Microsoft Entra-Apps verwenden.

Aktivitätsaktualisierung

Sie müssen die activities -Eigenschaft in Ihrem App-Manifest definieren, um einen Benutzeraktivitätsfeed zu veröffentlichen.

"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}"
    }
  ]
}
Parameter Typ Beschreibung
type string Der Typ muss in einem bestimmten Manifest eindeutig sein.
description string Lesbare Kurzbeschreibung. Die Beschreibung ist auf dem Microsoft Teams-Client sichtbar.
templateText string Vorlagentext für die Aktivitätsbenachrichtigung. Sie können Ihre Parameter deklarieren, indem Sie Parameter in geschweiften Klammern {}kapseln.

Hinweis

  • actor ist ein spezieller Parameter, der immer den Namen des Aufrufers annimmt. Bei delegierten Aufrufen actor ist der Name des Benutzers. Bei reinen Anwendungsaufrufen wird der Name der Teams-App verwendet.

  • Der reservierte systemDefault Aktivitätstyp sollte nicht im activities Abschnitt des Manifests angegeben werden. Der reservierte Aktivitätstyp kann Freiformtext in der Actor+Reason Zeile der Aktivitätsfeedbenachrichtigung bereitstellen. Weitere Informationen finden Sie unter Senden anpassbarer Aktivitätsfeedbenachrichtigungen.

Autorisierungsupdate

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

Parameter Typ Beschreibung
type string Der Berechtigungstyp für die ressourcenspezifische Zustimmung (RSC).
name string Der Name der RSC-Berechtigung. Weitere Informationen finden Sie unter Unterstützte RSC-Berechtigungen.

Installieren der Teams-App

Teams-Apps können in einem Team, in einem Chat oder für einen Benutzer persönlich installiert und auf verschiedene Arten verteilt werden. Weitere Informationen finden Sie unter Teams-App-Verteilungsmethoden. In der Regel wird das Querladen für Entwicklungszwecke bevorzugt. Nach der Entwicklung können Sie die richtige Verteilungsmethode auswählen, je nachdem, ob Sie an einen Mandanten oder alle Mandanten verteilen möchten.

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

Senden von Aktivitätsfeedbenachrichtigungen an Benutzer

Hinweis

Um Aktivitätsfeedbenachrichtigungen auf iOS- und Android-Clients anzuzeigen, muss die App in der Zulassungsliste enthalten sein. Es werden nur Apps von Drittanbietern unterstützt.

Da eine Teams-App für einen Benutzer, in einem Team oder in einem Chat installiert werden kann, können die Benachrichtigungen in drei Kontexten gesendet werden. Ausführliche Informationen zum Senden von Benachrichtigungen in den einzelnen Kontexten finden Sie in den folgenden Themen:

Darüber hinaus können Benachrichtigungen in einem Massenvorgang an bis zu 100 Benutzer gleichzeitig gesendet werden. Ausführliche Informationen finden Sie im folgenden Thema:

Ausführliche Informationen dazu, welche Themen für jedes Szenario unterstützt werden, finden Sie in den spezifischen APIs. Benutzerdefinierte textbasierte Themen werden für alle Szenarien unterstützt.

Hinweis

Das Aktivitätssymbol basiert auf dem Kontext, in dem die Anforderung erfolgt. Wenn die Anforderung mit delegierten Berechtigungen erfolgt, wird das Foto des Benutzers als Avatar angezeigt, während das Symbol der Teams-App als Aktivitätssymbol angezeigt wird. In einem reinen Anwendungskontext wird das Symbol der Teams-App als Avatar verwendet, und das Aktivitätssymbol wird weggelassen.

Beispiel 1: Benachrichtigen eines Benutzers über eine in einem Chat erstellte Aufgabe

Das folgende Beispiel zeigt, wie Sie eine Aktivitätsfeedbenachrichtigung für eine neue Aufgabe senden können, die in einem Chat erstellt wurde. In diesem Fall muss die Teams-App in einem Chat mit der ID chatId installiert werden, und der Benutzer 569363e2-4e49-4661-87f2-16f245c5d66a muss ebenfalls Teil des Chats sein.

Anforderung

POST https://graph.microsoft.com/v1.0/chats/{chatId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/chats/{chatId}"
    },
    "activityType": "taskCreated",
    "previewText": {
        "content": "New Task Created"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "taskId",
            "value": "12322"
        }
    ]
}

Antwort

HTTP/1.1 204 No Content

Beispiel 2: Benachrichtigen eines Benutzers über eine aufgabe, die in einem Team erstellt wurde

Das folgende Beispiel zeigt, wie Sie eine Aktivitätsfeedbenachrichtigung für ein Team senden können. In diesem Beispiel wird der Teambesitzer über eine neue Aufgabe benachrichtigt, die seine Aufmerksamkeit erfordert.

Anforderung

POST https://graph.microsoft.com/v1.0/teams/{teamId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/teams/{teamId}"
    },
    "activityType": "taskCreated",
    "previewText": {
        "content": "New Task Created"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "taskId",
            "value": "12322"
        }
    ]
}

Antwort

HTTP/1.1 204 No Content

Beispiel 3: Benachrichtigen eines Benutzers über ein Ereignis mithilfe eines benutzerdefinierten Themas

Wie in den vorherigen Beispielen gezeigt, können Sie links zu verschiedenen Team- oder Chataspekten erstellen. Wenn Sie jedoch eine Verknüpfung mit einem Aspekt herstellen möchten, der nicht Teil des Teams ist oder Microsoft Graph ihn nicht darstellt, oder wenn Sie den Namen anpassen möchten, können Sie die Quelle von topic auf text festlegen und einen benutzerdefinierten Wert dafür übergeben. Darüber hinaus ist erforderlich, webUrl wenn Sie source als textverwendentopic.

Das oben gezeigte Yammer Benachrichtigungsbeispiel verwendet ein benutzerdefiniertes Thema, da Microsoft Graph die Ressourcen von Yammer nicht unterstützt.

Hinweis

webUrl muss mit der Microsoft Teams-Domäne beginnen (z. B. teams.microsoft.com).

Anforderung

POST https://graph.microsoft.com/v1.0/teams/{teamId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Deployment Approvals Channel",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "activityType": "approvalRequired",
    "previewText": {
        "content": "New deployment requires your approval"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "deploymentId",
            "value": "6788662"
        }
    ]
}

Antwort

HTTP/1.1 204 No Content

Beispiel 4: Benachrichtigen der Teammitglieder über ein Ereignis

Das folgende Beispiel zeigt, wie Sie eine Aktivitätsfeedbenachrichtigung an alle Teammitglieder senden können. In diesem Beispiel werden die Teammitglieder über ein neues Ereignis benachrichtigt.

Anforderung

POST https://graph.microsoft.com/v1.0/teams/7155e3c8-175e-4311-97ef-572edc3aa3db/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Weekly Virtual Social",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "previewText": {
        "content": "It will be fun!"
    },
    "activityType": "eventCreated",
    "recipient": {
        "@odata.type": "microsoft.graph.teamMembersNotificationRecipient",
        "teamId": "7155e3c8-175e-4311-97ef-572edc3aa3db"
    }
}

Antwort

HTTP/1.1 204 No Content

Beispiel 5: Benachrichtigen der Kanalmitglieder über ein Ereignis

Das folgende Beispiel zeigt, wie Sie eine Aktivitätsfeedbenachrichtigung an alle Kanalmitglieder senden können. In diesem Beispiel werden die Kanalmitglieder über ein neues Ereignis benachrichtigt.

Anforderung

POST https://graph.microsoft.com/v1.0/teams/7155e3c8-175e-4311-97ef-572edc3aa3db/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Weekly Virtual Social",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "previewText": {
        "content": "It will be fun!"
    },
    "activityType": "eventCreated",
    "recipient": {
        "@odata.type": "microsoft.graph.channelMembersNotificationRecipient",
        "teamId": "7155e3c8-175e-4311-97ef-572edc3aa3db",
        "channelId": "19:0ea5de04de4743bcb4cd20cb99235d99@thread.tacv2"
    }
}

Antwort

HTTP/1.1 204 No Content

Beispiel 6: Benachrichtigen der Chatmitglieder über ein Ereignis

Das folgende Beispiel zeigt, wie Sie eine Aktivitätsfeedbenachrichtigung an alle Chatmitglieder senden können. In diesem Beispiel werden die Chatmitglieder über ein neues Ereignis benachrichtigt.

Anforderung

POST https://graph.microsoft.com/v1.0/chats/19:d65713bc498c4a428c71ef9353e6ce20@thread.v2/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Weekly Virtual Social",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "previewText": {
        "content": "It will be fun!"
    },
    "activityType": "eventCreated",
    "recipient": {
        "@odata.type": "microsoft.graph.chatMembersNotificationRecipient",
        "chatId": "19:d65713bc498c4a428c71ef9353e6ce20@thread.v2"
    }
}

Antwort

HTTP/1.1 204 No Content

Beispiel 7: Benachrichtigen mehrerer Benutzer über ausstehende Finanzgenehmigungsanforderungen

Das folgende Beispiel zeigt, wie Eine Aktivitätsfeedbenachrichtigung massenweise an mehrere Benutzer gesendet wird. In diesem Beispiel werden mehrere Projektbeteiligte über ausstehende Finanzgenehmigungsanforderungen benachrichtigt.

Anforderung

POST https://graph.microsoft.com/v1.0/teamwork/sendActivityNotificationToRecipients
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/{teamsAppId}"
    },
    "activityType": "pendingFinanceApprovalRequests",
    "previewText": {
        "content": "Internal spending team has a pending finance approval requests"
    },
    "recipients": [
        {
            "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
            "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
        },
        {
            "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
            "userId": "ab88234e-0874-477c-9638-d144296ed04f"
        },
        {
            "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
            "userId": "01c64f53-69aa-42c7-9b7f-9f75195d6bfc"
        }
    ],
    "templateParameters": [
        {
            "name": "pendingRequestCount",
            "value": "5"
        }
    ] 
}

Antwort

HTTP/1.1 202 Accepted

Beispiel 8: Senden einer Benachrichtigung an einen Benutzer mithilfe des Aktivitätstyps systemDefault

Das folgende Beispiel zeigt, wie Sie eine Aktivitätsbenachrichtigung für ein Team ohne im Manifest definierte Aktivitätstypen senden können. Sie haben die Flexibilität, hier Freiformtext bereitzustellen. Weitere Informationen finden Sie unter Reservierte Aktivitätstypen.

In diesem Beispiel wird der Teambesitzer benachrichtigt, eine kurze Pause einlegen zu müssen. Ändern Sie in valuetemplateParameters , um die Benachrichtigung für verschiedene Szenarien anzupassen.

Anforderung

POST https://graph.microsoft.com/v1.0/teams/{teamId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/teams/{teamId}"
    },
    "activityType": "systemDefault",
    "previewText": {
        "content": "Take a break"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "systemDefaultText",
            "value": "You need to take a short break"
        }
    ]
}

Antwort

HTTP/1.1 204 No Content

Reservierte Aktivitätstypen

Der systemDefault Aktivitätstyp ist reserviert und kann beim Deklarieren von Aktivitäten nicht im Manifest verwendet werden. Sie können den Aktivitätstyp systemDefault für Folgendes verwenden:

  • Testen Sie ganz einfach neue Szenarien, und/oder testen Sie schnell die Benachrichtigungs-APIs des Aktivitätsfeeds, ohne Aktivitätstypen in Ihrem App-Manifest zu definieren.
  • Sparen Sie bei Store-Apps Zeit und optimieren Sie den Prozess, da Sie aktivitätstypen in Ihrem App-Manifest nicht ständig anpassen müssen. Der systemDefault Aktivitätstyp kann von Anfang an verwendet werden.

Beachten Sie, dass mit dem Aktivitätstyp systemDefault Folgendes nicht möglich ist:

  • Nutzen Sie die integrierten Lokalisierungsfeatures, die von Manifesten bereitgestellt werden.
  • Verlassen Sie sich darauf, anpassbare Benachrichtigungen mit dem Aktivitätstyp systemDefault zu senden. Benutzer können alle Benachrichtigungen aus Ihrer App mit einem Umschalter in den Microsoft Teams-Clienteinstellungen deaktivieren, was die Kommunikation zwischen Ihrer App und ihren Benutzern behindern kann.

Wir empfehlen weiterhin vorlagenbasierte Benachrichtigungen für wiederkehrende und große Batches von Benachrichtigungen, da sie Aktivitätsvorlagen im Manifest erfordern.

Der systemDefault reservierte Aktivitätstyp bleibt verfügbar, unabhängig von den Aktivitätstypen, die im Manifest Ihrer App aufgeführt sind.

Passen Sie an, wie sie durch die Benachrichtigungen benachrichtigt werden

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

Screenshot der Benachrichtigungseinstellungen in Teams mit hervorgehobener Option

Benutzer können neben einer App Bearbeiten auswählen und die Benachrichtigungen anpassen, wie im folgenden Beispiel gezeigt. Das description Feld im Teams-App-Manifest wird angezeigt.

Screenshot: Benachrichtigungen, die an Banner und Feed für eine Teams-App angepasst wurden

Häufig gestellte Fragen

Wer muss die Teams-App installieren?

Der Zielbenutzer muss die Teams-App installiert haben, die Benachrichtigungen sendet.

Kann ein Benutzer Benachrichtigungen an sich selbst senden?

Nein, ein Benutzer kann keine Benachrichtigungen an sich selbst senden. Verwenden Sie für dieses Szenario Anwendungsberechtigungen.

Kann eine Teams-App steuern, wie die Benachrichtigungen dem Benutzer angezeigt werden?

Nein, nur Benutzer dürfen Benachrichtigungseinstellungen ändern.

Ich habe meine App installiert; Warum werden keine Benachrichtigungseinstellungen unter dem Benutzerkonto angezeigt?

Die Einstellungen werden angezeigt, nachdem die Teams-App die erste Benachrichtigung gesendet hat. Dadurch wird die Anzahl der Einstellungen reduziert, die Benutzern angezeigt werden.

Ich habe einen Fehler vom Typ 409 (Konflikt) erhalten; Wie kann ich es beheben?

Conflict-Fehler treten in erster Linie auf, wenn mehrere Teams-Apps, die im gleichen Bereich (Team, Chat, Benutzer usw.) installiert sind, die gleiche Microsoft Entra appId im webApplicationInfo Abschnitt des Manifests aufweisen. In diesem Fall erhalten Sie eine Fehlermeldung wie Found multiple applications with the same Microsoft Entra App ID 'Your Microsoft Entra AppId'.. Stellen Sie sicher, dass Sie eindeutige Microsoft Entra-Apps für eindeutige Teams-Apps verwenden. Sie können dieselbe Teams-App in mehreren Bereichen (z. B. Team und Benutzer) installieren.