Criar bots para o Teams

Artigo
10/17/2024

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 do canal de bot tem de ser feito no portal Azure Governamental.
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.

A captura de ecrã é um exemplo que mostra um bot de FAQ de exemplo.

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.

Nome e ícone do bot

Nome do bot: pode alterar o nome do bot apresentado no ambiente do Teams ao atualizá-lo nas seguintes ocorrências:

O nome do bot, apresentado como um título na janela de chat, é atualizado e gerido no manifesto da sua aplicação (anteriormente denominado manifesto de aplicação do Teams).
O nome do bot apresentado na sua lista de conversas do Teams e na janela de chat com cada mensagem é gerido no Microsoft portal do Azure. Para aplicações carregadas personalizadas, pode atualizar o nome do bot na página Perfil do bot no portal do Azure.

Ícone do bot: pode adicionar ou atualizar o ícone do bot para a aplicação Teams da seguinte forma. O ícone do bot atualizado só fica visível depois de o utilizador ter terminado sessão e de voltar a iniciar sessão no Teams. Isto deve-se ao facto de os ícones estarem em cache:

Aplicação Microsoft Teams Store: para aplicações da Loja Teams, os ícones do bot são obtidos a partir do manifesto da aplicação. Pode atualizar o ícone do perfil do bot ao atualizá-lo através do manifesto da aplicação e voltar a publicar a aplicação.


{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.17",
  "version": "1.0.0",
  "id": "%MICROSOFT-APP-ID%",
  "icons": {
     "outline": "A relative path to a transparent .png icon — 32px X 32px", // This icon is used for bot profile.
     "color": "A relative path to a full color .png icon — 192px X 192px"
  },
  "bots": [
  {
    "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
    "scopes": [
      "team",
      "personal",
      "groupChat"
    ]
  }
  ]
...
}

Carregar uma aplicação personalizada no Teams ou aplicações personalizadas criadas para a sua organização (aplicações LOB):
- portal do Azure: pode alterar o ícone do bot ao navegar para portal do Azure.
- Portal do Bot Framework: para bots criados com o Portal do Bot Framework, pode atualizar o ícone do bot na página DEFINIÇÕES .

Especificar os requisitos de runtime do anfitrião (pré-visualização do programador)

Para garantir que a sua aplicação proporciona sempre aos clientes experiências de alta qualidade, pode personalizar o comportamento da sua aplicação em anfitriões do Microsoft 365 aplicáveis ou omiti-la de surgir em contextos que não está pronto para suportar. Utilize o manifesto da aplicação para especificar quaisquer relações de dependência entre capacidades da sua aplicação e requisitos de runtime específicos dos seus separadores estáticos, extensões de mensagens e bots.

Para obter mais informações, veja como especificar os requisitos de runtime do anfitrião do Microsoft 365 no manifesto da sua aplicação.

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:

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

Compartilhar via