Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Cet article est basé sur le SDK Bot Framework v3.
- Si vous souhaitez créer un bot IA, consultez créer un bot IA.
- Si vous souhaitez créer un bot de base, reportez-vous à la section Mise en route, et si vous souhaitez rechercher la version 4.6 ou ultérieure de la documentation actuelle du Kit de développement logiciel (SDK), reportez-vous à la section Robots conversationnels.
Créez et connectez des robots intelligents pour interagir naturellement avec les utilisateurs de Microsoft Teams via la conversation. Ou fournissez un robot simple basé sur des commandes, à utiliser comme interface de « ligne de commande » pour votre expérience d’application Teams plus large. Vous pouvez créer un bot de notification uniquement, qui peut leur envoyer directement des informations pertinentes pour vos utilisateurs dans un canal ou un message direct. Vous pouvez même utiliser votre bot existant basé sur Bot Framework et ajouter un support spécifique à Teams pour améliorer votre expérience.
Important
Les bots sont disponibles dans Government Community Cloud (GCC), GCC High, Department of Defense (DoD) et Teams gérés par les environnements 21Vianet .
Ce que vous devez savoir : Robots
Un bot apparaît comme n’importe quel autre membre de l’équipe avec lequel vous interagissez dans une conversation, sauf qu’il dispose d’une icône d’avatar hexagonal et qu’il est toujours en ligne.
Un bot se comporte différemment selon le type de conversation dans lequel il est impliqué. Les robots dans Teams prennent en charge plusieurs types de conversations appelées étendues dans le manifeste de l’application.
-
teamsAussi appelée conversations de canal. -
personalConversations entre un bot et un seul utilisateur. -
groupChatConversation entre un bot et deux utilisateurs ou plus.
Pour plus d’informations, consultez Avoir une conversation avec un robot Microsoft Teams.
Avec les applications Teams, vous pouvez faire du bot la star de votre expérience, ou simplement un assistant. Les bots sont publiés dans le cadre de votre package d’application plus large, qui peut inclure d’autres fonctionnalités telles que des onglets ou desextensions de message.
API Bot
Teams prend en charge la majeure partie de Microsoft Bot Framework. (Si vous disposez déjà d’un bot basé sur Bot Framework, vous pouvez facilement l’adapter pour qu’il fonctionne dans Teams.) Nous vous recommandons d’utiliser C# ou Node.js pour tirer parti de nos kits de développement logiciel (SDK). Ces packages étendent les classes et méthodes de base du SDK Bot Builder :
- Utilisation de types de cartes spécialisés comme la carte de connecteur pour les Groupes Microsoft 365.
- Consommation et définition de données de canal spécifiques à Teams sur les activités.
- Traitement des demandes d’extension de message.
Les extensions SDK installent les dépendances, y compris le SDK Bot Builder.
- .NET Pour utiliser les extensions Microsoft Teams pour le SDK Bot Builder pour .NET, installez le package NuGet Microsoft.Bot.Connector.Teams dans votre projet Visual Studio. Pour Node.js développement, la fonctionnalité BotBuilder pour Microsoft Teams a été incorporée dans le SDK Bot Framework à partir de la version 4.6.
Important
Vous pouvez développer des applications Teams dans n’importe quelle autre technologie de programmation web et appeler directement les API REST de Bot Framework , mais vous devez effectuer vous-même toute la gestion des jetons.
Developer Portal for Teams vous aide à créer et configurer votre manifeste d’application, et peut créer votre bot Bot Framework pour vous. Il contient également une bibliothèque de contrôle React et un générateur de cartes interactif.
Webhooks sortants
Les webhooks sortants vous permettent de créer un bot simple pour une interaction de base, comme le lancement d’un workflow ou d’autres commandes simples dont vous pourriez avoir besoin. Les webhooks sortants ne résident que dans l’équipe dans laquelle vous les créez et sont destinés à des processus simples spécifiques au flux de travail de votre entreprise. Pour plus d’informations, consultez Webhooks sortants.
Créer un excellent bot Teams
Les articles suivants vous guident tout au long du processus de création d’un robot idéal pour Teams :
- Créer un bot : profitez des outils, de la documentation et de la communauté fournis par l’équipe Bot Framework.
- Parlez à votre bot : ajoutez un flux de conversation de base et utilisez des fonctionnalités spécifiques au canal. Si vous développez dans .NET ou Node.js, utilisez nos extensions pour le SDK Bot Builder afin de simplifier votre travail.
- Utilisation de cartes dans votre bot : concevez des cartes pour communiquer et accepter la réponse de l’utilisateur.
- Répondre aux événements de bot
- Bots de notification uniquement : utilisation de bots pour envoyer des notifications pour votre application.
- Obtenir le contexte : Obtenez des informations sur l’utilisateur.
- Menus de robot : utilisation de menus dans des robots.
- Bots et fichiers : envoi et réception de fichiers à partir de bots.
- Utilisation d’onglets avec des bots : faire en sorte que les onglets et les bots fonctionnent ensemble.
- Testez votre bot : ajoutez votre bot pour des conversations personnelles ou d’équipe pour le voir en action.
Bots SDK V3
Important
Cet article est basé sur le SDK Bot Framework v3.
- Si vous souhaitez créer un bot IA, consultez créer un bot IA.
- Si vous souhaitez créer un bot de base, reportez-vous à la section Mise en route, et si vous souhaitez rechercher la version 4.6 ou ultérieure de la documentation actuelle du Kit de développement logiciel (SDK), reportez-vous à la section Robots conversationnels.
Le portail du développeur Teams pour Teams est un outil qui peut vous aider à créer votre bot et un package d’application qui fait référence à votre bot. Il contient également une bibliothèque de contrôle React et des échantillons configurables pour les cartes. Pour plus d’informations, consultez Prise en main du portail de développement Teams pour Teams. Les étapes qui suivent supposent que vous configurez manuellement votre bot et que vous n’utilisez pas le portail de développement Teams pour Teams :
Créez le bot à l’aide de Bot Framework. Veillez à ajouter Microsoft Teams en tant que canal à partir de la liste des canaux recommandés après avoir créé votre bot. N’hésitez pas à réutiliser l’ID d’application Microsoft que vous avez généré si vous avez déjà créé votre package/manifeste d’application.
Remarque
Si vous ne souhaitez pas créer votre bot dans Azure, vous devez utiliser ce lien pour créer un bot : Bot Framework. Si vous sélectionnez plutôt Créer un bot dans le portail Bot Framework, vous créez votre bot dans Microsoft Azure à la place.
Générez le bot à l’aide du package NuGet Microsoft.Bot.Connector.Teams , du SDK Bot Framework ou de l’API Bot Connector.
Testez le bot à l’aide de l’émulateur Bot Framework Emulator.
Déployez le bot sur un service cloud, tel que Microsoft Azure. Vous pouvez également exécuter votre application en local et utiliser un service de tunneling tel que ngrok pour exposer un point de terminaison https:// pour votre bot, tel que
https://45az0eb1.ngrok-free.app/api/messages.
Remarque
Bots et Microsoft Azure
Le portail Bot Framework est optimisé pour l’inscription de bots dans Microsoft Azure. Voici quelques informations à connaître :
- Le canal Microsoft Teams pour les bots inscrits sur Azure est gratuit. Les messages envoyés sur le canal 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 créer un bot Bot Framework, qui n’est plus exposé dans le portail Bot Framework.
- Lorsque vous modifiez les propriétés d’un bot existant dans la liste de vos bots dans Bot Framework, telles que son « point de terminaison de messagerie », qui est courant lors du développement initial d’un bot, en particulier si vous utilisez ngrok, vous verrez la colonne « Migration status » et un bouton bleu « Migrer » qui vous permet d’accéder au Portail Azure Microsoft. Ne sélectionnez pas le bouton « Migrer » à moins que ce ne soit ce que vous souhaitiez faire ; Sélectionnez plutôt le nom du bot et vous pouvez modifier ses propriétés :
- Si vous inscrivez votre bot à l’aide de 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 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. La création et l’utilisation de robots avec Teams sont toujours gratuites.
- Vous pouvez désormais utiliser le portail Développeur pour Teams pour enregistrer/mettre à jour les informations des applications et des bots directement dans Teams. Vous n’aurez qu’à utiliser le Portail Azure pour ajouter ou configurer d’autres canaux Bot Framework tels que Direct Line, Chat Web, Skype et Facebook Messenger.