Gatilhos da Web do Microsoft 365 Outlook

Os gatilhos da web do Microsoft 365 Outlook são configurados para monitorar uma caixa de entrada do Microsoft 365 Outlook para eventos.

Visão geral

O gatilho da Web do Microsoft 365 Outlook monitora eventos específicos em uma caixa de entrada do Microsoft 365 Outlook. Quando o evento ocorre na caixa de entrada monitorada, o gatilho inicia o fluxo de trabalho de automação configurado.

Autenticação

Os gatilhos da Web do Microsoft 365 Outlook usam OAuth para autenticar a conexão com a conta Microsoft 365 Outlook. Consulte Criar a conexão de OAuth para obter mais informações sobre conexões OAuth.

Os gatilhos da web do Microsoft 365 Outlook também usam certificados 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 Cofre de credenciais. Faça o seguinte para adicionar os dados do certificado ao Cofre de credenciais:

  1. Abra o arquivo de certificado em qualquer editor de texto.
  2. Copie todo o conteúdo do arquivo de certificado.
  3. Faça login na Control Room como administrador.
  4. Siga as etapas de 2 a 5 em Criar credencial.
  5. Na etapa 6, selecione a opção de entrada Padrão e cole o conteúdo do certificado no campo Valor.
  6. Clique em Criar credencial para salvar os dados do certificado no Cofre de credenciais.

Eventos compatíveis

O gatilho da Web do Microsoft 365 Outlook é compatível com os seguintes eventos:

Eventos Descrição
Quando chegar um novo e-mail Quando a caixa de entrada recebe um novo e-mail.
Quando um e-mail é atualizado Quando uma atualização é feita em um e-mail na caixa de entrada.
Quando um e-mail é excluído Quando um e-mail é excluído da caixa de entrada.

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 365 Outlook:

Captura de tela das configurações do gatilho da Web do Microsoft 365 Outlook

Monitorar evento
Selecione um ou mais eventos que o gatilho deve monitorar.
E-mail
Insira o endereço de e-mail da caixa de correio que deve ser monitorada.
Monitorar pasta de e-mail
Insira o nome da pasta na caixa de correio que deve ser monitorada. Você pode monitorar a caixa de entrada ou qualquer pasta aninhada dentro dela.
Digite inbox para monitorar a caixa de entrada. Para pastas aninhadas, insira o nome da pasta no formato tradicional de caminho de arquivo. Por exemplo, insira inbox/work para monitorar a pasta work dentro da caixa de entrada.
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 para a conta do Microsoft 365 Outlook.
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 Microsoft Azure salvo no Cofre de credenciais.
  • String insegura: Use a opção String insegura para inserir o conteúdo do arquivo de certificado diretamente no campo de entrada.
Filtrar critérios (opcional)
Use a opção Critérios de filtro (opcional) para definir os critérios de filtro para o gatilho. As seguintes opções de filtro estão disponíveis:
  • Consulta: Insira uma consulta apropriada com base nos filtros de consulta da Microsoft.
  • Condição: Use a opção Condição para criar condições usando os operadores E e Ou.
Se você usar a opção Condição, selecione o operador apropriado e clique em Adicionar condição.. Siga as instruções no modal Adicionar condição para configurar a condição para o operador selecionado. Os seguintes tipos de condição são compatíveis:
  • De: use essa opção para configurar uma condição com base no endereço de e-mail do remetente.
  • Com anexos use essa opção para configurar uma condição com base na disponibilidade de um anexo nos e-mails.
  • Importância: use essa opção para configurar uma condição com base no nível de prioridade definido no anexo. Você pode definir a condição como Alta para e-mails marcados com Alta importância, Baixa para e-mails marcados com Baixa importância ou Normal para e-mails sem qualquer prioridade.
  • Assunto: use essa opção para configurar uma condição com base no assunto do e-mail. Você pode usar uma das condições Igual a, Contém ou Começa com e inserir uma string apropriada no campo Assunto.
  • Status do sinalizador: Use essa opção para configurar uma condição com base no sinalizador definido para os e-mails. Você pode usar a opção Sinalizado para e-mails que tenham qualquer sinalizador definido, ou a opção Concluído para os e-mails que tenham o sinalizador Concluído definido.
Resposta (opcional)
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.
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. Esses dados podem ser usados 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.