Envoyer des messages proactifs
Un message proactif est un message envoyé par un bot en réponse à des commandes simples envoyées dans la conversation par un utilisateur. La réponse au message peut être dans l’un des formats suivants :
- Les messages de bienvenue
- Messages planifiés
- Notifications
Ce guide pas à pas vous aide à envoyer un message proactif à partir d’un bot. Vous verrez la sortie suivante :
Configuration requise
Veillez à installer les outils suivants pour générer et déployer vos applications.
Installer | Pour utiliser | |
---|---|---|
Microsoft Visual Studio Code | JavaScript ou TypeScript, environnements de build. Utilisez la dernière version. | |
Kit de ressources Microsoft Teams | Extension Visual Studio Code qui crée une structure de projet pour votre application. Utilisez la dernière version. | |
Node.js | Environnement runtime JavaScript principal. Pour plus d’informations, consultez Node.js table de compatibilité des versions pour le type de projet. | |
Microsoft Teams | Teams pour collaborer avec toutes les personnes avec lesquelles vous travaillez via des applications pour la conversation, les réunions, les appels et le tout au même endroit. | |
Microsoft Edge (recommandé) ou Google Chrome | Un navigateur avec des outils de développement. | |
Compte de développeur Microsoft 365 | Accès au compte Teams avec les autorisations appropriées pour installer une application. |
Préparer l’environnement de développement
Après avoir installé les outils requis, configurez l’environnement de développement.
Installer teams Toolkit
Le Kit de ressources Microsoft Teams permet de simplifier le processus de développement avec des outils permettant de provisionner et de déployer des ressources cloud pour votre application et de les publier dans le Magasin Teams.
Vous pouvez utiliser Teams Toolkit avec Visual Studio Code ou une interface de ligne de commande appelée Cli TeamsFx.
Ouvrez Visual Studio Code et sélectionnez Extensions (Ctrl+Maj+X ou Afficher les>extensions).
Dans la zone de recherche, entrez Teams Toolkit.
Sélectionnez Installer.
L’icône Teams Toolkit s’affiche dans la barre d’activité de Visual Studio Code.
Vous pouvez également installer Teams Toolkit à partir de la Place de marché Visual Studio Code.
Configurer votre locataire de développement Teams
Un locataire est un espace ou un conteneur pour votre organisation dans Teams, où vous discutez, partagez des fichiers et exécutez des réunions. Cet espace est également l’endroit où vous chargez et testez votre application. Vérifions si vous êtes prêt à développer avec le locataire.
Rechercher l’option charger une application
Après avoir créé votre application personnalisée, vous devez charger votre application dans Teams avec l’option Charger une application personnalisée . Connectez-vous à votre compte Microsoft 365 pour vérifier si cette option est activée.
Les étapes suivantes vous aident à vérifier si vous pouvez charger des applications dans Teams :
Dans le client Teams, sélectionnez l’icône Applications .
Sélectionnez Gérer vos applications.
Sélectionnez Charger une application.
Recherchez l’option Charger une application personnalisée. Si l’option est visible, vous pouvez charger des applications personnalisées.
Remarque
Si vous ne trouvez pas la possibilité de charger une application personnalisée, contactez votre administrateur Teams.
Créer un locataire développeur Teams gratuit (facultatif)
Si vous n’avez pas de compte de développeur Teams, rejoignez le programme de développement Microsoft 365.
Sélectionnez Rejoindre maintenant et suivez les instructions à l’écran.
Dans l’écran d’accueil, sélectionnez Configurer l’abonnement E5.
Configurez votre compte d’administrateur. Une fois que vous avez terminé, l’écran suivant s’affiche :
Connectez-vous à Teams à l’aide du compte d’administrateur que vous venez de configurer. Vérifiez que vous disposez de l’option Charger une application personnalisée dans Teams.
Créer un bot de messages proactifs
Pour créer un bot de messages proactif à l’aide de Visual Studio Code, procédez comme suit :
Ouvrez Visual Studio Code.
Sélectionnez l’icône Teams Toolkit dans la barre d’activité de Visual Studio Code.
Dans le volet gauche, sélectionnez Afficher les exemples.
Dans la liste des exemples, sélectionnez Messagerie proactive. Un exemple prédéfini prêt pour le débogage s’ouvre.
Sélectionnez Créer.
Sélectionnez Dossier par défaut pour stocker le dossier racine de votre projet à l’emplacement par défaut.
Si vous souhaitez modifier l’emplacement par défaut, procédez comme suit :
Sélectionnez Parcourir.
Sélectionnez l’emplacement de l’espace de travail du projet.
Sélectionnez Sélectionner un dossier.
Le bot de messages proactifs est créé en quelques secondes et affiche la boîte de dialogue réussite du bot de messages proactifs dans le coin inférieur droit avec l’option de débogage :
Sélectionnez l’icône Exécuter et déboguer dans le coin supérieur gauche.
Sélectionnez Déboguer (Edge) ou Déboguer (Chrome) dans la liste déroulante.
Une fois le débogage réussi, vous êtes invité à charger le bot de messages proactifs dans Teams sur votre ordinateur local.
Dans la liste déroulante en regard de Ajouter, sélectionnez Ajouter à une équipe ou Ajouter à une conversation ou Ajouter à une réunion.
Entrez le nom d’une conversation ou d’une équipe dans le champ de recherche, puis sélectionnez Configurer un bot.
L’application de bot de messagerie proactive est chargée sur le client Teams et le message suivant s’affiche en réponse au message envoyé.
Copiez et collez l’URL ou accédez à l’URL dans le navigateur. Un message hello proactif est déclenché et partagé dans la conversation.
Accédez à Teams. Vous recevrez un message hello proactif du bot.
Suivre une visite guidée du code source
Teams Toolkit fournit des composants pour la création d’une application. Après avoir créé le projet, vous pouvez afficher les dossiers et fichiers du projet dans la zone EXPLORATEUR de Visual Studio Code.
Le nouveau dossier de projet contient le contenu suivant :
Dossier / Fichier | Sommaire |
---|---|
.vscode/ |
Fichiers Visual Studio Code pour le débogage. |
appManifest/ |
Modèles pour le manifeste d’application (précédemment appelé manifeste d’application Teams). |
env/ |
Les paires nom/valeur sont stockées dans des fichiers d’environnement et utilisées par teamsapp.yml pour personnaliser les règles d’approvisionnement et de déploiement. |
manifest.json |
Le manifeste d’application pour la publication via le portail des développeurs pour Teams est stocké dans Properties/manifest.json . |
teamsapp.yml |
Le fichier projet principal décrit la configuration de votre application et définit l’ensemble des actions à exécuter à chaque étape du cycle de vie. |
teamsapp.local.yml |
Cela remplace par des teamsapp.yml actions qui activent l’exécution et le débogage locaux. |
Déployer votre bot de messagerie proactive
Vous avez appris à créer et à exécuter une application Teams avec la fonctionnalité de bot de message proactif. Déployons la première application avec la fonctionnalité de bot de messagerie proactive sur Azure à l’aide du Kit de ressources Teams.
Connectez-vous à votre compte Azure
Utilisez votre compte pour accéder au portail Microsoft Azure et provisionner de nouvelles ressources cloud pour prendre en charge votre application.
Ouvrez Visual Studio Code.
Ouvrez le dossier du projet dans lequel vous avez créé l’application de bot de messages proactifs.
Sélectionnez l’icône Teams Toolkit dans la barre d’activité de Visual Studio Code.
Sélectionnez Se connecter à Azure à l’aide de vos informations d’identification.
Conseil
Si vous avez installé l’extension AZURE ACCOUNT et que vous utilisez le même compte, vous pouvez ignorer cette étape.
Votre navigateur web par défaut s’ouvre pour vous permettre de vous connecter au compte.
Fermez le navigateur lorsque vous y êtes invité et revenez à Visual Studio Code.
La section COMPTES de la barre latérale affiche les deux comptes séparément. Il répertorie également le nombre d’abonnements Azure utilisables disponibles. Vérifiez que vous disposez d’au moins un abonnement Azure utilisable. Si ce n’est pas le cas, déconnectez-vous et utilisez un autre compte.
Déployer votre application vers Azure
Le déploiement se compose de deux étapes. Tout d’abord, les ressources cloud nécessaires sont créées (également appelées approvisionnement). Ensuite, le code de votre application est copié dans les ressources cloud créées. Pour ce tutoriel, vous allez déployer l’application bot.
Quelle est la différence entre provisionner et déployer ?
Provisionner crée des ressources dans Azure et Microsoft 365 pour votre application, mais aucun code (HTML, CSS et JavaScript) n’est copié dans les ressources. Le déploiement copie le code de votre application sur les ressources que vous avez créées lors de l’approvisionnement. Il est courant de déployer plusieurs fois sans provisionner de nouvelles ressources. Étant donné que l’approvisionnement peut prendre un certain temps, il est distinct du déploiement.
Sélectionnez l’icône Teams Toolkit dans la barre d’activité de Visual Studio Code.
Sélectionnez Provisionner sous CYCLE DE VIE.
Sélectionnez l’un des abonnements existants.
Sélectionnez un groupe de ressources existant ou créez-en un. Pour plus d’informations, consultez Créer un groupe de ressources.
Remarque
Une boîte de dialogue s’affiche, indiquant que des coûts peuvent être induits lors de l’exécution de ressources dans Azure.
Sélectionnez Provisionner.
Le processus d’approvisionnement crée des ressources dans le cloud Azure. Vous pouvez surveiller la progression dans les boîtes de dialogue qui s’affichent dans le coin inférieur droit. Après quelques minutes, la boîte de dialogue suivante s’affiche :
Sélectionnez Déployer sous CYCLE DE VIE.
Sélectionnez Déployer.
Le déploiement prend un certain temps. Vous pouvez surveiller la progression dans les boîtes de dialogue qui s’affichent dans le coin inférieur droit. Après quelques minutes, la boîte de dialogue suivante s’affiche.
Ouvrez le panneau de débogage (Ctrl+Maj+D / ⌘⇧-D ou Afficher>l’exécution) à partir de Visual Studio Code.
Sélectionnez Lancer à distance (Edge) dans la liste déroulante configuration de lancement.
Une fois le débogage réussi, vous êtes invité à charger l’application de bot de messagerie proactive dans Teams.
Dans la liste déroulante en regard de Ajouter, sélectionnez Ajouter à une équipe ou Ajouter à une conversation ou Ajouter à une réunion.
Entrez le nom d’une conversation ou d’une équipe dans le champ de recherche, puis sélectionnez Configurer un bot.
L’application de bot de messagerie proactive est chargée sur le client Teams et le message suivant s’affiche en réponse au message envoyé.
Copiez et collez l’URL ou accédez à l’URL dans le navigateur. Un message hello proactif est déclenché et partagé dans la conversation.
Accédez à Teams. Vous recevrez un message hello proactif du bot.
Relever le défi
Tu as trouvé quelque chose comme ça ?
Félicitations !
Vous avez terminé le scénario.
- Vous pouvez envoyer des notifications quotidiennement ou demander des commentaires aux utilisateurs régulièrement.
- Vous pouvez gérer les limites de limitation pour éviter plusieurs notifications.
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.