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

Le flux d’activité 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. Cela permet à vos applications de fournir des expériences plus riches et de mieux impliquer les utilisateurs en les aidant à rester à jour avec les modifications apportées aux outils et flux de travail qu’ils utilisent.

Cas d’usage des notifications de flux d’activité

• Actualités : aide les utilisateurs à rester à jour avec les informations les plus récentes, telles que de nouvelles affectations ou de nouveaux billets.
• 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 : 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, qui nécessitent une attention urgente ou immédiate. Par exemple, la date d’échéance d’une formation est dé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é

• La notification de flux d’activité est une intégration native de Teams qui amène l’utilisateur en toute transparence dans l’application Tab, ce qui apporte un engagement utilisateur supplémentaire de l’activité à votre application.
• La notification de flux d’activité est fournie avec une notification du système d’exploitation dans les clients de bureau et mobiles Teams, afin que l’attention de l’utilisateur soit attirée par la fenêtre contextuelle et le son du système.
• 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 lier en profondeur votre application à une notification afin que lorsqu’un utilisateur sélectionne la notification, elle augmente l’engagement de l’application utilisateur.
• Vous pouvez envoyer une notification de flux d’activité à différents destinataires. Par exemple, l’envoi d’une notification personnelle ou l’envoi de notifications par lots à un groupe d’utilisateurs.
• La localisation du manifeste d’application (précédemment appelée manifeste d’application Teams) prend en charge le texte modèle dans les notifications de flux d’activité.

Comprendre les principes de base des notifications de flux d’activité

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

Les composants sont les suivants :

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

Types de cartes de notification de flux d’activité

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 utilisateur pour les notifications générées par l’application :

Conditions requises pour utiliser les API de notification de flux d’activité

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

• Le manifeste de l’application doit avoir l’ID d’application Microsoft Entra ajouté à la webApplicationInfo section. Pour plus d’informations, consultez Schéma de manifeste d’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 de forme libre dans la Actor+Reason ligne de la notification de flux d’activité. Pour plus d’informations, consultez Envoyer des notifications de flux d’activité personnalisables.

    Remarque

    Le systemDefault type d’activité est disponible uniquement dans la préversion publique pour les développeurs.

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

Autorisations

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

Mise à jour du manifeste d’application

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

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

Mise à jour webApplicationInfo

"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 des autorisations

"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 qu’un utilisateur dans l’étendue personnelle puisse recevoir des notifications de flux d’activité. Pour plus d’informations, consultez Méthodes de distribution d’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 locataire ou sur tous les locataires.

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é 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 à jusqu’à 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 textuelles personnalisées sont prises en charge pour tous les scénarios.

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

• Informez les individus du contenu personnalisé qui nécessite leur attention.
• Afficher le contenu enrichi dans l’application Tab ou l’URL.
• Prendre en charge les interactions utilisateur complexes.
• Envoyer des notifications déléguées de l’utilisateur qui a lancé la notification.
• Placez le modèle 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 façon dont ils sont avertis via les paramètres dans Teams. Les applications Teams apparaissent dans la liste pour l’utilisateur, 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 sur la façon d’envoyer une notification de flux d’activité, consultez Exemples de notification de flux d’activité.

Type d’activité réservée pour envoyer des notifications de flux d’activité

• 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 de modèles d’activité dans le manifeste de l’application pour les lots récurrents et volumineux de notifications.
• 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 du type d’activité systemDefault :

Exemple de code

Guide pas à pas

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

Voir aussi

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