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 à avertir tous les membres d’un organization à 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... | |
---|---|---|
Visual Studio 2022 version 17.3 | Vous pouvez installer la version entreprise dans Visual Studio 2022 et installer les charges de travail de développement ASP.NET et web. Utilisez la dernière version. | |
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 à installer. | |
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 où vous discutez, partagez des fichiers et exécutez des réunions pour votre organization dans Teams. Vous pouvez également charger et tester l’application personnalisée.
Rechercher l’option de chargement d’application personnalisée
Après avoir créé l’application, vous devez charger votre application dans Teams sans la distribuer. La fonction est appelée chargement d’application personnalisée. Connectez-vous à votre compte Microsoft 365 pour afficher cette option.
Remarque
Le chargement d’applications personnalisées est nécessaire pour afficher un aperçu et tester les applications dans l’environnement local Teams. Activez le chargement d’applications personnalisées 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 ? Nous allons case activée si vous le faites vraiment !
Pour vérifier les applications de chargement personnalisées dans Teams :
1. In the Teams client, select the **Apps** icon.
1. Select **Manage your apps**.
1. Select **Upload an app**.
1. Look for the option to **Upload a custom app**.
:::image type="content" source="~/assets/images/teams-toolkit-v2/prerequisites/upload-app.png" alt-text="Screenshot shows the custom upload app in Teams.":::
> [!NOTE]
> Contact Teams administrator, if you can't upload a custom app.
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 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 avec l’ID Microsoft Entra
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 Microsoft Entra ID.
Dans le volet de navigation 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électionner Inscription.
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 Microsoft Entra
Dans le volet de navigation gauche, sélectionnez Exposer une API.
Sélectionnez Ajouter.
Définissez l’URI de l’ID d’application sous la forme .
api://{AppID}
Insérez la
WebAppDomain
valeur 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.io
est 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_user comme nom de l’étendue.
Remarque
Le nom de l’étendue doit correspondre à l’URI d’ID d’application avec
/access_as_user
ajouté à la fin.api://bff2****.ngrok.io/00000000-0000-0000-0000-000000000000/access_as_user
.Définissez Qui peut donner son consentement aux administrateurs et aux utilisateurs.
Pour configurer les invites de consentement de l’administrateur et de l’utilisateur avec les valeurs appropriées pour access_as_user’étendue , fournissez les informations suivantes dans les champs :
Entrez Teams peut accéder au profil de l’utilisateur en tant que nom d’affichage de consentement Administration
Entrez Autoriser Teams à appeler les API web de l’application en tant qu’utilisateur actuel Administration description du consentement
Entrez Teams peut accéder au profil utilisateur et effectuer des demandes au nom de l’utilisateur en tant que nom d’affichage du consentement de l’utilisateur
Entrez Activer Teams pour appeler les API de cette application avec les mêmes droits que l’utilisateur comme description 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.
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 volet 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-5451cc387264
Application de bureau ou mobile Teams 5e3ce6c0-2b1f-4285-8d4b-75ee78787346
Application Teams web Sélectionnez Étendues autorisées pour déterminer quel type de jeton retourne 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 Microsoft Entra 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/end
au nom de domaine complet :https://ngrok.io/Auth/end
Activez 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 au fichier appsettings.json dans le référentiel cloné.
Ouvrez le fichier 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 au fichier manifest.json dans le référentiel cloné.
Ouvrez le fichier manifest.json dans la dernière version de Visual Studio et apportez les modifications suivantes :
- Remplacez toutes les occurrences de par
<<Microsoft-App-ID>>
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 par
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 fichier .zip avec les fichiers suivants présents dans le dossier AppPackage :
- manifest.json
- outline.png
- color.png
Accédez à Microsoft Teams.
Sélectionnez Applications>Gérer vos applications.
Sélectionnez Envoyer une application à 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
https://aka.ms/ContentUserFeedback.
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez :Envoyer et afficher des commentaires pour