Integração · ESP / Email Marketing
Mailchimp é a referência em email marketing. Use o Customer Journey + Webhook pra validar cada novo subscriber. Combine com a API do Mailchimp pra suprimir bounces em tempo real.
Como integrar
No Mailchimp, Automations > Customer Journey > Start from scratch. Trigger: "Subscriber joins audience".
Action > Send a webhook. URL: seu endpoint intermediário. Payload: inclui email do subscriber.
Seu endpoint chama POST /api/v1/validate/single no EmailChecker. Pega o result.
PATCH /lists/{list_id}/members/{subscriber_hash} com merge_fields.EMAIL_STATUS. Se undeliverable, considere mover pra "cleaned" ou tag de quarentena.
Exemplo · JAVASCRIPT
// Script Node.js pra limpar audiência inteira
const audienceId = 'abc123';
let offset = 0;
while (true) {
const r = await fetch(`https://us1.api.mailchimp.com/3.0/lists/${audienceId}/members?count=500&offset=${offset}`, {
headers: { Authorization: 'Basic ' + btoa('anystring:' + MC_API_KEY) }
});
const { members } = await r.json();
if (members.length === 0) break;
for (const m of members) {
const v = await fetch('https://app.emailchecker.email/api/v1/validate/single', {
method: 'POST',
headers: { Authorization: 'Bearer ' + EC_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ email: m.email_address })
});
const result = await v.json();
// PATCH pra atualizar EMAIL_STATUS no merge_fields
}
offset += 500;
}A API do EmailChecker é REST padrão com Bearer auth (`Authorization: Bearer <sua_api_key>`). Compatível com mails.so — se você já usa, troca só o base URL.
Casos de uso
Antes de campanha grande, valida toda audiência via script → arquiva contatos undeliverable. Bounce rate cai de 7% pra <0.5%.
Mailchimp cobra por subscriber ativo. Validar e suprimir bounces reduz a base e o custo mensal.
No plano free/standard do Mailchimp, você está em IP compartilhado. Bounces seus afetam todo mundo no IP — validar é responsabilidade compartilhada.
Troubleshooting
Os erros que mais aparecem ao conectar o Mailchimp — e como resolver cada um.
A API key do Mailchimp termina com o datacenter (ex: -us21) e o host precisa bater: chame https://us21.api.mailchimp.com, não us1. Use o sufixo da própria key como subdomínio. No Basic auth, o usuário pode ser qualquer string e a senha é a key — inverter isso também dá 401.
O subscriber_hash é o MD5 do email em minúsculas, não o email puro. Gere md5(email.toLowerCase()) antes de montar a URL /lists/{id}/members/{hash}. Um 404 quase sempre é hash de email não-normalizado (com maiúsculas) ou list_id errado.
O merge tag precisa existir na audiência (Settings > Audience fields and *|MERGE|* tags) com a tag em maiúsculas. Envie { "merge_fields": { "EMAIL_STATUS": "deliverable" } }. Em limpeza de base inteira, espace as chamadas — o Mailchimp aplica rate limit e devolve 429 sob rajada, o que aborta o PATCH silenciosamente.
Comece grátis com 500 créditos. Sem cartão, sem compromisso.