Connecter un bot à Microsoft Teams

  • Article
  • 2 minutes de lecture

S’APPLIQUE À : Kit de développement logiciel (SDK) v4

Vous pouvez configurer votre bot pour communiquer avec des personnes via Microsoft Teams. Cet article explique comment créer une application Teams dans Teams, connecter votre bot à votre application Teams dans Azure, puis tester votre bot dans Teams.

Prérequis

  • Un abonnement Azure. Si vous n’en avez pas encore, créez un compte gratuit avant de commencer.
  • Un bot publié sur Azure que vous souhaitez vous connecter à Teams.
  • Un locataire de développeur dans Teams avec chargement d’application personnalisé ou chargement indépendant activé. Pour plus d’informations, consultez Préparer votre client Microsoft 365.
  • Package d’application Teams valide. Pour plus d’informations, consultez Charger votre application dans Microsoft Teams.

Configurer votre bot dans Azure

  1. Ouvrez le portail Azure.
  2. Ouvrez le panneau des ressources Azure Bot pour votre bot.
  3. Ouvrez les canaux et sélectionnez Microsoft Teams :
    1. Lisez et acceptez les conditions d’utilisation du service.
    2. Sous l’onglet Messagerie , sélectionnez l’environnement cloud de votre bot. Pour plus d’informations, consultez la section Post build of Plan your app with Teams features.
    3. Sélectionnez Appliquer.
  4. Sélectionnez Obtenir le code incorporé du bot, recherchez le code incorporé pour Teams, puis copiez la partie https du code. Par exemple : https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232. Vous pouvez utiliser ce code pour tester le bot dans Teams.

! [CONSEIL]

Tester votre bot dans Teams

Les bots en production doivent être ajoutés à Teams dans le cadre d’une application Teams. Pour plus d’informations, consultez Tester votre application.

Important

Il n’est pas recommandé d’ajouter un bot par GUID, sauf à des fins de test. Ceci limite fortement les fonctionnalités d’un bot. Les bots en production doivent être ajoutés à Teams dans le cadre d’une application.

  1. Dans votre navigateur, ouvrez l’URL que vous avez copiée à partir de votre code incorporé, puis choisissez l’application Microsoft Teams (client ou web) que vous utilisez pour ajouter le bot à Teams. Vous devriez être en mesure de voir le bot répertorié en tant que contact auquel vous pouvez envoyer des messages et recevoir des messages dans Microsoft Teams.
  2. Interagissez avec votre bot dans Teams.

Conseil

Utilisez une inscription de canal de bot par environnement, car votre point de terminaison change lorsque vous basculez entre les environnements de développement local, de préproduction et de production.

La suppression de l’inscription du canal Teams entraîne la génération d’une nouvelle paire de clés lorsqu’elle est réactivée. Cela invalide tous les ID 29:xxx et a:xxx que le bot a peut-être stockés pour la messagerie proactive.

Publier votre bot dans Teams

Pour obtenir des instructions sur la publication de votre application, consultez Distribuer votre application Microsoft Teams.

Informations supplémentaires