Envio de E-mails via Protocolo SMTP

O MailLeader aceita envios de aplicações que suportam SMTP autenticado. Este guia mostra os dados de conexão e um exemplo com Nodemailer.

Parâmetros Oficiais de Submissão

Para conectar sua aplicação ao serviço de envio SMTP do MailLeader, utilize as seguintes credenciais e parâmetros:

Parâmetro	Valor Recomendado	Descrição / Detalhes
Servidor (Host)	`smtp.mailleader.com.br`	Hostname de submissão do ambiente atual. Confira os dados de conexão no painel.
Porta	`587`	Porta padrão RFC 6409 para submissão autenticada de e-mails.
Criptografia / Segurança	`STARTTLS` obrigatório	A conexão inicia em texto limpo e é promovida imediatamente para TLS seguro.
Autenticação SASL	Obrigatória (`PLAIN` ou `LOGIN`)	Requer autenticação antes de emitir o comando `MAIL FROM`.
Usuário (Username)	Seu e-mail completo	Exemplo: `contato@seudominio.com.br` ou `sistema@seudominio.com.br`.
Senha (Password)	Senha da conta	Senha configurada para o e-mail no painel do MailLeader.

Atenção sobre Portas e TLS:
Porta 587: Usa STARTTLS (no Node.js: secure: false, requireTLS: true). Não defina secure: true na porta 587, pois o modo TLS implícito pertence à porta 465.
Porta 25: Reservada exclusivamente para recebimento de servidores externos (MX). Conexões de clientes na porta 25 são rejeitadas.

Políticas de Segurança e Validação de Envelope

Para autenticar e enviar:

Correspondência SASL x Envelope:

O usuário autenticado na sessão SASL deve ser idêntico ao remetente declarado no comando MAIL FROM e no cabeçalho From:.

Não é permitido autenticar com usuarioA@dominio.com e enviar como usuarioB@dominio.com, exceto no caso de aliases expressamente autorizados.

Subendereçamento (Plus Addressing):

O MailLeader suporta tags de subendereçamento (ex: contato+alertas@seudominio.com.br e +lists). A normalização preserva a identidade de envio original.

Assinatura DKIM em Transporte:

O sistema aplica a assinatura DKIM configurada para o domínio. Uma alteração posterior no conteúdo da mensagem pode invalidar a assinatura.

Tracking de abertura:

Quando o tracking está disponível para a mensagem, o carregamento do pixel pode ser registrado. Proxies e recursos de privacidade também podem acioná-lo; isso não confirma leitura humana.

Ciclo de Vida da Mensagem e Códigos de Retorno SMTP

Ao submeter uma mensagem, o servidor SMTP do MailLeader responde com códigos de status padrão:

[Aplicação Cliente]                     [Servidor SMTP MailLeader]
        │                                         │
        ├────── EHLO seudominio.com.br ──────────►│
        │◄───── 250-STARTTLS ─────────────────────┤
        ├────── STARTTLS ────────────────────────►│
        │◄───── 220 Ready to start TLS ───────────┤
        │ (Negociação TLS segura 1.2 / 1.3)       │
        ├────── AUTH LOGIN / PLAIN ──────────────►│
        │◄───── 235 Authentication successful ────┤
        ├────── MAIL FROM:<contato@dominio.com> ─►│
        │◄───── 250 2.1.0 Ok ─────────────────────┤
        ├────── RCPT TO:<cliente@destino.com> ───►│
        │◄───── 250 2.1.5 Ok (destinatário aceito)┤
        ├────── DATA ────────────────────────────►│
        │◄───── 354 End data with <CR><LF>.<CR><LF>
        ├────── [Corpo da Mensagem] . ───────────►│
        │◄───── 250 2.0.0 Ok: queued as XXXXXXXX ─┤

Códigos de Retorno Canônicos

250 2.0.0 Ok: queued as [QueueID]:

A mensagem foi aceita e enfileirada para envio com sucesso.

O destinatário é registrado como aceito e conta como um envio nesse momento. Você vê o registro em GET /api/v1/mail/logs.

451 4.3.0 / 452 4.2.2 Deferral Temporário::

Ocorre quando o limite de envios do domínio foi atingido temporariamente. A mensagem fica na fila e é reenviada automaticamente.

535 5.7.8 Authentication failed::

Usuário ou senha incorretos, ou domínio suspenso.

550 5.7.1 Sender address rejected / Relay access denied::

O remetente informado não coincide com a conta autenticada, ou o domínio não está ativo e verificado no MailLeader.

Limites e estados de envio

As políticas de envio dependem da conta, do domínio e da configuração ativa. Uma resposta 250 confirma que o servidor aceitou a mensagem para processamento; não confirma entrega ao servidor destinatário. Consulte os estados de campanha e os webhooks para acompanhar atualizações posteriores.

Exemplo de Configuração Rápida em Node.js

Próximos Passos

Conheça a API RESTful para Desenvolvedores.

Receba confirmações de entrega com Webhooks.

Veja exemplos em Python, PHP, Go e cURL no guia de Exemplos de Uso.

Envio de E-mails via Protocolo SMTP

Parâmetros Oficiais de Submissão#

Políticas de Segurança e Validação de Envelope#

Ciclo de Vida da Mensagem e Códigos de Retorno SMTP#

Códigos de Retorno Canônicos#

Limites e estados de envio#

Exemplo de Configuração Rápida em Node.js#