Listas de Contatos e Gestão de Audiência

No MailLeader, a gestão de públicos e audiências para newsletters, lançamentos e campanhas de marketing é centralizada no módulo de Listas de Contatos. As listas permitem organizar seus inscritos por interesse, origem, segmento de clientes ou projeto.

Conceitos Centrais

Lista: Uma coleção nomeada de contatos associada à sua conta de usuário.

Contato: Um registro de destinatário contendo endereço de e-mail normalizado, nome e metadados opcionais.

Elegibilidade de Envio: Apenas contatos com status subscribed (ativo) e que não estejam na lista de supressão são processados durante o disparo de campanhas.

Capacidade do Plano: O número máximo de contatos cadastrados e listas criadas respeita a franquia do seu plano de assinatura (consulte os limites na página de planos). A atualização de contatos existentes não consome nova cota.

Descadastros e bloqueios

Para proteger a reputação do seu domínio e respeitar a vontade de quem não quer mais receber, o MailLeader mantém uma lista de bloqueio por conta:

Vale para toda a conta:

Quem se descadastra deixa de receber de todas as listas da sua conta. Isso não afeta outras contas.

Bloqueio automático:

O contato é bloqueado quando:

Clica no link seguro de descadastro (Unsubscribe) de qualquer campanha do titular.

O servidor de e-mail de destino responde com um Hard Bounce permanente (ex: caixa postal inexistente).

Reimportar não desbloqueia:

Importar novamente um arquivo CSV, recriar a lista ou alterar o status via planilha não remove o bloqueio, para evitar reativações acidentais.

Verificação antes do envio:

Se alguém se descadastrar depois de a campanha ser criada, ela deixa de receber o envio, sem consumir da franquia.

Gerenciamento de Listas via Painel e API

1. Criar uma Nova Lista

Pelo Painel

Acesse Campanhas > Listas > Nova Lista, dê um nome descritivo (ex: Newsletter Semanal ou Clientes Ativos) e salve.

Pela API REST

POST /api/v1/lists

2. Adicionar Contato Individual

POST /api/v1/lists/{LIST_ID}/contacts

3. Importação em Lote (CSV ou JSON)

POST /api/v1/lists/{LIST_ID}/contacts/import

Você pode importar milhares de contatos em uma única operação. O MailLeader normaliza os e-mails (removendo espaços e convertendo para minúsculas), ignora duplicatas dentro da mesma lista e preserva contatos já suprimidos.

Formato do Arquivo CSV Recomendado

email,name
maria.souza@exemplo.com,Maria Souza
carlos.alberto@exemplo.com,Carlos Alberto
ana.paula@exemplo.com,Ana Paula

Envio via cURL

4. Consultar e Exportar Contatos

Listar Contatos: GET /api/v1/lists/{LIST_ID}/contacts?page=1&limit=50

Exportar Base: GET /api/v1/lists/{LIST_ID}/contacts/export (gera download da lista em formato CSV completo com data de inscrição e status).

Boas Práticas de Higienização de Base

Nunca Compre Listas: O envio para destinatários que não solicitaram expressamente a comunicação causará picos imediatos de denúncias de spam e bloqueio do domínio.

Utilize Double Opt-in: Confirme o interesse do usuário disparando um e-mail transacional com link de ativação logo após o preenchimento de formulários de captura.

Remova Contatos Inativos: Monitore contatos que não abrem mensagens há mais de 90 ou 180 dias e crie campanhas de reengajamento antes de removê-los.

Próximos Guias

Crie e dispare novidades no guia de Campanhas de E-mail.

Veja exemplos de integração em código no guia de Exemplos de Uso.

Consulte métricas de entrega em Desenvolvedores e API.

Listas de Contatos e Gestão de Audiência

Conceitos Centrais#

Descadastros e bloqueios#

Gerenciamento de Listas via Painel e API#

1. Criar uma Nova Lista#

Pelo Painel#

Pela API REST#

2. Adicionar Contato Individual#

3. Importação em Lote (CSV ou JSON)#

Formato do Arquivo CSV Recomendado#

Envio via cURL#

4. Consultar e Exportar Contatos#

Boas Práticas de Higienização de Base#

Próximos Guias#