Tester et déboguer votre bot Microsoft Teams

Lorsque vous testez votre bot, vous devez prendre en considération le ou les contextes dans lesquels vous souhaitez que votre bot s’exécute et toutes les fonctionnalités que vous avez ajoutées à votre bot qui nécessitent des données spécifiques à Microsoft Teams. Assurez-vous que la méthode que vous avez choisie pour tester votre bot s’aligne sur ses fonctionnalités.

Tester en chargeant dans Teams

La façon la plus complète de tester votre bot consiste à créer un package d’application et à le charger dans Teams. Le chargement de l’application dans Teams est la seule méthode pour tester toutes les fonctionnalités disponibles pour votre bot, dans toutes les étendues.

Il existe deux méthodes pour charger votre application. Vous pouvez utiliser le portail Développeur pour Teams ou créer manuellement un package d’application et charger votre application. Si vous devez modifier votre manifeste et recharger votre application, vous devez supprimer votre bot avant de charger votre package d’application modifié.

Déboguer votre bot localement

Si vous hébergez votre bot localement pendant le développement, vous devrez utiliser un service de tunneling comme ngrok afin de tester votre bot. Une fois que vous avez téléchargé et installé ngrok, exécutez la commande ci-dessous pour démarrer le service de tunneling. Vous devrez peut-être ajouter ngrok à votre chemin d’accès.

ngrok http <port> --host-header=localhost:<port>

Utilisez le point de terminaison https fourni par ngrok dans le manifeste de votre application. Si vous fermez votre fenêtre de commande et redémarrez, vous obtiendrez une nouvelle URL et vous devrez mettre à jour l’adresse de point de terminaison de votre bot pour utiliser également celle-ci.

Test de votre bot sans chargement dans Teams

Parfois, il est nécessaire de tester votre bot sans l’installer en tant qu’application dans Teams. Tester votre bot sans l’installer en tant qu’application peut être utile pour vous assurer que votre bot est disponible et répond, mais cela ne vous permettra pas de tester toute la gamme des fonctionnalités Teams que vous avez peut-être ajoutées à votre bot. Si vous devez tester complètement votre bot, suivez les instructions pour tester par téléchargement.

Utiliser l’émulateur de bot

L’émulateur Bot Framework Emulator est une application de bureau qui permet aux développeurs de bots de tester et de déboguer leurs bots, localement ou à distance. À l’aide de l’émulateur, vous pouvez discuter avec votre bot et inspecter les messages qu’il envoie et reçoit. Cela peut être utile pour vérifier que votre bot est disponible et répondre, mais l’émulateur ne vous permettra pas de tester les fonctionnalités spécifiques à Teams que vous avez ajoutées à votre bot, et les réponses de votre bot ne seront pas une représentation visuelle précise de la façon dont elles sont rendues dans Teams. Si vous avez besoin de tester l’une de ces choses, il n’est pas préférable de télécharger votre bot.

Vous trouverez des instructions complètes sur l’émulateur Bot Framework Emulator ici.

Blocage d’un bot dans la conversation personnelle

Les utilisateurs peuvent choisir d’empêcher votre bot d’envoyer des messages de conversation personnels. Ils peuvent basculer cela en cliquant avec le bouton droit sur votre bot dans le canal de conversation et en choisissant Bloquer la conversation du bot. Cela signifie que vos bots continueront à envoyer des messages, mais que l’utilisateur ne recevra pas ces messages.

Suppression d’un bot d’une équipe

Les utilisateurs peuvent supprimer le bot en choisissant l’icône de corbeille dans la liste des bots dans leur vue Teams. Notez que cela supprime uniquement le bot de l’utilisation de cette équipe, les utilisateurs individuels peuvent interagir dans un contexte personnel.

Dans un contexte personnel, les bots ne peuvent pas être désactivés ou supprimés par un utilisateur, sauf si vous supprimez complètement le bot de Teams.

Désactiver un bot dans Teams

Pour arrêter de recevoir des messages à votre bot, accédez à votre tableau de bord bot et modifiez le canal Microsoft Teams. Désactivez l’option Activer sur Microsoft Teams . La désactivation d’un bot dans Teams empêche les utilisateurs d’interagir avec le bot, mais il sera toujours détectable et les utilisateurs pourront l’ajouter à Teams.

Suppression d’un bot de Teams

Pour supprimer complètement votre bot de Teams, accédez à votre tableau de bord de bot et modifiez le canal Microsoft Teams. Cliquez sur le bouton Supprimer en bas. La suppression d’un bot de Teams empêche les utilisateurs de le découvrir, d’y ajouter ou d’interagir avec lui. La suppression d’un bot de Teams ne le supprime pas des instances Teams d’autres utilisateurs, bien qu’il cesse également de fonctionner pour eux.

Suppression de votre bot d’AppSource

Si vous souhaitez supprimer votre bot de votre application Teams dans AppSource (précédemment Office Store), vous devez supprimer le bot de votre manifeste d’application et soumettre à nouveau votre application pour validation. Pour plus d’informations, reportez-vous à la rubrique Publier votre application Microsoft Teams sur AppSource.