Lire en anglais Modifier

Partager via

Créer votre première application de bot à l’aide de JavaScript

Générer et exécuter votre première application de bot

Après avoir configuré votre espace de travail de projet avec Teams Toolkit, générez votre projet de bot. Vous devez vous connecter à votre compte Microsoft 365.

Connectez-vous à votre compte Microsoft 365

Utilisez ce compte pour vous connecter à Teams. Si vous utilisez un locataire du programme de développement Microsoft 365, le compte d’administrateur que vous avez configuré lors de l’inscription est votre compte Microsoft 365.

  1. Ouvrez Visual Studio Code.

  2. Sélectionnez l’icône Teams Toolkit dans la barre latérale.

  3. Sélectionnez Se connecter à M365 à l’aide de vos informations d’identification.

    Votre navigateur web par défaut s’ouvre pour vous permettre de vous connecter au compte.

  4. Fermez le navigateur lorsque vous y êtes invité et revenez à Visual Studio Code.

  5. Revenez à Teams Toolkit dans Visual Studio Code.

    Utilisez ce compte pour vous connecter à Teams. Si vous utilisez un locataire du programme de développement Microsoft 365, le compte d’administrateur que vous avez configuré lors de l’inscription est votre compte Microsoft 365.

    Capture d’écran montrant où se connecter à Microsoft 365 et Azure.

    Vous êtes maintenant prêt à générer l’application et à l’exécuter localement !

Créer et exécuter votre première application de bot localement

Pour générer et exécuter votre application dans l’environnement local :

  1. Sélectionnez F5 dans Visual Studio Code pour exécuter votre application en mode débogage.

    Notes

    Si teams Toolkit ne parvient pas à vérifier un prérequis particulier, il vous invite à vérifier.

    Découvrez ce qui se passe lorsque vous exécutez votre application localement dans le débogueur.

    Si vous vous demandez, lorsque vous appuyez sur la touche F5 , le Kit de ressources Teams :

    1. Vérifie tous les prérequis suivants :
    • Vous êtes connecté avec un compte Microsoft 365.
    • Le chargement d’applications personnalisées est activé pour votre compte Microsoft 365.
    • La version Node.js prise en charge est installée.
    • Le port requis par l’application de bot est disponible.
    1. Installez les packages npm.
    2. Démarre Dev Tunnel pour créer un tunnel HTTP.
    3. Inscrit l’application dans l’ID Microsoft Entra et configure l’application.
    4. Inscrit l’application bot dans Bot Framework et configure l’application bot.
    5. Inscrit l’application dans le portail des développeurs Teams et configure l’application.
    6. Démarre l’application bot.
    7. Démarre Teams dans un navigateur web et charge l’application bot personnalisée.

    Capture d’écran montrant quand la touche F5 est enfoncée pour le débogage.

    Notes

    Lorsque vous exécutez l’application pour la première fois, toutes les dépendances sont téléchargées et l’application est générée. Une fenêtre de navigateur s’ouvre automatiquement lors la build est terminée. Ce processus peut prendre trois à cinq minutes.

    Teams exécute votre application dans un navigateur web.

  2. Connectez-vous avec votre compte Microsoft 365, si vous y êtes invité.

  3. Sélectionnez Ajouter lorsque vous êtes invité à charger l’application bot personnalisée sur Teams sur votre ordinateur local ou utilisez le menu déroulant pour ajouter votre application bot à une équipe, une conversation ou une réunion.

    Capture d’écran montrant l’ajout du bot sur le client Teams.

    Maintenant, le bot s’exécute correctement sur Teams ! Une fois l’application chargée, une session de conversation avec le bot s’ouvre.

    Capture d’écran montrant le bot en cours d’exécution sur le client Teams.

    Vous pouvez taper welcome pour afficher une carte d’introduction et taper learn pour accéder à la documentation de la carte adaptative et des commandes de bot.

    Capture d’écran montrant la carte d’apprentissage dans le bot sur le client Teams.

    Vous pouvez effectuer des activités de débogage normales, telles que la définition de points d’arrêt, comme avec n’importe quelle autre application web. Ouvrez le fichier bot/teamsBot.js, puis localisez la méthode onMessage(). Définissez un point d’arrêt sur n’importe quel cas. Ensuite, tapez du texte.

Découvrez comment résoudre les problèmes si votre application ne s’exécute pas localement.

Pour exécuter correctement votre application dans Teams, vérifiez que vous avez activé le chargement d’applications personnalisées dans votre compte Teams. Vous pouvez en savoir plus sur le chargement d’applications personnalisées dans la section Conditions préalables.

Important

Le chargement d’applications personnalisées est disponible dans cloud de la communauté du secteur public (GCC), GCC-High et DOD.

Conseil

Vérifiez les problèmes avant de charger une application personnalisée à l’aide de l’outil de validation d’application. Cet outil est inclus dans le kit de ressources. Corrigez les erreurs de chargement de l’application.