Saltar para o conteúdo

Ler e-mail

Tipo de nó: browser_getEmail

O que faz

Obtém e-mails usando as configurações de caixa de correio definidas.

Configuração no cliente desktop

Configuração do nó "Ler e-mail" no cliente desktop

Captura de tela feita na interface em inglês do MoreLogin Desktop V2.73.101.

Entradas

Estes campos ficam em data.browserUi.inputs.

CampoTipo ou valoresObrigatório no esquemaPadrão de execuçãoDescrição e limites
userstringNão—Conta de e-mail
authType"password" / "oauth2" (aceita referências de variáveis)Não"password"Método de autorização. Valor inicial no editor: "password"
passwordstringNão—Senha / código de autorização
imapHoststringNão—Servidor IMAP
portWorkflowNumberNão993Porta; inteiro de 1 a 65535 após a resolução. Valor inicial no editor: 993
tlsboolean (aceita referências de variáveis)NãotrueAtivar TLS. Valor inicial no editor: true
clientIdstringNão—ID do cliente
clientSecretstringNão—Segredo do cliente
refreshTokenstringNão—Token de atualização
status"UNSEEN" / "SEEN" / "ALL" (aceita referências de variáveis)Não"UNSEEN"Status do e-mail. Valor inicial no editor: "UNSEEN"
isJunkboolean (aceita referências de variáveis)NãofalsePesquisar também no spam. Valor inicial no editor: false
seenboolean (aceita referências de variáveis)NãofalseMarcar como lido após a obtenção. Valor inicial no editor: false
fromstringNão—Filtro de remetente
mailTostringNão—Filtro de destinatário
subjectstringNão—O assunto contém
keywordstringNão—Palavra-chave no corpo
dateType"all" / "today" / "recent" (aceita referências de variáveis)Não"all"Data do e-mail. Valor inicial no editor: "all"
regstringNão—Regex de extração

Requisitos de modo e limites

  • Campos obrigatórios: user, imapHost, port
  • imapHost é um nome de host; port é um inteiro de 1 a 65535.
  • Código de validação: RPA_NODE_INPUT_INVALID

authType eq "password"

  • Campo obrigatório: password
  • O valor é uma senha ou um código de autorização da caixa de correio.
  • Código de validação: RPA_NODE_INPUT_INVALID

authType eq "oauth2"

  • Campos obrigatórios: clientId, refreshToken
  • Este modo só é compatível com IMAP do Outlook/Hotmail. Um refresh_token da Microsoft é trocado por um access_token, e o refresh_token rotacionado é armazenado em cache localmente de forma criptografada. clientSecret é opcional (apps de cliente público não precisam dele).
  • Código de validação: RPA_NODE_INPUT_INVALID
  • O nó faz uma conexão IMAP real e lê o e-mail mais recente que corresponde aos filtros. O modo password usa uma senha ou um código de autorização e funciona com qualquer host IMAP. OAuth2 e "Pesquisar também no spam" só são compatíveis com Outlook/Hotmail (outlook.office365.com, imap-mail.outlook.com); outros hosts retornam MAIL_PROVIDER_UNSUPPORTED. imapHost aceita apenas o nome do host, sem porta nem caminho. Os últimos três dias são hoje e os dois dias anteriores, no horário local da máquina que faz a execução. Quando reg está definido, é retornado o primeiro grupo de captura ou a correspondência completa. Se o e-mail mais recente não corresponder, será retornado null, sem recorrer a e-mails mais antigos. Quando reg não está definido, extractedValue é o corpo. seen=true marca como lido apenas o e-mail selecionado. message.receivedAt é o horário em que o e-mail foi recebido (horário local do cliente desktop, YYYY-MM-DD HH:mm:ss). Mais de 10000 candidatos em uma pasta retornam MAIL_SEARCH_LIMIT, um único e-mail acima de 10 MiB retorna MAIL_MESSAGE_LIMIT, e uma falha de conexão/autenticação retorna MAIL_CONNECTION_FAILED (o texto original do servidor e as credenciais não são expostos). POP3, envio de e-mails e download de anexos não são compatíveis.
  • Código de validação: RPA_NODE_INPUT_INVALID

Referências de entrada

CampoFormas permitidas
userliteral, template
authTypeliteral, template
passwordliteral, template
imapHostliteral, template
portliteral, template
tlsliteral, template
clientIdliteral, template
clientSecretliteral, template
refreshTokenliteral, template
statusliteral, template
isJunkliteral, template
seenliteral, template
fromliteral, template
mailToliteral, template
subjectliteral, template
keywordliteral, template
dateTypeliteral, template
regliteral, template

Saídas

Campo de saídaTipo ou valores
foundboolean
messageobject / null
extractedValuestring / null

Referencie os campos publicados como ${nodeId.data.field}.

Exemplo em JSON

Um objeto de nó completo para o array nodes de um fluxo ou para os blocks de outro nó. mailPassword é um parâmetro inicial privado declarado em workflow.variables.

{
  "id": "read_code_email",
  "type": "browser_getEmail",
  "data": {
    "title": "Read the verification email",
    "browserAction": "getEmail",
    "browserUi": {
      "inputs": {
        "user": "user@example.com",
        "authType": "password",
        "password": "${mailPassword}",
        "imapHost": "imap.example.com",
        "port": 993,
        "tls": true,
        "status": "UNSEEN",
        "from": "no-reply@example.com",
        "dateType": "today",
        "reg": "\\b(\\d{6})\\b"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

Voltar ao catálogo de nós