Connecter un bot à Microsoft Teams

  • Article

S’APPLIQUE À : SDK v4

Vous pouvez configurer votre bot de manière à communiquer avec des personnes sur Microsoft Teams. Le présent 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

Configurer votre bot dans Azure

  1. Ouvrez le portail Azure.
  2. Ouvrez le panneau de la ressource Azure Bot pour votre bot.
  3. Ouvrez Canaux, puis 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 en savoir plus, reportez-vous à la section Publier la version sous Planifiez votre application avec les fonctionnalités Teams.
    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 en savoir plus, reportez-vous à 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 voir le bot listé comme contact auquel vous pouvez envoyer des messages et duquel en recevoir 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 simulation 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. Cette action 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

Vous trouverez des instructions sur la publication de votre application dans un document qui présente une vue d’ensemble de la façon de distribuer votre application Microsoft Teams. Ce document et les articles associés expliquent comment :

  • Choisir et configurer les options d’installation pour votre bot
  • Créer le manifeste, l’icône et le package de votre application Teams
  • Charger votre application dans Teams
  • Publier votre application dans votre organisation ou dans le Teams Store

Informations supplémentaires