Campanhas de e-mail

Uma campanha envia uma mensagem para uma lista. O MailLeader fixa o público no momento da publicação e cria uma tentativa individual para cada contato elegível.

Criar pelo painel

Escolha uma lista e confira o tamanho do público elegível.

Defina remetente, assunto, texto ou HTML; use um template salvo se desejar.

Revise a mensagem e envie um teste para um endereço que você controla.

Salve como rascunho, envie agora ou escolha uma data futura.

Acompanhe aceites, falhas, ignorados e resultados ainda não confirmados no detalhe da campanha.

Um contato só entra no público se estiver inscrito na lista e não estiver suprimido para aquela conta. Descadastros e bounces não devem ser contornados importando o contato novamente.

Criar ou publicar pela API

Use POST /api/v1/mail/campaigns/compose. As rotas privadas aceitam x-api-key ou Authorization: Bearer <token>.

{
  "name": "Novidades de outubro",
  "from": "novidades@empresa.com.br",
  "fromName": "Equipe da Empresa",
  "listId": "ID_DA_LISTA",
  "subject": "O que há de novo",
  "html": "<h1>Novidades</h1><p>Confira as atualizações.</p>",
  "text": "Novidades: confira as atualizações.",
  "mode": "draft"
}

Para enviar agora, use "mode":"send". Para agendar, use também "scheduledAt":"2026-11-01T13:00:00.000Z"; a data deve estar no futuro e incluir fuso horário. O contrato público da API v1 para campanhas aceita conteúdo em texto e HTML e, em multipart/form-data, anexos no campo attachments (até 10 arquivos de 10 MiB).

O remetente precisa pertencer à conta e estar disponível para envio. É necessário informar uma lista e pelo menos um entre html e text. Repetir a publicação de um rascunho que já foi publicado não cria outra campanha.

Enviar um teste

POST /api/v1/mail/campaigns/test usa os mesmos campos de mensagem e exige to com o endereço que receberá o teste. O envio de teste não é o envio da campanha para a lista.

Consultar campanhas

Rota	Uso
`GET /api/v1/lists/campaigns`	Campanhas da conta; opcionalmente filtre por `listId`.
`GET /api/v1/lists/campaigns/drafts/{draftId}`	Carregar um rascunho para continuar editando.
`GET /api/v1/lists/{listId}/campaign-audience`	Consultar total da lista, elegíveis e excluídos.
`GET /api/v1/lists/{listId}/campaigns/{campaignId}`	Detalhes e métricas da campanha.
`GET /api/v1/lists/{listId}/campaigns/{campaignId}/messages`	Consultar destinatários; aceita busca `q` e filtro `status`.

Os estados dos destinatários incluem pending, submitting, submitted, failed, skipped e unknown. submitted significa que o servidor SMTP aceitou a mensagem para envio; não confirma que ela chegou à caixa de entrada. unknown indica resultado que não pôde ser confirmado com segurança, e não deve ser interpretado como sucesso ou reenviado automaticamente.

Métricas e leitura dos resultados

Público total: destinatários elegíveis fixados quando a campanha foi publicada.

Aceitos para envio: destinatários aceitos pelo servidor SMTP. Esse aceite é a unidade usada no registro de envio.

Falhas: tentativas que terminaram em falha confirmada.

Ignorados: contatos excluídos das tentativas da campanha.

Pendentes ou em processamento: destinatários ainda na fila ou sendo enviados.

A confirmar: resultado SMTP ambíguo, por exemplo se a conexão caiu durante a submissão.

Entrega, bounce, abertura e clique são eventos de tracking separados e podem chegar depois que o processamento da campanha termina. Aberturas podem ser acionadas por proxies de imagem; cliques são detectados por redirecionamento e não comprovam interação humana. Consulte Webhooks para receber esses eventos.

Descadastro

As campanhas usam os mecanismos de descadastro disponíveis na mensagem e nas políticas da conta. A lista de supressão do titular é aplicada à elegibilidade do público. Não prometa que um único formato de cabeçalho será exibido por todos os provedores; a apresentação depende do cliente de e-mail.

Eventos de campanha

Você pode selecionar estes eventos em Desenvolvedor > Webhooks:

Evento	Quando acontece
`campaign.created`	Uma campanha nova ou rascunho é criado.
`campaign.queued`	A campanha é publicada, inclusive quando agendada.
`campaign.started`	O primeiro destinatário começa a ser processado.
`campaign.completed`	O processamento termina sem falhas confirmadas ou resultados a confirmar.
`campaign.failed`	O processamento termina com falhas ou resultados a confirmar.
`smtp.email.accepted`	Um destinatário é aceito para envio.

Os eventos de conclusão informam contadores do processamento; não afirmam entrega, leitura ou conversão. Veja Webhooks para o envelope e a validação HMAC.

Templates

Crie e gerencie conteúdo reutilizável em Marketing > Templates. Um template carregado na campanha é copiado para o rascunho dessa campanha. Alterar o template salvo depois não modifica campanhas já criadas. Consulte Templates de e-mail.