Adicionar um disparador de e-mail

Inicia um bot quando uma nova mensagem de e-mail é recebida do serviço de e-mail pré-definido.

Conecte a Control Room a um dos serviços de e-mail do seu sistema e acione o bot quando receber um novo e-mail.

Para automação do e-mail, utilize o OAuth 2.0 para autenticar com o servidor do e-mail. Para registar a sua aplicação com a plataforma de identidade Microsoft, acesse Como usar a ação Conectar no pacote E-mail

Procedimento

  1. No painel da esquerda, clique em Automation (Automação).
    Uma lista de formulários e bots disponíveis é exibida.
  2. Clique em Criar novo > Bot.
  3. Insira um nome para o bot.
    Todos os bots são armazenados na pasta \Bots. (Opcional) Clique em Procurar para alterar a pasta.
  4. Clique em Criar e editar.
  5. Na página de criação do bot, clique em Gatilhos > Gatilho de e-mail.
  6. Arraste o E-mail para Arrastar um gatilho aqui.
  7. Use o painel Gatilho de e-mail à direita para escolher um dos seguintes tipos de servidor como o disparador para seus e-mails recebidos:
    Tipo de servidorPassos
    Microsoft Outlook Clique em Outlook.

    O Microsoft Outlook é definido como o serviço de e-mail e o bot é acionado quando você recebe um novo e-mail.
    Servidor de e-mail Clique em Servidor de e-mail.
    1. Insira as informações do Host do serviço de e-mail.

      Por exemplo, se estiver usando o Office365 como seu serviço de e-mail, digite Outlook.office365.com.

    2. Selecione IMAP ou POP3.
      IMAP e POP3 são protocolos usados para se conectar ao servidor de e-mail que permite ler seus e-mails por meio de um cliente de e-mail.
      Nota: O protocolo POP3 tem uma limitação conhecida em que qualquer novo convite de calendário também pode acionar o bot.
    3. Usar conexão segura (SSL/TLS): Selecione esta opção se quiser usar uma conexão segura com o servidor de e-mail.
    4. Digite o número da porta configurada para seu servidor de e-mail.
    5. Selecione um dos seguintes métodos de autenticação de usuário para fazer login no servidor de e-mail:
      • Básico
      • Credenciais de clientes
        • Especifique as IDs exclusivas de cliente e locatário que foram geradas quando você registrou o aplicativo no portal do Microsoft Azure.
        • Especifique o nome de usuário que deseja usar para acessar o servidor de e-mail.
        • Especifique o segredo do cliente que gerou para o seu aplicativo no portal de registro do aplicativo.
          Para os campos ID do cliente, ID do locatário, Nome do usuário, e Segredo do cliente, escolha entre as guias Credencial ou String insegura:
          • Credencial: Use um valor disponível no cofre de credenciais.
          • String insegura: Insira um valor manualmente.
          Nota: O fluxo de credenciais do cliente não suporta o Gmail.
      • Control Room gerenciada:

        Para usar o modo de autenticação OAuth2 gerenciado da Control Room para automatizar o Gmail, é necessário configurar a conexão OAuth na Control Room. Consulte Criar a conexão de OAuth.

        Atualize as informações nos seguintes campos:

        • Conexão: Clique no botão Escolher para selecionar um tipo de conexão.
        • Selecione Personalizado no campo Tipo de provedor.

        • Selecione o nome da conexão que configurou na Control Room para aplicativos do Google Workspace.

        • Use o campo Tipo de token para selecionar uma das seguintes opções:

          Para informações sobre os tokens de acesso e atualização do aplicativo Google Workspace, consulte Configurar aplicativos corporativos

          • Compartilhado: Selecione essa opção quando o token de acesso do OAuth2 for compartilhado para todos os usuários que executam a automação.
            Nota: A opção exige que o administrador ou qualquer usuário da Control Room (com as opções Gerenciar conexões e Exibir conexões habilitadas para CONEXÕES OAUTH) configure uma conexão do OAuth na Control Room. Salve as credenciais de login uma vez para gerar um token de acesso compartilhado que possa ser usado por todos os usuários que executam a automação.
          • Específico do usuário: Selecione esta opção quando o token de acesso do OAuth2 for específico para cada usuário que executa a automação.
            Nota: A opção exige que o administrador ou qualquer usuário da Control Room (com as opções Gerenciar conexões e Exibir conexões habilitadas para CONEXÕES OAUTH) configure uma conexão do OAuth na Control Room. Certifique-se de não salvar as credenciais de login para que cada usuário que executa a automação possa fornecer as próprias credenciais de login e gerar um token de acesso que só possa ser usado pelo usuário específico.
          • Clique em Confirmar.
        Nota: Ao usar a opção Específico do usuário, faça login em sua conta do Google para autenticar e gerar um token específico do usuário. Execute as seguintes etapas para usar esta opção:
        1. Na Control Room, navegue até seu perfil Minhas configurações > Conexões OAuth.
        2. Clique em Login para autenticar.
        3. Faça login em sua conta do Google e selecione Continuar.
        4. Verifique os serviços aos quais você tem acesso e clique em Continuar.

          Se a conexão for bem-sucedida, o status será exibido como Ativo.

      Nota: O E-mail na pasta não é compatível com subpastas quando você define o protocolo como POP3 para o Servidor de e-mail.
    Servidor EWS Clique em Servidor EWS.
    1. No menu suspenso Versão do Microsoft Exchange, selecione sua versão atual.

      Por exemplo, se estiver usando o Microsoft Exchange Service Pack 2, selecione Exchange2010_SP2 como seu serviço de e-mail.

    2. Digite o nome do domínio como, por exemplo: smtp.office365.com
    3. Selecione um dos seguintes métodos de autenticação de usuário para fazer login no servidor de e-mail:
      • Básico
      • OAuth 2.0 - Credenciais do cliente
        • Especifique as IDs exclusivas de cliente e locatário que foram geradas quando você registrou o aplicativo no portal do Microsoft Azure.
        • Especifique o nome de usuário que deseja usar para acessar o servidor de e-mail.
        • Especifique o segredo do cliente que gerou para o seu aplicativo no portal de registro do aplicativo.
          Para os campos ID do cliente, ID do locatário, Nome do usuário, e Segredo do cliente, escolha entre as guias Credencial ou String insegura:
          • Credencial: Use um valor disponível no cofre de credenciais.
          • String insegura: Insira um valor manualmente.
          Nota: Não há suporte de caixa de correio compartilhada para o Microsoft Outlook, mas, como solução alternativa, você pode usar o fluxo de credenciais do servidor EWS com um e-mail compartilhado como uma string de nome de usuário.
  8. Opcional: Use o menu suspenso Verificar a cada disponível em todos os tipos de servidor para definir o intervalo de acionamento.

    O intervalo de acionamento do bot é definido como 120 segundos por padrão.

    Nota: O intervalo de acionamento que você configurou usando o menu suspenso Verificar a cada não depende do número de e-mails recebidos durante o intervalo agendado.

    Por exemplo, se você tiver configurado Verificar a cada 1 segundo, a tarefa será acionada apenas uma vez, mesmo se você receber três e-mails diferentes ao mesmo tempo. O filtro de tempo de execução de polling é atualizado para a data e hora de envio do e-mail para o qual o último gatilho foi executado.

  9. Opcional: Use Selecionar condições para especificar um evento de e-mail para o tipo de servidor selecionado.
    Considere um cenário em que você seleciona o Outlook e quer acionar um bot quando receber um e-mail de um remetente específico. Em Selecionar condições, selecione a caixa de seleção E-mail de e especifique o endereço de e-mail do remetente.
    Ao selecionar Assunto do e-mail contém, o acionamento do e-mail é executado de acordo com as seguintes condições de assunto:
    • Quando a linha de assunto é fornecida entre aspas duplas (""), por exemplo, “planilha ABC”, o gatilho é executado somente quando o assunto do e-mail tem uma correspondência exata para a string fornecida entre aspas.
    • Quando várias linhas de assunto são separadas por ponto e vírgula, por exemplo, planilha ABC; Logs do projeto ABC, o gatilho é executado quando o assunto do e-mail corresponde a qualquer uma das linhas de assunto mencionadas.
  10. Opcional: Para criar uma variável, na guia Atribuído a > Registro, clique em Selecionar ícone de variável.

    Use essa variável para recuperar vários detalhes sobre o e-mail que acionou o bot, como remetente, destinatário, assunto, conteúdo de e-mail, data, informação de ação, host de servidor de e-mail e dados da porta.

  11. Clique em Aplicar.
  12. Clique em Executar > Executar com gatilhos.
O Microsoft Outlook, servidor de e-mail ou servidor EWS é definido como o disparador para iniciar o bot para novos e-mails.
Nota: Ao executar um disparador de e-mail, a chave emailPara retorna uma lista de endereços Para. Para converter a lista de endereços Para em uma string, use a ação Atribuir do pacote Lista e use a ação Unir itens do pacote Lista com a vírgula como delimitador para separar os endereços.