Envoyer des notifications de flux d’activités aux utilisateurs dans Microsoft Teams

Le flux d’activités Microsoft Teams permet aux utilisateurs de trier les éléments qui nécessitent une attention particulière en les informant des modifications. Vous pouvez utiliser les API de notification de flux d’activité dans Microsoft Graph pour étendre cette fonctionnalité à vos applications. Vos applications peuvent ainsi offrir des expériences plus riches et mieux impliquer les utilisateurs en les tenant informés des modifications apportées aux outils et aux flux de travail qu’ils utilisent.

Cas d’utilisation des notifications de flux d’activités

• Actualités : permet aux utilisateurs de rester à jour avec les informations les plus récentes, telles que les nouveaux devoirs ou les nouvelles publications.
• Collaboration : lorsque vous partagez un fichier ou @ mention un utilisateur dans un commentaire, les utilisateurs peuvent voir un aperçu du texte dans la bannière de notification.
• Rappels : une notification pour vous informer d’un événement ou d’une tâche. Par exemple, vous avez une date d’échéance de formation aujourd’hui et l’application vous envoie une notification de rappel pour vous aider à vous souvenir de la tâche ou de l’événement.
• Alertes : notifications nécessitant une attention urgente ou immédiate. Par exemple, la date d’échéance d’une formation est passée ou un administrateur a envoyé une demande pour corriger un bogue avec la priorité la plus élevée.

Avantages des notifications de flux d’activités

• La notification de flux d’activités est une intégration native de Teams qui permet à l’utilisateur d’entrer facilement dans l’application Tab, ce qui ajoute de l’activité à votre application un engagement utilisateur supplémentaire.
• La notification de flux d’activités est fournie avec une notification du système d’exploitation dans les clients mobiles et de bureau Teams, de sorte que l’attention des utilisateurs est attirée par la fenêtre contextuelle du système et le son.
• Le contenu des notifications est hautement personnalisable, ce qui permet aux utilisateurs d’afficher un aperçu du résumé des événements notifiés.
• Vous pouvez établir un lien étroit entre votre application et une notification, de sorte que lorsqu’un utilisateur sélectionne la notification, cela augmente l’engagement de l’application utilisateur.
• Vous pouvez envoyer une notification de flux d’activités à différents destinataires. Par exemple, l’envoi d’une notification personnelle ou de notifications par lots à un groupe d’utilisateurs.
• La localisation du manifeste d’application (précédemment appelé manifeste d’application Teams) prend en charge le texte modèle dans les notifications de flux d’activités.

Comprendre les concepts de base des notifications de flux d’activités

Dans Teams, les notifications de flux d’activités sont constituées de plusieurs bits d’informations affichés ensemble, comme illustré dans l’image suivante :

Ces composants sont les suivants :

L’exemple suivant montre les composants fournissant ensemble les détails d’une notification.

Types de cartes de notification de flux d’activités

Les variantes suivantes montrent les types de cartes de notification de flux d’activité que vous pouvez afficher. Le logo de l’application remplace l’avatar de l’utilisateur pour les notifications générées par l’application :

Configuration requise pour utiliser les API de notification de flux d’activités

Les API de flux d’activités fonctionnent avec une application Teams. Voici les conditions requises pour l’envoi de notifications de flux d’activités :

• L’ID d’application Microsoft Entra doit être ajouté à la webApplicationInfo section. Pour plus d’informations, consultez Schéma du manifeste de l’application.
• Les notifications d’activité peuvent être envoyées avec ou sans types d’activité ajoutés dans le manifeste de l’application.
  • Par défaut, vous pouvez utiliser les API de notification d’activité sans ajouter la activities section dans le manifeste de l’application. Le systemDefault type d’activité est réservé, ce qui vous permet de fournir du texte en forme libre dans la Actor+Reason ligne de la notification de flux d’activités. Pour plus d’informations, consultez Envoyer des notifications de flux d’activités personnalisables.

    Remarque

    Le systemDefault type d’activité est disponible uniquement dans l’aperçu public pour les développeurs.

  • Si vous souhaitez envoyer un modèle de notification en mode traditionnel, la activityTypes propriété doit être ajoutée dans la section activités . Pour plus d’informations, consultez Schéma du manifeste de l’application.
• L’application Teams doit être installée pour le destinataire personnellement ou dans une équipe ou une conversation dont il fait partie.

Autorisations

Utilisez les autorisations déléguées ou d’application pour envoyer des notifications de flux d’activités. Lorsque vous utilisez des autorisations d’application, nous vous recommandons d’utiliser le consentement spécifique à la ressource (RSC), car l’autorisation TeamsActivity.Send.User est consentie par l’utilisateur pour envoyer des notifications d’activité. Assurez-vous d’ajouter les autorisations RSC dans votre fichier manifeste d’application.

Mise à jour du manifeste de l’application

Cette section décrit les mises à jour qui doivent être ajoutées au manifeste de l’application. Assurez-vous d’utiliser la version du manifeste d’application ou une version 1.7 ultérieure.

"$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"
}

Mise à jour des activités

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

Mise à jour d’autorisation

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

Installer l’application Teams

Les applications Teams doivent être installées dans une équipe, une conversation ou pour un utilisateur dans l’étendue personnelle pour que les utilisateurs reçoivent des notifications de flux d’activité. Pour plus d’informations, consultez Méthodes de distribution des applications Teams. À des fins de développement, nous préférons le chargement d’applications personnalisées. Après le développement, vous pouvez choisir la méthode de distribution appropriée selon que vous souhaitez publier sur un client ou sur tous les clients.

Vous pouvez également utiliser les API d’installation d’applications Teams pour gérer les installations d’applications Teams.

Envoyer des notifications de flux d’activités aux utilisateurs

Étant donné qu’une application Teams peut être installée pour un utilisateur, dans une équipe ou dans une conversation, elle peut également envoyer des notifications dans les trois contextes suivants :

• Envoyer une notification à l’utilisateur dans une conversation
• Envoyer une notification à l’utilisateur dans une équipe
• Envoyer une notification à l’utilisateur

En outre, vous pouvez envoyer des notifications en bloc à 100 utilisateurs à la fois :

• Envoyer des notifications à plusieurs utilisateurs en bloc

Pour plus d’informations sur les rubriques prises en charge pour chaque scénario, reportez-vous aux API spécifiques. Les rubriques de texte personnalisées sont prises en charge pour tous les scénarios.

Vous pouvez utiliser la notification de flux d’activités dans les scénarios suivants :

• Informez les individus du contenu personnalisé qui requiert leur attention.
• Afficher le contenu enrichi dans l’onglet, l’application ou l’URL.
• Prendre en charge les interactions utilisateur complexes.
• Envoyez des notifications déléguées à partir de l’utilisateur qui a initié la notification.
• Put template dans le manifeste de l’application.
• Teams gère la localisation des notifications.

Personnaliser les notifications

Les utilisateurs de Teams peuvent personnaliser les notifications qu’ils voient dans leur flux ou sous forme de bannière. Les notifications générées via les API de flux d’activité peuvent également être personnalisées. Les utilisateurs peuvent choisir la manière dont ils sont notifiés via les paramètres de Teams. Les applications Teams apparaissent dans la liste que l’utilisateur peut choisir, comme illustré dans la capture d’écran suivante :

Les utilisateurs peuvent sélectionner Modifier en regard d’une application et personnaliser les notifications. Le manifeste de l’application affiche le description champ.

Exemples

Pour obtenir des exemples d’envoi d’une notification de flux d’activités, consultez Exemples d’envoi d’une notification de flux d’activités.

Type d’activité réservée pour l’envoi de notifications de flux d’activités

• Le systemDefault type d’activité est réservé et ne peut pas être utilisé dans le manifeste de l’application lors de l’ajout d’activités.
• Nous vous recommandons d’utiliser des notifications avec modèle, car elles dépendent des modèles d’activité dans le manifeste de l’application pour les lots de notifications périodiques et volumineux.
• Le systemDefault type d’activité réservée est disponible même si les autres types d’activité sont répertoriés dans le manifeste de votre application.

Voici les avantages et les limitations pour le type d’activité systemDefault :

Exemple de code

Guide pas à pas

Suivez le guide pas à pas pour envoyer des notifications de flux d’activités dans Teams.

Voir aussi

• Robot de notification dans Teams
• Conception de notifications de flux d’activités pour votre application Microsoft Teams