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.

É recomendado começar com a compilação da sua primeira aplicação de bot com JavaScript ou compilar o bot de notificação com JavaScript através da ferramenta de desenvolvimento de nova geração para o Teams. Para obter mais informações, consulte Descrição geral do Teams Toolkit.

Importante

• Os bots estão disponíveis em ambientes de Cloud da Comunidade Governamental (GCC), GCC-High e Departamento de Defesa (DOD ). As aplicações de bot no Microsoft Teams para GCC-High e DOD estão disponíveis através do Azure Bot Service e o registo de canais de bot tem de ser feito no portal do Azure Government.

• Os URLs de imagem em Cartões Ajustáveis não são suportados em ambientes GCC-High e DOD. Você pode substituir uma URL de imagem por uma DataUri codificada em Base64.

• Quando um utilizador altera o tema do Teams num bot, o tema não se aplica aos conteúdos partilhados com um Cartão Ajustável.

Os bots de conversação permitem que os utilizadores interajam com o seu serviço Web através de texto, cartões interativos e caixas de diálogo (referidos como módulos de tarefas 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.

Utilize a combinação correta 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.

Pode alterar o nome do bot apresentado no ambiente do Teams e tem de atualizá-lo nas seguintes ocorrências:

• O nome do bot apresentado como título na janela de chat é gerido no manifesto da sua aplicação (anteriormente denominado manifesto de aplicação do Teams) e pode atualizar o nome do bot no manifesto da sua aplicação.

• O nome do bot apresentado na sua lista de conversas do Teams e na janela de chat com cada mensagem é gerido no portal do Microsoft Azure. Para aplicações carregadas personalizadas, pode atualizar o nome do bot na página Perfil do bot no portal do Azure.

  

Adicionar autenticação SSO aos bots de conversação

Pode adicionar a autenticação de início de sessão único ao seu bot de conversação através dos seguintes passos:

• Criar um bot de conversação do Teams
• Configurar a aplicação bot no Microsoft Entra ID

Experiência de configuração do bot

A experiência de configuração do bot ajuda-o a ativar as definições do bot para os utilizadores configurarem o bot durante a instalação e reconfigurarem o bot a partir do âmbito de chat do canal ou do grupo onde o bot está instalado. A configuração do bot é uma funcionalidade importante para as aplicações na plataforma Teams, estabelecendo as bases para a sua eficácia operacional. Para obter mais informações, veja Experiência de configuração do 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 periódica e obter um lembrete numa hora agendada com o bot.	View	View	View
Hello world bot	Esta é uma aplicação hello world simples com capacidades de extensão de bots e mensagens.	NA	View
Notificação de Cartão Ajustável	Este é um exemplo, que mostra como enviar notificações com cartões ajustáveis diferentes através de bots.	NA	View
Notificação de Webhook recebido	Este é um exemplo, que mostra como enviar notificações com o Webhook recebido 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
• Utilizar caixas de diálogo de bots
• Criar Webhooks recebidos
• Instrumenting for Teams app specific analytics (Instrumenting for Teams app specific analytics)