Créer un bot

Important

Cet article est basé sur le SDK v3 Bot Framework. Si vous recherchez la documentation actuelle version 4.6 ou ultérieure du SDK, consultez la section relative aux bots de conversation.

Tous les bots créés à l Microsoft Bot Framework sont configurés et prêts à fonctionner dans Microsoft Teams.

Pour plus d’informations, voir la documentation bot Framework pour obtenir des informations générales sur les bots.

Créer un bot dans Microsoft Teams

Teams App Studio est un outil qui peut vous aider à créer votre bot et un package d’application qui fait référence à votre bot. Elle contient également une bibliothèque de contrôle React et des exemples configurables pour les cartes. Pour plus d’informations, voir Mise en Teams App Studio. Les étapes qui suivent supposent que vous configurez manuellement votre bot et que vous n’utilisez pas Teams App Studio:

  1. Créez le bot à l’aide de ce lien : https://dev.botframework.com/bots/new . Veillez à ajouter Microsoft Teams sous la forme d’un canal à partir de la liste de chaînes proposées après avoir créé votre bot. N’hésitez pas à réutiliser tout ID d’application Microsoft que vous avez généré si vous avez déjà créé votre package d’application/manifeste.

    Page d’inscription de Bot Framework

Notes

Si vous ne souhaitez pas créer votre bot dans Azure, vous devez utiliser ce lien pour créer un bot https://dev.botframework.com/bots/new : Si vous cliquez sur Créer un bot dans le portail Bot Framework à la place, vous créerez votre bot dans Microsoft Azure à la place.

  1. Créez le bot à l’aide du package Microsoft.Bot.Connector.Teams NuGet, du SDK Bot Frameworkou de l’API Bot Connector.

  2. Testez le bot à l’aide Bot Framework Emulator.

  3. Déployez le bot sur un service cloud, tel que Microsoft Azure. Vous pouvez également exécuter votre application localement et utiliser un service de tunneling tel que ngrok pour exposer un point de terminaison https:// de votre bot, tel que https://45az0eb1.ngrok.io/api/messages .

Notes

Bots et Microsoft Azure

Depuis décembre 2017, le portail Bot Framework est optimisé pour l’inscription des bots dans Microsoft Azure. Voici quelques opérations que vous pouvez prendre en compte :

  • Le canal Microsoft Teams pour les bots inscrits sur Azure est gratuit. Les messages envoyés par le Teams ne sont pas comptabilisés dans les messages consommés pour le bot.
  • Bien qu’il soit possible de créer un bot Bot Framework sans utiliser Azure, vous devez utiliser cette URL ( qui n’est plus exposée dans le portail Bot https://dev.botframework.com/bots/new) Framework.
  • Lorsque vous modifiez les propriétés d’un bot existant dans la liste de vos bots dans Bot Framework, par exemple son « point de terminaison de messagerie », ce qui est courant lors du premier développement d’un bot, en particulier si vous utilisez ngrok,vous verrez la colonne « État de la migration » et un bouton bleu « Migrer » qui vous permettra d’entrer dans le portail Microsoft Azure. Ne cliquez pas sur le bouton « Migrer », sauf si c’est ce que vous voulez faire . Au lieu de cela, cliquez sur le nom du bot et vous pouvez modifier ses propriétés :
    Modifier les propriétés du bot
  • Si vous inscrivez votre bot à l’Microsoft Azure, votre code de bot n’a pas besoin d’être hébergé sur Microsoft Azure.
  • Si vous inscrivez un bot à l’aide du Portail Microsoft Azure, vous devez disposer d’un compte Microsoft Azure. Vous pouvez en créer un gratuitement. Pour vérifier votre identité lorsque vous en créez une, vous devez fournir une carte de crédit, mais elle ne sera pas facturée . Il est toujours gratuit de créer et d’utiliser des bots avec Microsoft Teams.
  • Vous pouvez désormais utiliser App Studio pour enregistrer/mettre à jour des informations d’application et de bot directement dans Microsoft Teams. Vous devez uniquement utiliser le portail Microsoft Azure pour ajouter ou configurer d’autres canaux Bot Framework tels que Direct Line, Web Chat, Skype et Facebook Messenger.

Voir aussi

Exemples Bot Framework.