Criar bots para o Teams

Um bot também é conhecido como chatbot ou bot de conversa. É um aplicativo que executa tarefas simples e repetitivas por usuários, como atendimento ao cliente ou equipe de suporte. O uso diário de bots inclui bots que fornecem informações sobre o clima, fazem reservas de jantar ou fornecem informações de viagem. As interações com bots podem ser perguntas e respostas rápidas ou conversas complexas.

É recomendável começar a criar seu primeiro aplicativo bot usando JavaScript ou criar bot de notificação com JavaScript usando a nova ferramenta de desenvolvimento de geração para o Teams. Para obter mais informações, confira Visão geral do Teams Toolkit.

Importante

• Os bots estão disponíveis em ambientes do GCC (Government Community Cloud), GCC-High e DoD (Departamento de Defesa ). Os aplicativos bot no Microsoft Teams para GCC-High e DOD estão disponíveis por meio do Serviço de bot do Azure e o registro do canal de bot deve ser feito em Azure Governamental portal.

• Não há suporte para URLs de imagem em Cartões Adaptáveis em ambientes GCC-High e DOD. Você pode substituir uma URL de imagem por uma DataUri codificada em Base64.

• Quando um usuário altera o tema do Teams em um bot, o tema não se aplica ao conteúdo compartilhado usando um Cartão Adaptável.

Os bots de conversa permitem que os usuários interajam com seu serviço Web usando texto, cartões interativos e caixas de diálogo (conhecidos como módulos de tarefa no TeamsJS v1.x).

Os bots de conversa são extremamente flexíveis. Os bots podem manipular alguns comandos básicos ou tarefas complexas que envolvem inteligência artificial e processamento de linguagem natural. Os bots podem fazer parte de um aplicativo maior ou ser autônomo.

Use a combinação certa de cartões, texto e caixas de diálogo para criar um bot útil. A imagem a seguir mostra um usuário conversando com um bot em um bate-papo individual usando cartões de texto e interativos.

Cada interação entre o usuário e o bot é representada como uma atividade. Quando um bot recebe uma atividade, ele a passa para seus manipuladores de atividades. Consulte manipuladores de atividades do bot.

Bots são aplicativos que têm uma interface de conversa. Você pode interagir com um bot usando texto, cartões interativos e fala. Um bot se comporta de forma diferente em uma conversa de chat de canal ou grupo e em uma conversa individual. As conversas são manipuladas pelo conector da Estrutura do Bot. Consulte noções básicas de conversa.

Seu bot exige informações contextuais, como detalhes do perfil do usuário para acessar conteúdo relevante e aprimorar a experiência do bot. Consulte obter o contexto do Teams.

Você pode enviar e receber arquivos pelo bot usando as APIs do Graph ou as APIs do bot do Teams. Consulte enviar e receber arquivos pelo bot.

O limite de taxas é usado para otimizar os bots usados no seu aplicativo do Teams. Para proteger o Teams e seus usuários, as APIs do bot fornecem um limite de taxa para solicitações de entrada. Consulte otimizar seu bot com limitação de taxa no Teams.

Com as APIs do Microsoft Graph para chamadas e reuniões online, os aplicativos do Teams já podem interagir com os usuários usando voz e vídeo. Consulte bots de chamadas e reuniões.

Você pode usar as APIs do bot do Teams para obter informações dos membros de um chat ou equipe. Consulte alterações nas APIs do bot do Teams para buscar membros de equipe ou chat.

É possível alterar o nome do bot exibido no ambiente do Teams e atualizá-lo nas seguintes ocorrências:

• O nome do bot exibido como um título na janela de chat é gerenciado no manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo teams) e você pode atualizar o nome do bot no manifesto do aplicativo.

• O nome do bot exibido em sua lista de chats do Teams e na janela de chat com cada mensagem são gerenciados no Microsoft portal do Azure. Para aplicativos carregados personalizados, você pode atualizar o nome do bot na página de perfil do Bot em portal do Azure.

  

Adicionar autenticação SSO aos bots de conversa

Você pode adicionar autenticação de logon único ao bot de conversa usando as seguintes etapas:

• Criar bot de conversa do Teams
• Configurar seu aplicativo bot no Microsoft Entra ID

Experiência de configuração de bot

A experiência de configuração do bot ajuda você a habilitar as configurações do bot para que os usuários configurem o bot durante a instalação e reconfigurem o bot no escopo do canal ou do chat de grupo em que o bot está instalado. A configuração do bot é uma funcionalidade importante para aplicativos dentro da plataforma teams, estabelecendo as bases para sua eficácia operacional. Para obter mais informações, consulte experiência de configuração de bot.

Exemplos de código

Nome do exemplo	Descrição	.NET	Node.js	Manifesto
Lembrete de tarefa diária do bot	Este exemplo mostra como agendar uma tarefa recorrente e obter um lembrete em um horário agendado usando o bot.	View	View	View
Hello world bot	Este é um aplicativo hello world simples com recursos de extensão de bot e mensagem.	NA	View
Notificação de Cartão Adaptável	Este é um exemplo, que mostra como enviar notificações com diferentes Cartões Adaptáveis usando bots.	NA	View
Notificação do Webhook de entrada	Este é um exemplo, que mostra como enviar notificações usando o Webhook de entrada nos canais do Microsoft Teams.	NA	View

Próxima etapa

Bots e SDKs

Confira também

• Como os bots do Microsoft Teams funcionam
• Criar um bot do Microsoft Teams
• Criar um bot para o Teams
• Testar e depurar seu bot do Microsoft Teams
• Crie seu primeiro aplicativo de bot usando JavaScript
• Adicionar autenticação ao seu bot do Teams
• Usar caixas de diálogo de bots
• Criar webhooks de entrada
• Análise específica do aplicativo do Teams para instrumentação