Gatilhos da Web do Microsoft Teams
- Última atualização2026/01/13
Gatilhos da Web do Microsoft Teams
Os gatilhos da Web do Microsoft Teams permitem automatizar tarefas com base nos eventos que ocorrem no chat ou nos canais do Microsoft Teams. Os gatilhos da Web monitoram eventos específicos que ocorrem no Microsoft Teams. Assim que os eventos ocorrem, o gatilho inicia as ações configuradas.
Visão geral
Os gatilhos da Web do Microsoft Teams permitem criar gatilhos com base em eventos como mensagens diretas de chat, mensagens de chat em grupo e alterações na participação de canais no Microsoft Teams. Você pode usar os gatilhos para acionar fluxos de trabalho assim que o evento ocorrer no Microsoft Teams, reduzindo o monitoramento manual e o tempo de resposta para comunicações essenciais. As opções disponíveis nos gatilhos da Web do Microsoft Teams permitem criar automações baseadas em gatilhos para casos de uso como atribuição de tickets, extração de informações de mensagens de chat e início de um thread de e-mail para notificar as partes interessadas.
A latência entre o evento que ocorre em um aplicativo do Microsoft Teams e o gatilho que inicia a automação com base no evento é inferior a 30 segundos. Se a entrega do evento para a sessão falhar, o gatilho tenta buscar o evento novamente automaticamente.
Os gatilhos da Web do Microsoft Teams oferecem a opção de utilizar palavras-chave para filtrar mensagens. A opção Filtrar permite configurar o gatilho para casos de uso em que a automação deve ser acionada com base em palavras-chave específicas. Essa opção limita as respostas do evento às mensagens que contêm as palavras-chave especificadas.
O gatilho captura as informações da carga útil da resposta do evento do servidor Microsoft em um formato JSON estruturado. Essa carga útil inclui as informações de autenticação que permitem que os dados sejam validados. Você pode visualizar a carga útil da resposta na página Log de auditoria como pares de chave-valor. Você pode utilizar essas informações de pares chave-valor como entrada para as ações subsequentes dentro da sessão.
Autenticação
Os gatilhos da Web do Microsoft Teams usam OAuth para autenticar a conexão com a conta Microsoft 365. Configure a conexão OAuth com os parâmetros aplicáveis para Microsoft Entra do Microsoft Teams. Para obter mais informações sobre como configurar conexões OAuth, consulte Criar a conexão de OAuth.
Os gatilhos da Web do Microsoft Teams utilizam certificados do Microsoft Azure para autenticar a assinatura da conta Microsoft e descriptografar os dados recebidos dos servidores da Microsoft. Faça login no seu portal do Microsoft Azure e crie um certificado. Para obter mais informações sobre como criar certificados no portal do Microsoft Azure, consulte Certificate creation methods no portal Microsoft Learn. Para obter mais informações sobre como gerenciar certificados, consulte Managing encryption keys.
Adicione o certificado criado no Credential Vault. Faça o seguinte para adicionar os dados do certificado ao Credential Vault:
- Abra o arquivo de certificado em qualquer editor de texto.
- Copie todo o conteúdo do arquivo de certificado.
- Faça login na Control Room como administrador.
- Acesse e clique em Criar credencial.
- Insira um Nome da credencial apropriado e uma Descrição para a credencial.
- Insira um nome apropriado em Nome do atributo na seção Atributos.
- Selecione Padrão e cole o conteúdo do certificado no campo Valor na seção Entrada dos Atributos.
- Clique em Criar credencial para salvar os dados do certificado no Credential Vault.
Eventos compatíveis
Os seguintes eventos são compatíveis tanto na configuração de gatilho de chat individual quanto de equipes:
| Eventos | Descrição |
|---|---|
| Quando uma mensagem de chat é adicionada | Quando uma nova mensagem chega. |
| Quando uma mensagem de chat é atualizada | Quando uma mensagem de chat existente é editada. |
| Quando uma mensagem de chat é excluída | Quando uma mensagem de chat existente é excluída. |
Os seguintes eventos são compatíveis na configuração do gatilho de associação à equipe:
| Eventos | Descrição |
|---|---|
| Quando um novo membro da equipe é adicionado | Quando os proprietários da equipe adicionam um novo membro à equipe selecionada. |
| Quando um membro da equipe é atualizado | Quando os proprietários da equipe editam os detalhes de membros existentes da equipe. |
| Quando um membro da equipe é removido | Quando os proprietários da equipe removem um membro da equipe selecionada. |
Pré-requisitos
Certifique-se de que os seguintes pré-requisitos sejam atendidos:
- Uma licença de Bot Creator ou Desenvolvedor cidadão.
- Permissões de ACIONADORES DE EVENTOS e Exibir meus bots.
- Permissão de Fazer checkin e Fazer checkout nas pastas onde a automação está localizada.
- Uma conexão OAuth ativa para a conta Microsoft 365.
- Um certificado do Microsoft Azure.
Configurações
As seguintes configurações estão disponíveis para os gatilhos da Web do Microsoft Teams:
- Conexão OAuth da Control Room
- Use a opção Escolher e siga as instruções no modal Escolher uma conexão OAuth para selecionar a conexão OAuth. A OAuth autentica a conexão entre a Control Room e a conta Microsoft 365.
- Chat
- Use essa opção para configurar o gatilho com base em chats individuais. O nome do chat funciona com base no e-mail do destinatário do chat e não no nome de exibição do destinatário.
- Monitorar o evento: Especifique o tipo de evento o gatilho deve monitorar.
- Nome do chat: digite o nome do chat. Você também pode usar o botão Obter nomes de chat para selecionar um chat usando o modal Chat.
- Filtro: Ative a caixa de seleção e insira as palavras-chave para filtrar as mensagens.
- Teams e canal
-
Chat da equipe: Use a opção Chat da equipe para configurar o gatilho com base nas mensagens postadas em um canal do Teams. As seguintes configurações estão disponíveis para essa opção:
- Escolha um ou mais eventos: especifique um ou mais tipos de evento que o gatilho deve monitorar.
- Nome da equipe: Insira o nome da equipe. Você também pode usar o botão Selecionar nome da equipe para selecionar a equipe usando o modal Equipes.
- Nome do canal: Digite o nome do canal. Você também pode usar Selecionar nome do canal para selecionar a equipe usando o modal Canais.
- Filtro: Ative a caixa de seleção e insira as palavras-chave para filtrar as mensagens.
-
Associação à equipe: use a opção Associação à equipe para configurar o gatilho com base nas alterações de associação dentro de uma equipe. As seguintes configurações estão disponíveis para essa opção:
- Opções de membros: especifique um ou mais tipos de evento que o gatilho deve monitorar.
- Nome da equipe: Insira o nome da equipe. Você também pode usar o botão Selecionar nome da equipe para selecionar a equipe usando o modal Equipes.
- Certificado
- Use a opção Certificado para selecionar o certificado para autenticação e criptografia.
- Credencial: Use a opção Escolher e siga as instruções no modal Selecionar uma credencial para selecionar o certificado do Microsoft Azure salvo no Credential Vault.
- String insegura: Use a opção String insegura para inserir o conteúdo do arquivo de certificado diretamente no campo de entrada.
- Resposta
- Use a opção Resposta para salvar os dados da resposta do gatilho em uma variável de Registro. Você pode criar uma nova variável ou selecionar uma variável existente para armazenar esses dados de resposta.
Leitura de dados de resposta de gatilho no Log de auditoria
Os dados de resposta do gatilho contêm todas as informações do registro de evento no qual ocorreu uma alteração. Esses dados de resposta são armazenados no formato de pares chave-valor. Você pode extrair esses dados e utilizá-los como entradas para outras ações dentro da automação. Quando o bot termina de ser executado, as informações de dados do gatilho são registradas como tipo de evento Bot executado por gatilho no Log de auditoria.