Adicionar bots aos aplicativos do Microsoft TeamsAdd bots to Microsoft Teams apps

Importante

Os artigos desta seção são baseados no SDK do v3 bot Framework.The articles in this section are based on the v3 Bot Framework SDK. Se você estiver procurando a documentação atual (versão 4,6 ou posterior do SDK), consulte a seção bots de conversa .If you're looking for current documentation (version 4.6 or later of the SDK) see the Conversational Bots section.

Crie e conecte bots inteligentes para interagir com os usuários do Microsoft Teams naturalmente por meio de chat.Build and connect intelligent bots to interact with Microsoft Teams users naturally through chat. Ou fornecer um bot simples baseado em comandos, para ser usado como a interface de linha de comando para sua experiência mais ampla de aplicativos do teams.Or provide a simple commands-based bot, to be used as your "command-line" interface for your broader Teams app experience. Você pode criar um bot somente para notificação, que pode enviar informações relevantes aos seus usuários diretamente para eles em um canal ou em uma mensagem direta.You can make a notification-only bot, which can push information relevant to your users directly to them in a channel or direct message. Você pode até mesmo trazer o bot baseado na estrutura de bot existente e adicionar suporte específico ao Teams para fazer com que sua experiência se sobressaia.You can even bring your existing Bot Framework-based bot and add Teams-specific support to make your experience shine.

Exemplo de um bot que ajuda um usuário

O que você precisa saber: botsWhat you need to know: Bots

Um bot aparece exatamente como qualquer outro membro da equipe com o qual você interage em uma conversa, exceto pelo fato de ter um ícone de avatar hexágono e está sempre online.A bot appears just like any other team member you interact with in a conversation except that it has a hexagonal avatar icon and is always online.

Um bot se comporta de forma diferente dependendo do tipo de conversa em que está envolvido.A bot behaves differently depending on what kind of conversation it is involved in. Os bots no Teams dão suporte a vários tipos de conversas (chamadas de escopos no manifesto do aplicativo).Bots in Teams support several kinds of conversations (called scopes in the app manifest).

  • teamsTambém chamadas de conversas de canalteams Also called channel conversations
  • personalConversas entre um bot e um único usuáriopersonal Conversations between a bot and a single user
  • groupChatUma conversa entre um bot e dois ou mais usuáriosgroupChat A conversation between a bot and 2 or more users

Confira uma conversa com um bot do Microsoft Teams para obter mais informações.See Have a conversation with a Microsoft Teams bot for more information.

Com os aplicativos do Microsoft Teams, você pode tornar o bot a estrela de sua experiência ou apenas um auxiliar.With Microsoft Teams apps, you can make the bot the star of your experience, or just a helper. Os bots são distribuídos como parte do pacote de aplicativos mais amplo, que pode incluir outros recursos, como guias ou extensões de mensagens.Bots are distributed as part of your broader app package which can include other capabilities such as tabs or messaging extensions.

APIs de botBot APIs

O Microsoft Teams é compatível com a maior parte do Microsoft bot Framework.Microsoft Teams supports most of the Microsoft Bot Framework. (Se você já tiver um bot baseado na estrutura de bot, poderá adaptá-lo facilmente para trabalhar no Microsoft Teams.) Recomendamos que você use C# ou node. js para aproveitar os benefícios de nossos SDKs.(If you already have a bot that's based on the Bot Framework, you can easily adapt it to work in Microsoft Teams.) We recommend you use either C# or Node.js to take advantage of our SDKs. Esses pacotes estendem as classes e métodos do SDK do construtor de bot básicos:These packages extend the basic Bot Builder SDK classes and methods:

  • Usando tipos de cartões especializados como o cartão de conexão do Office 365Using specialized card types like the Office 365 Connector card
  • Consumindo e configurando dados de canal específicos do teams em atividadesConsuming and setting Teams-specific channel data on activities
  • Processar solicitações de extensão de mensagensProcessing messaging extension requests

As extensões SDK instalam dependências, incluindo o SDK do bot Builder.The SDK extensions install dependencies, including the Bot Builder SDK.

  • .Net Para usar o Microsoft Teams Extensions para o SDK do bot Builder para .NET, instale o pacote NuGet Microsoft. bot. Connector. Teams no seu projeto do Visual Studio..NET To use the Microsoft Teams extensions for the Bot Builder SDK for .NET, install the Microsoft.Bot.Connector.Teams NuGet package in your Visual Studio project. Para o desenvolvimento de Node. js, a funcionalidade do BotBuilder para Microsoft Teams foi incorporada ao SDK da estrutura de bot a partir da v 4.6.For Node.js development, the BotBuilder for Microsoft Teams functionality has been incorporated into the Bot Framework SDK as of v4.6.

Confira também exemplos da estrutura de bot.See also Bot Framework samples.

Importante

Você pode desenvolver aplicativos do teams em qualquer outra tecnologia de programação da Web e chamar as APIs REST da estrutura de bot diretamente, mas você deve executar todo o tratamento de tokens por conta própria.You can develop Teams apps in any other web-programming technology and call the Bot Framework REST APIs directly, but you must perform all token handling yourself.

O Teams app Studio ajuda você a criar e configurar seu manifesto de aplicativo e pode criar seu bot da estrutura de bot para você.Teams App Studio helps you create and configure your app manifest, and can create your Bot Framework bot for you. Ele também contém uma biblioteca de controle de reagir e um construtor de cartões interativos.It also contains a React control library and an interactive card builder.

WebHooks de saídaOutgoing webhooks

Os WebHooks de saída permitem que você crie um bot simples para interação básica, como o Iniciando de um fluxo de trabalho ou outros comandos simples que você possa precisar.Outgoing webhooks allow you to create a simple bot for basic interaction, like kicking off a workflow or other simple commands you may need. Os WebHooks de saída residem apenas na equipe em que você os cria e se destinam a processos simples específicos do fluxo de trabalho de sua empresa.Outgoing webhooks live only in the team in which you create them and are intended for simple processes specific to your company's workflow. Confira WebHooks de saída para obter mais informações.See outgoing webhooks for more information.

Criar um grande bot de equipesBuild a great Teams bot

Os tópicos a seguir guiarão você pelo processo de criação de um ótimo bot para o Teams.The following topics will guide you through the process of creating a great bot for Teams.