Adicionar bots a aplicativos do Microsoft Teams
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 ).
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:
- 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.