Chaves de API e domínios
Crie chaves de API, configure domínios e remetentes, acompanhe os envios e cadastre webhooks. Entre com a conta cadastrada no MailLeader.
Infraestrutura de E-mail Transacional
E-mail transacional do seu sistema, por SMTP ou API REST.
Conecte seu ERP, sua loja ou sua aplicação por SMTP autenticado ou por API REST. Cada mensagem é assinada com DKIM, sai por um IP separado do marketing e deixa um registro por destinatário, consultável no painel, na API e por webhooks.
SMTP na porta 587 com STARTTLSAPI REST com chave x-api-keySPF, DKIM e DMARC por domínioWebhooks assinados com HMAC
NF-e nº 10492 + boleto
ERP ➔ cliente
Destinatário:financeiro@cliente.example.com
Remetente:nfe@auroracosmeticos.com.br
Anexos:DANFE.pdf•NFe10492.xml
Submissão SMTP · 250 2.0.0 queued13:00:11
Assinatura DKIM aplicada13:00:11
Aceito pelo servidor destinatário · smtp.email.delivered13:00:12
SPF, DKIM e DMARC verificadosexemplo ilustrativo
SMTP :587
STARTTLS obrigatório; TLS 1.2 e 1.3
REST v1
POST /api/v1/mail/send com x-api-key
HMAC-SHA256
Assinatura em cada chamada de webhook
Logs
Estado e horário de cada evento, por destinatário
Casos de uso
O que são e-mails transacionais e onde usar?
São comunicações geradas diretamente pelos seus softwares, lojas ou rotinas de gestão. O destinatário espera recebê-las para concluir uma etapa do processo.
Notas fiscais (DANFE e XML)
Envie o PDF da DANFE e o XML da NF-e ao cliente e à contabilidade quando o ERP emitir a nota. Os anexos seguem pelo SMTP ou pela API, em multipart.
Gatilho: emissão no ERP
Boletos e faturas de cobrança
Envie a fatura com linha digitável ou chave PIX e lembretes antes do vencimento. O registro mostra se o servidor do destinatário aceitou a mensagem.
Gatilho: rotina de cobrança
Pedidos e e-commerce
Confirmação de pagamento, mudança de status do pedido e código de rastreio, disparados pela loja a cada evento.
Gatilho: webhook da loja
Códigos de acesso e senhas
Códigos de verificação, links de login e de recuperação de senha, enviados individualmente quando o usuário os solicita.
Gatilho: ação do usuário
Alertas de sistemas
Alertas de monitoramento e relatórios diários de fechamento para as equipes de operação e de produto.
Gatilho: monitoramento ou cron
Recibos e comprovantes
Recibos de pagamento e comprovantes de aceite de termos, com o histórico por destinatário disponível no painel.
Gatilho: pagamento confirmado
Arquitetura de envio
Por que você deve separar o transacional do marketing?
Campanhas geram descadastros e reclamações que afetam a reputação do IP de saída. O MailLeader associa cada finalidade a um IP próprio, para que o transacional não herde essa reputação.
Canal Crítico
E-mail Transacional
- 1 para 1: Disparado individualmente após um evento real (venda, emissão, cadastro).
- Sensível a atraso: O destinatário aguarda a mensagem para pagar ou acessar.
- IP de saída próprio: A finalidade transacional usa o IP atribuído a ela, separado do marketing.
- Limites previsíveis: Limites de vazão por domínio, conta e destino se aplicam; mensagens adiadas ficam na fila e são reenviadas.
Canal de Engajamento
E-mail Marketing & Campanhas
- 1 para Muitos: Envios em massa para listas segmentadas de leads e clientes.
- Foco em Vendas: Promoções, newsletters periódicas e campanhas sazonais.
- Consentimento Obrigatório: Exige cabeçalho de descadastro em 1 clique (RFC 8058).
- Métricas de Conversão: Taxas de abertura, mapas de cliques e pontuação no lead scoring.
Na prática: as duas finalidades ficam na mesma conta. Cada domínio ou remetente é configurado como transacional ou marketing, e o roteamento do IP de saída segue essa escolha. A atribuição dos IPs é feita pela equipe do MailLeader.
Integração
Dois caminhos: SMTP ou API REST
Use SMTP autenticado em qualquer sistema que permita configurar um servidor de e-mail, ou a API REST para enviar JSON a partir do seu código.
SMTP autenticado
ERPs, lojas virtuais e sistemas legados que aceitam SMTP
Informe estes dados nas configurações de e-mail do software. O usuário é o endereço completo do remetente e a senha é a da conta, definida no painel.
Servidor SMTP:smtp.mailleader.com.br
Porta:587 (STARTTLS)
Autenticação:Obrigatória (e-mail completo e senha da conta)
Criptografia:TLS 1.2 / TLS 1.3
O endereço do From deve ser o mesmo usuário autenticado.
API REST & Webhooks
JSON sobre HTTPS, com exemplos em cURL, Node.js e Python
Para aplicações modernas que precisam de payloads JSON e webhooks assinados. Anexos pela API ou pelo SMTP.
# Exemplo de requisição HTTP POST
curl -X POST https://mailleader.com.br/api/v1/mail/send \
-H "x-api-key: $MAILLEADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "nfe@auroracosmeticos.com.br",
"fromName": "Aurora Cosméticos",
"to": "marina.souza@example.com",
"subject": "Nota fiscal do pedido #10482",
"html": "<p>Sua nota fiscal está disponível no painel.</p>"
}'Webhooks para aceite, entrega, adiamento, rejeição, abertura e clique.
Código
Exemplos para copiar e rodar
Não há SDK para instalar. A API é JSON sobre HTTPS e o SMTP funciona com qualquer biblioteca padrão, como Nodemailer e smtplib.
terminal
# Defina MAILLEADER_API_URL como https://mailleader.com.br/api/v1
curl -X POST "$MAILLEADER_API_URL/mail/send" \
-H "x-api-key: $MAILLEADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "contato@auroracosmeticos.com.br",
"fromName": "Aurora Cosméticos",
"to": "marina.souza@example.com",
"subject": "Pedido #10482 confirmado",
"html": "<p>Olá, Marina! Recebemos o pagamento do seu pedido.</p>"
}'POST /api/v1/mail/send · JSON · x-api-key
Defina MAILLEADER_API_KEY com uma chave criada no painel. A documentação completa está em doc.mailleader.com.br.
Referência rápida
Endpoints, códigos SMTP e webhooks
API REST v1
Autenticação com o cabeçalho x-api-key
- POST /api/v1/mail/send
- Envia uma mensagem em JSON. Responde com messageId, accepted e rejected.
- GET /api/v1/mail/logs
- Consulta o registro de envios, com filtros de página, limite e status.
- POST /api/v1/mail/logs/export
- Exporta o registro de envios.
- POST /api/v1/webhook
- Cria um webhook. O secret é exibido uma única vez.
- POST /api/v1/webhook/{id}/test
- Enfileira um evento de teste, webhook.test.
Respostas do SMTP
Porta 587 com STARTTLS e autenticação
- 250 2.0.0 Ok: queued
- A mensagem foi aceita e está na fila. Não confirma a entrega.
- 451 / 452
- Adiada: limite de vazão atingido ou IP em aquecimento. A mensagem fica na fila e é reenviada.
- 535 5.7.8
- Falha de autenticação: usuário ou senha incorretos, ou domínio suspenso.
- 550 5.7.1
- Remetente recusado: o From difere do usuário autenticado ou o domínio não está ativo.
Webhooks
Assinatura HMAC-SHA256 em cada chamada
- smtp.email.*
- accepted, queued, rejected, delivered, deferred, bounced, expired, opened e clicked.
- x-mailleader-signature
- sha256= seguido do HMAC de timestamp + "." + corpo bruto.
- x-mailleader-event-id
- Identifica o evento. Use para deduplicar tentativas repetidas.
- Retentativas
- Resposta diferente de 2xx gera até 10 tentativas, a partir de 30 s, com espera exponencial.
Visão técnica
O que acontece com cada mensagem
Autenticação por domínio
Registros SPF, DKIM e DMARC verificados antes de ativar o domínio. A assinatura DKIM é aplicada no transporte.
Fila com retentativas
Quando o servidor de destino responde com um erro temporário (4xx), a mensagem permanece na fila de envio e é reenviada. Limites de vazão também podem adiar o envio.
Registro por destinatário
Estado e horário de cada evento, até o aceite no servidor de destino. Aceite não prova leitura.
Aquecimento e limites
Novos IPs passam por aquecimento com limites por provedor, para construir reputação de forma gradual.
Planos e recursos
Planos pelo volume de envio do seu sistema.
Compare franquias, endereços de envio e integrações para seu sistema.
Já tem uma conta?
Credenciais e documentação.
Gere chaves de API e consulte os endpoints, os exemplos e os códigos de erro.
Documentação da API
Endpoints, parâmetros, exemplos em cURL, Node.js e Python, validação de webhooks e códigos de retorno SMTP.
Abrir a documentação (abre em nova aba)Contato
Fale com a nossa equipe.
Dúvidas sobre integração, limites de envio ou IP dedicado? A equipe responde pelo canal que você preferir.
Tire suas dúvidas
Perguntas frequentes
Qual a diferença entre e-mail transacional e e-mail marketing?↓
O transacional é uma mensagem individual disparada por um evento do seu sistema, como a emissão de uma nota, um pedido pago ou um pedido de nova senha. O marketing é enviado a listas, exige consentimento e descadastro em um clique. Aqui os dois usam a mesma conta, mas cada domínio ou remetente tem uma finalidade, e o roteamento do IP de saída segue essa finalidade.
Como conecto meu ERP ou minha loja virtual?↓
Em qualquer sistema que permita configurar um servidor de e-mail, use o host smtp.mailleader.com.br, a porta 587 com STARTTLS, o endereço completo do remetente como usuário e a senha da conta definida no painel. O endereço do campo From deve ser o mesmo usuário autenticado; caso contrário o envio é recusado.
Posso usar vários remetentes, como nfe@ e financeiro@?↓
Sim, desde que o domínio esteja verificado (SPF, DKIM e DMARC) e que cada endereço exista como conta de envio. A quantidade de endereços de envio depende do plano; consulte os limites na tabela de planos.
Posso enviar anexos como PDF e XML?↓
Sim. Pelo SMTP o limite padrão é de 16 MiB por mensagem, somando o corpo e os anexos. Pela API REST v1, envie em multipart/form-data com até 10 arquivos de 10 MiB cada.
Por que algumas mensagens ficam adiadas?↓
Quando o limite de vazão do domínio ou do destino é atingido, ou quando o IP está em aquecimento, o servidor responde com um código 4xx. A mensagem permanece na fila e é reenviada automaticamente. Você acompanha o estado no registro de envios e pelo evento smtp.email.deferred.
Como a reputação do transacional fica separada do marketing?↓
Cada finalidade usa o IP de saída atribuído a ela. Um envio de marketing sem IP configurado falha temporariamente em vez de sair pelo IP transacional. A atribuição dos IPs é feita pela equipe do MailLeader.
Existem webhooks e registros de entrega?↓
Sim. Há registro por destinatário no painel e na API (GET /api/v1/mail/logs) e webhooks assinados com HMAC-SHA256 para aceite, fila, entrega, adiamento, rejeição, expiração, abertura e clique. Entregue significa que o servidor do destinatário aceitou a mensagem; não confirma que ela chegou à caixa de entrada nem que foi lida.
Pronto para conectar seu sistema?
Crie a conta, verifique o domínio no DNS e use as credenciais SMTP ou uma chave de API.