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 E-mail pacote

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 do criador do bot, clique em Gatilhos > Gatilho de janela.
  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.
      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 o Atribuiração do Lista pacote e, em seguida use Juntar itensação do pacotede Listacom a vírgula como um delimitador para separar os endereços.