Nó Email Inbox

O nó Email Inbox conecta a uma caixa de e-mail via IMAP e aguarda ou busca mensagens que correspondam a critérios definidos. É ideal para validar recebimento de e-mails, extrair OTPs e capturar links de confirmação em fluxos de teste.

Visão Geral

Pré-requisito: Credencial de E-mail

Antes de usar o nó, crie uma Credencial de E-mail na seção Credenciais. Ela armazena a conexão IMAP e a autenticação de forma segura.

Campos de Configuração

Geral

Operações disponíveis

Filtros de busca

Todos os filtros são opcionais. Quando preenchido, o campo deve estar contido no e-mail para que ele seja considerado.

Filtro de data

Step Start (recomendado): o nó usa o UID do próximo e-mail no momento em que começa a execução, ignorando mensagens anteriores de forma confiável, independente de fuso horário.

Polling e limites

Anexos

Por padrão, o nó lê o conteúdo do e-mail sem baixar anexos. Ative anexos apenas quando o fluxo realmente precisa usar arquivos enviados por e-mail.

Quando há anexos, use o fileRef para enviar o arquivo para outros nós, como Extrair Arquivo, HTTP Request, SSH Command, Mobile Flow ou componentes.

Extração de OTP (quando operação = Extract OTP)

Quando nenhum regex é informado, o nó procura automaticamente por sequências numéricas com o comprimento configurado.

Extração de Link (quando operação = Extract Link)

Outputs

Estrutura do objeto email

{
  "uid": 12345,
  "messageId": "<abc@gmail.com>",
  "subject": "Seu código de verificação",
  "from": "Empresa <noreply@empresa.com>",
  "to": "usuario@gmail.com",
  "date": "2026-03-08T12:00:00.000Z",
  "text": "Seu código é 482910. Válido por 10 minutos.",
  "html": "<p>Seu código é <strong>482910</strong>...</p>",
  "links": ["https://empresa.com/confirmar?token=xyz"],
  "attachments": [
    {
      "fileRef": "referência do arquivo",
      "name": "boleto.pdf",
      "mimeType": "application/pdf",
      "sizeBytes": 18452
    }
  ]
}

Exemplos Práticos

Aguardar e-mail de confirmação de cadastro

[Clique em "Criar conta" no navegador]
    │
    ▼
[Email Inbox]
  Operação: Extract Email
  Subject Contains: "Confirme seu e-mail"
  From Contains: noreply@servico.com
  Timeout: 60000ms
    │
    ▼
[HTTP Request: GET {{ steps.emailInbox.outputs.links[0] }}]

Extrair OTP de 6 dígitos

[Clique em "Enviar código" no app]
    │
    ▼
[Email Inbox]
  Operação: Extract OTP
  Subject Contains: "código de verificação"
  OTP Min Length: 6
  OTP Max Length: 6
  Timeout: 30000ms
    │
    ▼
[Type no campo OTP: {{ steps.emailInbox.outputs.otp }}]

Extrair link de redefinição de senha

[Clique em "Esqueci minha senha"]
    │
    ▼
[Email Inbox]
  Operação: Extract Link
  Subject Contains: "redefinir senha"
  Link Domain Contains: accounts.empresa.com
  Timeout: 30000ms
    │
    ▼
[Navigate: {{ steps.emailInbox.outputs.link }}]

Ler anexo PDF recebido por e-mail

[Email Inbox]
  Operação: Extract Email
  Subject Contains: "boleto"
  Incluir anexos: true
  Nome do anexo contém: ".pdf"
    │
    ▼
[Extrair Arquivo]
  Arquivo: {{ steps.emailInbox.outputs.attachmentFileRef }}
  Tipo de extração: PDF

Configuração por Provedor

Gmail

Para Gmail com OAuth2, use o Connect OAuth (Browser) na tela de credencial. O Google exige que o URI de callback cadastrado no Console seja idêntico ao exibido no campo OAuth Callback URI.

Outlook / Microsoft 365

IMAP Customizado

Configure manualmente host, porta e modo de segurança (SSL/TLS).

Dicas

• Sempre use Received After Mode = Step Start — evita capturar e-mails anteriores ao teste
• Combine filtros — quanto mais específico (from + subject), mais confiável a detecção
• Marcar como lido — útil para evitar que o mesmo e-mail seja capturado em execuções seguidas
• Timeout 0 — executa apenas uma verificação sem aguardar; útil para assertivas em e-mails já recebidos
• OTP Regex customizado — use quando o código tiver formato não numérico ou esteja em contexto ambíguo (ex: código: ([A-Z0-9]{8}))