Ajouter des bots aux applications Microsoft Teams

Importante

Cet article est basé sur le Kit de développement logiciel (SDK) Bot Framework v3. Si vous recherchez la documentation actuelle version 4.6 ou ultérieure du Kit de développement logiciel (SDK), consultez la section Bots conversationnels .

Créez et connectez des bots intelligents pour interagir naturellement avec les utilisateurs de Microsoft Teams par le biais d’une conversation. Ou fournissez un bot simple basé sur des commandes, à utiliser comme votre « ligne de commande » pour votre expérience d’application Teams plus large. Vous pouvez créer un bot de notification uniquement, qui peut envoyer (push) des informations pertinentes à vos utilisateurs directement dans un canal ou un message direct. Vous pouvez même apporter votre bot basé sur Bot Framework existant et ajouter une prise en charge spécifique à Teams pour améliorer votre expérience.

Importante

Les bots sont disponibles dans les environnements Cloud de la communauté du secteur public (GCC), GCC-High et doD (Department of Defense).

Ce que vous devez savoir : bots

Un bot apparaît comme n’importe quel autre membre de l’équipe avec lequel vous interagissez dans une conversation, à ceci près qu’il a 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 bots dans Teams prennent en charge plusieurs types de conversations appelées étendues dans le manifeste d’application.

• teams Également appelé conversations de canal.
• personal conversations entre un bot et un seul utilisateur.
• groupChat Conversation entre un bot et deux utilisateurs ou plus.

Pour plus d’informations, consultez Avoir une conversation avec un bot Microsoft Teams.

Avec les applications Teams, vous pouvez faire du bot l’étoile de votre expérience, ou simplement un helper. Les bots sont distribués dans le cadre de votre package d’application plus large, qui peut inclure d’autres fonctionnalités telles que les onglets ou les extensions de message.

API de 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 SDK. Ces packages étendent les classes et méthodes de base du kit de développement logiciel (SDK) Bot Builder :

• Utilisation de types de cartes spécialisés comme la carte de connecteur pour les groupes Microsoft 365.
• Utilisation et définition de données de canal spécifiques à Teams sur les activités.
• Traitement des demandes d’extension de message.

Les extensions du Kit de développement logiciel (SDK) installent des dépendances, notamment le SDK Bot Builder.

• .NET Pour utiliser les extensions Microsoft Teams pour le Bot Builder SDK pour .NET, installez le paquet Microsoft.Bot.Connector.Teams NuGet dans votre projet Visual Studio. Pour le développement Node.js, la fonctionnalité BotBuilder pour Microsoft Teams a été incorporée dans le kit de développement logiciel (SDK) Bot Framework à compter de la version 4.6.

Importante

Vous pouvez développer des applications Teams dans n’importe quelle autre technologie de programmation web et appeler directement les API REST Bot Framework , mais vous devez gérer vous-même tous les jetons.

Le portail des développeurs pour 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ôles 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 flux de travail ou d’autres commandes simples dont vous pouvez avoir besoin. Les webhooks sortants résident uniquement 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 bot Teams idéal

Les articles suivants vous guident tout au long du processus de création d’un bot idéal pour Teams :

• Créer un bot: tirez parti 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 tirez parti 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: obtenir des informations sur l’utilisateur.
• menus bot: utilisation de menus dans les bots.
• bots et fichiers: envoi et réception de fichiers à partir de bots.
• l’utilisation d’onglets avec des bots: la collaboration des onglets et des bots.
• tester votre bot: ajoutez votre bot pour les conversations personnelles ou d’équipe pour le voir en action.

Voir aussi

Exemples Bot Framework