Adicionar bots a aplicativos do Microsoft Teams

Importante

Este artigo é baseado no SDK do Bot Framework v3. Se você estiver procurando a documentação atual versão 4.6 ou posterior do SDK, consulte a seção bots de conversação .

Crie e conecte bots inteligentes para interagir com os usuários do Microsoft Teams naturalmente por meio do chat. Ou forneça um bot simples baseado em comandos, a ser usado como sua interface de "linha de comando" para ter uma experiência mais ampla do aplicativo do Teams. Você pode criar um bot somente notificação, que pode enviar por push informações relevantes para seus usuários diretamente para eles em um canal ou mensagem direta. Você pode até mesmo trazer sua Bot Framework existente e adicionar suporte específico do Teams para fazer sua experiência se destacar.

Importante

Os bots estão disponíveis em ambientes do GCC (Government Community Cloud), GCC-High e DoD (Departamento de Defesa ).

O que você precisa saber: bots

Um bot aparece como qualquer outro membro da equipe com o qual você interage em uma conversa, exceto que ele tem um ícone de avatar hexagonal e está sempre online.

Um bot se comporta de forma diferente dependendo do tipo de conversa em que está envolvido. Os bots no Teams dão suporte a vários tipos de conversas chamadas escopos no manifesto do aplicativo.

• teams Também chamado de conversas de canal.
• personal Conversas entre bots e um único usuário.
• groupChat Uma conversa entre um bot e dois ou mais usuários.

Para obter mais informações, Converse com um bot do Microsoft Teams.

Com os aplicativos do Teams, você pode fazer do bot o star de sua experiência ou apenas um auxiliar. 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 mensagem.

APIs de bot

O Teams dá suporte à maior parte do Microsoft Bot Framework. (Se você já tiver um bot baseado no Bot Framework, poderá adaptá-lo facilmente para trabalhar no Teams.) Recomendamos que você use C# ou Node.js para aproveitar nossos SDKs. Esses pacotes estendem as classes e os métodos básicos SDK do Construtor de Bot:

• Usando tipos de cartão especializados, como o conector cartão para Grupos do Microsoft 365.
• Consumindo e definindo dados de canal específicos do Teams em atividades.
• Processando solicitações de extensão de mensagem.

As extensões do SDK instalam dependências, incluindo o Bot Builder SDK.

• .NET Para usar as extensões do Microsoft Teams para o SDK do Bot Builder para .NET, instale o pacote NuGet Microsoft.Bot.Connector.Teams em seu projeto do Visual Studio. Para o desenvolvimento do Node.js, a funcionalidade BotBuilder para Microsoft Teams foi incorporada ao Bot Framework SDK a partir da v4.6.

Importante

Você pode desenvolver aplicativos do Teams em qualquer outra tecnologia de programação na Web e chamar asAPIs REST do Bot Framework diretamente, mas deve executar todo o tratamento de token por conta própria.

O Portal do Desenvolvedor do Teams ajuda você a criar e configurar seu manifesto de aplicativo e pode criar seu bot bot do Bot Framework para você. Ele também contém uma biblioteca de controle React e um construtor de cartões interativo.

Webhooks de saída

Os webhooks de saída permitem que você crie um bot simples para interação básica, como iniciar um fluxo de trabalho ou outros comandos simples que você possa precisar. Os webhooks de saída só existem na equipe na qual você os cria e se destinam a processos simples específicos para o fluxo de trabalho da sua empresa. Para obter mais informações, consulte hooks de saída.

Crie um ótimo bot do Teams

Os artigos a seguir orientarão você durante o processo de criação de um grande bot para o Teams:

• Crie um bot: aproveite as excelentes ferramentas, documentação e comunidade fornecidas pela equipe do Bot Framework.
• Converse com seu bot: adicione o fluxo de conversa básico e aproveite a funcionalidade específica do canal. Se você desenvolve no .NET ou node.js, use nossas extensões para o SDK do Bot Builder para simplificar seu trabalho.
• Usando cartões em seu bot: crie cartões para se comunicar e aceitar a resposta do usuário.
• Responder a eventos de bot
• Bots somente para notificação: usando bots para enviar notificações para seu aplicativo.
• Obtenha contexto: obtenha informações sobre o usuário.
• Menus de bot: usando menus em bots.
• Bots e arquivos: enviando e recebendo arquivos de bots.
• Usando guias com bots: fazendo com que guias e bots funcionem juntos.
• Teste seu bot: adicione seu bot para conversas pessoais ou de equipe para vê-lo em ação.

Confira também

Amostras do Bot Framework.