Envoyer une notification de flux d’activité
Le flux d’activité Microsoft Teams aide les utilisateurs à évaluer les éléments qui nécessitent une attention en notifiant les modifications. Vous pouvez appliquer en utilisant les API de notification de flux d’activité dans Microsoft Graph pour étendre les fonctionnalités à votre application.
Principales fonctionnalités de la diffusion de flux d’activité
- Offre une expérience améliorée.
- Maintient les utilisateurs à jour.
- Diffuse le message pour tous les membres.
- Affiche une notification de flux d’activité.
- Diffuse les détails disponibles pour les membres.
Ce guide pas à pas vous aide à diffuser des messages et à informer tous les membres d’une organisation à l’aide de la notification de flux d’activité. Vous verrez la sortie suivante :
Configuration requise
Veillez à installer les outils suivants et à configurer votre environnement de développement :
| Installer | Pour l’utilisation... | |
|---|---|---|
| Obligatoire | ||
| Visual Studio 2022 version 17.3 Installez l’une des deux charges de travail suivantes : • développement ASP.NET et web • Développement multiplateforme .NET Core |
Vous pouvez installer la version entreprise dans Visual Studio 2022 et installer les charges de travail. | |
| SDK .NET Core version 3.1 | Liaisons personnalisées pour le débogage local et les déploiements d’applications Azure Functions. Si vous n’avez pas installé le SDK .NET 3.1 (ou version ultérieure) globalement, la version portable peut être installée. | |
| ngrok | Les fonctionnalités d’application Teams (bots conversationnels, extensions de message et webhooks entrants) nécessitent des connexions entrantes. Un tunnel connecte votre système de développement à Teams. Elle n’est pas obligatoire pour les applications qui incluent uniquement des onglets. Ce package est installé dans le répertoire du projet (à l’aide de npm devDependencies). |
Remarque
Après avoir téléchargé ngrok, inscrivez-vous et installez authtoken.
Vérifiez que vous disposez des comptes suivants et configurez votre environnement de développement :
- Compte Microsoft .
- L’application Teams doit être installée pour le destinataire, soit personnellement, soit dans une équipe ou une conversation.
- L’ID de locataire pour l’envoi et la réception des notifications doit correspondre.
Configurer votre locataire de développement Teams
Un locataire est comme un espace ou un conteneur dans lequel vous discutez, partagez des fichiers et exécutez des réunions pour votre organisation dans Teams. Vous pouvez également charger et tester l’application.
Rechercher l’option de chargement indépendant
Après avoir créé l’application, vous devez charger votre application dans Teams sans la distribuer. La fonction est appelée chargement indépendant. Connectez-vous à votre compte Microsoft 365 pour afficher cette option.
Remarque
Le chargement indépendant est nécessaire pour l’aperçu et le test des applications dans l’environnement local Teams. Activez le chargement indépendant pour afficher un aperçu et tester votre application dans Teams localement.
Avez-vous déjà un locataire et disposez-vous de l’accès administrateur ? Vérifions si vous le faites vraiment !
Pour vérifier le chargement indépendant des applications dans Teams :
Dans le client Teams, sélectionnez Stocker.
Sélectionnez Gérer vos applications.
Sélectionnez Charger une application.
Recherchez l’option Charger une application personnalisée. Si vous voyez l’option , le chargement indépendant des applications est activé.
Remarque
Si vous ne pouvez pas charger une application personnalisée, contactez l’administrateur Teams.
Créer un locataire développeur Teams gratuit (facultatif)
Si vous n’avez pas de compte de développeur Teams, vous pouvez l’obtenir gratuitement. Rejoignez le programme des développeurs Microsoft 365 !
Sélectionnez Rejoindre maintenant et suivez les instructions à l’écran.
Sélectionnez Configurer l’abonnement E5 dans l’écran d’accueil.
Configurer un compte d’administrateur. Une fois que vous avez terminé, l’écran suivant s’affiche.
Connectez-vous à Teams à l’aide du nouveau compte d’administrateur. Vous pouvez maintenant sélectionner Charger une application personnalisée.
Configurer l’environnement local
Ouvrez Exemples Microsoft Teams.
Sélectionnez Code.
Dans le menu déroulant, sélectionnez Ouvrir avec GitHub Desktop.
Sélectionnez Cloner.
Inscrire votre authentification unique Teams Auth auprès d’Azure AD
Les étapes suivantes vous aident à créer et à inscrire l’authentification unique Teams dans Portail Azure :
- Créer et inscrire une application sous inscriptions d'applications
- Utiliser ngrok pour créer un tunnel vers les points de terminaison de votre serveur web
Pour créer et inscrire une application
Accédez au Portail Azure. Le système vous invite à vous connecter avec les informations d’identification de votre compte Microsoft
Sélectionnez Azure Active Directory.
Dans le volet de navigation de gauche, sélectionnez Inscriptions d’applications.
Sélectionnez Nouvelle inscription.
La page Inscrire une application s’affiche.
Entrez les informations suivantes pour inscrire une application.
- Définissez Nom sur le nom de votre application
- Définissez Types de comptes pris en charge sur n’importe quel type de compte
- Laissez l’URI de redirection vide
Sélectionnez Inscrire.
La page Vue d’ensemble de l’application s’affiche.
Importante
Enregistrez l’ID d’application (client) et l’IDd’annuaire (locataire) pour référence ultérieure.
Pour créer un tunnel pour le serveur web local
Utilisez ngrok ou l’invite de commandes pour créer un tunnel vers les points de terminaison HTTPS de votre serveur web en cours d’exécution localement. Exécutez la commande suivante dans ngrok :
ngrok http --host-header=localhost 3978
Conseil
Si vous rencontrez ERR_NGROK_4018, suivez les étapes fournies dans l’invite de commandes pour vous inscrire et authentifier ngrok. Exécutez ensuite la commande ngrok http --host-header=localhost 3978.
Mettre à jour l’inscription de l’application Azure AD
Dans le volet de navigation de gauche, sélectionnez Exposer une API.
Sélectionnez Définir.
Définissez l’URI de l’ID d’application sous la forme .
api://{AppID}
Insérez la
WebAppDomainvaleur entreapi://et/{AppID}.api:// your ngrok/{AppID}L’image suivante montre le nom de domaine :
Remarque
Si vous utilisez un service de tunneling tel que ngrok, veillez à mettre à jour la valeur chaque fois que votre sous-domaine ngrok change.
For example: api://f631****.ngrok.io/c4e88a5d-e3d4-47f4-accb-0ef9de3bce8a, oùf631****.ngrok.ioest le nouveau nom de sous-domaine ngrok.Sélectionnez Ajouter une étendue.
Ajouter une page d’étendue s’affiche.
Entrez les détails de la configuration de l’étendue.
- Entrez
access_as_usercomme nom de l’étendue.
Remarque
Le nom de l’étendue doit correspondre à l’URI d’ID d’application avec
/access_as_userajouté à la fin.api://bff2****.ngrok.io/00000000-0000-0000-0000-000000000000/access_as_user.Définissez Qui peut donner votre consentement sur
Admins and users.Pour configurer les invites de consentement de l’administrateur et de l’utilisateur avec les valeurs appropriées pour
access_as_userl’étendue, fournissez les informations suivantes dans les champs :Entrez
Teams can access the user’s profileen tant que nom d’affichage de consentement AdministrationEntrer
Allows Teams to call the app’s web APIs as the current usercomme Administration description du consentementEntrez
Teams can access the user profile and make requests on the user’s behalfcomme nom d’affichage du consentement de l’utilisateurEntrer comme
Enable Teams to call this app’s APIs with the same rights as the userdescription du consentement de l’utilisateur
Vérifiez que State est défini comme Enabled.
Sélectionnez Ajouter une étendue à enregistrer.
L’URI de votre ID d’application est créé avec le nom de l’étendue.
- Entrez
Dans la section Applications clientes autorisées, identifiez les applications que vous souhaitez autoriser pour l'application Web de votre application.
Sélectionnez Ajouter une application cliente.
Le panneau Ajouter une application cliente s’affiche.
Entrez séparément l’ID client pour le bureau et l’application web que vous souhaitez autoriser. Il s’agit de l’ID d’application de l’application cliente que vous souhaitez autoriser.
ID du client Pour l’autorisation 1fec8e78-bce4-4aaf-ab1b-5451cc387264Application de bureau ou mobile Teams 5e3ce6c0-2b1f-4285-8d4b-75ee78787346Application Teams web Sélectionnez Étendues autorisées pour déterminer le type de jeton retourné par le service.
L’image suivante affiche l’ID client :
Dans le volet gauche, sélectionnez Autorisations d’API.
Remarque
Les utilisateurs doivent donner leur consentement à ces autorisations uniquement si l’application Azure AD est inscrite dans un autre locataire.
Sélectionnez Ajouter une autorisation.
La page Demander l’autorisation de l’API s’affiche.
Sélectionnez Microsoft Graph.
Sélectionnez Autorisations déléguées.
Ajoutez les autorisations suivantes :
- Directory.Read.All
- Directory.ReadWrite.All
- TeamsActivity.Send
- TeamsAppInstallation.ReadForUser
- TeamsAppInstallation.ReadWriteForUser
- User.Read
Remarque
Utilisateur. La lecture est activée par défaut.
Sélectionnez Ajouter des autorisations.
Sélectionnez Ajouter une autorisation.
Sélectionnez Microsoft Graph.
Sélectionnez Autorisations d’application.
Ajoutez les autorisations suivantes :
- Directory.Read.All
- TeamsActivity.Send
- TeamsAppInstallation.ReadForUser.All
Sélectionnez Ajouter des autorisations.
Veillez à accorder le consentement administrateur pour les autorisations requises.
Dans le volet gauche, sélectionnez Authentification pour définir un URI de redirection.
Remarque
Si une application ne reçoit pas le consentement de l’administrateur informatique, les utilisateurs doivent fournir le consentement la première fois qu’ils utilisent une application.
Sélectionnez Ajouter une plateforme.
Pour ce didacticiel, sélectionnez Web.
Entrez l’URI de redirection de votre application en ajoutant
Auth/endau nom de domaine complet :https://ngrok.io/Auth/endActivez l’octroi implicite et les flux hybrides en cochant les cases suivantes :
- Jetons d’ID
- Jetons d’accès
Sélectionnez Configurer.
Sélectionnez Ajouter un URI et entrez
https://ngrok.io/Auth/Start.Sélectionnez Enregistrer.
Pour créer une clé secrète client
Dans le volet gauche, sélectionnez Certificats & secrets.
Dans la section Clés secrètes client , sélectionnez Nouvelle clé secrète client.
La fenêtre Ajouter une clé secrète client s’affiche.
Entrez une valeur dans Description.
Sélectionnez Ajouter.
Dans la colonne Valeur , sélectionnez Copier dans le Presse-papiers.
Importante
Enregistrez la valeur Des secrets client ou le mot de passe de l’application pour référence ultérieure.
Configurer les paramètres d’application et les fichiers manifestes
Accédez à appsettings.json dans le référentiel cloné.
Ouvrez appsettings.json dans la dernière version de Visual Studio et mettez à jour les informations suivantes :
- Définissez sur
"MicrosoftAppId"l’ID d’application Microsoft de votre bot. - Définissez sur
"TenantID"ID de répertoire (locataire). - Définissez sur
"MicrosoftAppPassword"la valeur de l’ID de clé secrète client de votre bot. - Définissez
"BaseUrl"sur .[WebAppDomainName]
- Définissez sur
Accédez à manifest.json dans le référentiel cloné.
Ouvrez manifest.json dans la dernière version de Visual Studio et apportez les modifications suivantes :
- Remplacez toutes les occurrences de
<<Microsoft-App-ID>>par l’ID d’application Microsoft de votre bot. - Remplacez toutes les occurrences de par votre nom de
<<Base_URL>>domaine complet. - Définissez sur
validDomains[WebAppDomainName].
- Remplacez toutes les occurrences de
Générer et exécuter le service
Ouvrez Visual Studio.
Accédez à Fichier>Ouvrir le>projet/la solution.
Sélectionnez ActivityFeedBroadcast.sln file (Fichier ActivityFeedBroadcast.sln) dans le dossier csharp .
Sélectionnez Ouvrir.
Appuyez sur F5 pour exécuter le projet.
Sélectionnez Oui si la boîte de dialogue suivante s’affiche :
Une page web s’ouvre avec un message . Votre bot est prêt !
Ajouter une application de diffusion de flux d’activité à Teams
Dans votre dépôt cloné, accédez à graph-activity-feed-broadcast>csharp>ActivityFeedBroadcast>AppPackage.
Créez un .zip avec les fichiers suivants présents dans le dossier AppPackage :
- manifest.json
- icon-outline.png
- icon-color.png
Accédez au client Teams .
Sélectionner les applications.
Sélectionnez Gérer vos applications.
Sélectionnez Charger une application dans le catalogue d’applications de votre organisation.
Sélectionnez Ouvrir pour charger le fichier .zip que vous avez créé dans le dossier AppPackage .
Sélectionnez Ajouter.
L’application est visible dans le SidePanel de la réunion.
Interagir avec l’application dans Teams
Interagissons avec l’application dans Teams !
BroadcastTab affiche le titre du message et la description du message.
Entrez le titre et la description du message, puis sélectionnez Envoyer un message.
Le message diffusé avec succès s’affiche.
La notification de flux d’activité s’affiche sous l’onglet Activité du destinataire avec le même ID de locataire.
Les détails du message s’affichent lors de la sélection du message.
Relever le défi
Tu as trouvé quelque chose comme ça ?
Félicitations !
Vous avez terminé le tutoriel pour commencer à utiliser l’application de diffusion de flux d’activité !
Vous avez un défi avec cette section ? Si c'est le cas, faites-nous part de vos commentaires pour que nous puissions l'améliorer.
Commentaires
Envoyer et afficher des commentaires pour