Adicionar bots a aplicativos do Microsoft Teams

  • Artigo

Importante

Este artigo baseia-se no SDK v3 do Bot Framework. Se estiver à procura da versão atual da documentação 4.6 ou posterior do SDK, consulte a secçã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 de Cloud da Comunidade Governamental (GCC), GCC-High e Departamento de Defesa (DOD ).

Exemplo de um bot ajudando um usuário

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 comporta-se de forma diferente consoante o tipo de conversação 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ção entre um bot e dois ou mais utilizadores.

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

Com as aplicações do Teams, pode tornar o bot a estrela da 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 suporta a maioria do Microsoft Bot Framework. (Se já tiver um bot baseado no Bot Framework, pode adaptá-lo facilmente para funcionar no Teams.) Recomendamos que utilize C# ou Node.js para tirar partido dos nossos SDKs. Esses pacotes estendem as classes e os métodos básicos SDK do Construtor de Bot:

  • Utilizar tipos de cartões especializados, como o cartão de conector 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 Programador para Teams ajuda-o a criar e configurar o manifesto da sua aplicação e pode criar o bot do Bot Framework por si. 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 seguintes artigos irão orientá-lo ao longo do processo de criação de um excelente bot para o Teams:

Confira também

Amostras do Bot Framework.