Adicionar bots a aplicativos do Microsoft Teams

Importante

Este artigo baseia-se no SDK v3 do Bot Framework.

• Se quiser criar um bot de IA, veja Criar um bot de IA.
• Se quiser criar um bot básico, consulte Introdução e, se quiser procurar a versão atual da documentação 4.6 ou posterior do SDK, consulte 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 no star da sua experiência ou apenas um auxiliar. Os bots são publicados como parte do pacote de aplicações mais amplo, que pode incluir outras funcionalidades, como separadores ou extensões de mensagens.

APIs de bot

O Teams suporta a maioria dos 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 card especializados, como o conector card 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.

Bots SDK V3

Importante

Este artigo baseia-se no SDK v3 do Bot Framework.

• Se quiser criar um bot de IA, veja Criar um bot de IA.
• Se quiser criar um bot básico, consulte Introdução e, se quiser procurar a versão atual da documentação 4.6 ou posterior do SDK, consulte bots de conversação.

O Portal do Programador do Teams para Teams é uma ferramenta que pode ajudar a criar o bot e um pacote de aplicações que faz referência ao bot. Ele também contém uma biblioteca de controle React e amostras configuráveis para cartões. Para obter mais informações, veja Introdução ao Portal do Programador do Teams para Teams. Os passos que se seguem partem do princípio de que está a configurar manualmente o bot e não está a utilizar o Portal do Programador do Teams para o Teams:

1. Crie o bot com o Bot Framework. Lembre-se de adicionar o Microsoft Teams como um canal da lista de canais em destaque após criar seu bot. Não hesite em reutilizar qualquer ID da Aplicação Microsoft gerado se já tiver criado o seu pacote/manifesto de aplicação.

   

Observação

Se não quiser criar o bot no Azure, tem de utilizar esta ligação para criar um novo bot: Bot Framework. Se clicar em Criar um bot no portal do Bot Framework, irá criar o bot no Microsoft Azure .

2. Crie o bot com o pacote NuGet Microsoft.Bot.Connector.Teams , o SDK do Bot Framework ou a API do Bot Connector.

3. Teste o bot com o Bot Framework Emulator.

4. Implemente o bot num serviço cloud, como o Microsoft Azure. Em alternativa, execute a aplicação localmente e utilize um serviço de túnel como o ngrok para expor um ponto final https:// para o bot, como https://45az0eb1.ngrok-free.app/api/messages.

Observação

Bots e Microsoft Azure

A partir de dezembro de 2017, o portal do Bot Framework está otimizado para registar bots no Microsoft Azure. Aqui estão algumas coisas que você precisa saber:

• O canal do Microsoft Teams para bots registado no Azure é gratuito. As mensagens enviadas através do canal do Teams não contarão para as mensagens consumidas para o bot.
• Embora seja possível criar um novo bot do Bot Framework sem utilizar o Azure, tem de utilizar a criação de um novo bot do Bot Framework, que já não está exposto no portal do Bot Framework.
• Quando edita as propriedades de um bot existente na lista de bots no Bot Framework, como o respetivo "ponto final de mensagens", que é comum ao desenvolver um bot pela primeira vez, especialmente se utilizar o ngrok, verá a coluna "Migração status" e um botão azul "Migrar" que o levará para o microsoft portal do Azure. Não clique no botão "Migrar", a menos que seja isso que pretende fazer; em vez disso, clique no nome do bot e pode editar as respetivas propriedades:
  
• Se registar o bot com o Microsoft Azure, o código do bot não precisa de ser alojado no Microsoft Azure.
• Se registar um bot com portal do Azure, tem de ter uma conta do Microsoft Azure. Você pode criar uma gratuitamente. Para verificar a sua identidade quando cria uma, tem de fornecer um card de crédito, mas não será cobrado; é sempre gratuito criar e utilizar bots com o Teams.
• Agora, pode utilizar o Portal do Programador do Teams para registar/atualizar informações de aplicações e bots diretamente no Teams. Só terá de utilizar o portal do Azure para adicionar ou configurar outros canais do Bot Framework, como Direct Line, Webchat, Skype e Facebook Messenger.

Confira também

Amostras do Bot Framework.