Integração · ESP / Email Marketing
Mautic é a alternativa open-source ao HubSpot/Marketo. Integre EmailChecker via webhook custom: a cada contact created, dispara validação e atualiza um custom field com o resultado.
Como integrar
Em Configuration > Custom Fields > Contact, adicione campo "email_status" do tipo Text.
Webhooks > New: trigger em "contact_post_save", URL pra um endpoint seu (Lambda, Cloudflare Worker, n8n) que vai chamar o EmailChecker.
Receba o payload do Mautic, extraia o email, chame POST /api/v1/validate/single no EmailChecker, pegue o result.
PATCH /api/contacts/{id} no Mautic com {"email_status": "deliverable"}. Use o status pra segmentar campanhas.
Exemplo · JAVASCRIPT
// Worker intermediário (Cloudflare Worker / AWS Lambda)
export default {
async fetch(req) {
const { contact } = await req.json();
const r = 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: contact.email }),
});
const data = await r.json();
// PATCH no Mautic com data.result
return new Response('OK');
}
}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
Segmento "email_status = deliverable" — só dispara campanha pra esses. Reduz hard bounce drasticamente.
Script externo paginando contacts via Mautic API → valida cada um no EmailChecker → atualiza email_status em batch.
Cron rodando a cada 3 meses revalida contacts com last_valid_check > 90 dias. Mantém base sempre fresca.
Troubleshooting
Os erros que mais aparecem ao conectar o Mautic — e como resolver cada um.
Por padrão o Mautic processa webhooks em fila, via cron. Se o mautic:webhooks:process (ou o "immediate dispatch") não estiver configurado, o evento nunca sai. Habilite o disparo imediato em Configuration > Webhook Settings ou agende o cron command; confira também se o webhook está "Published".
O alias do campo no PATCH precisa bater com o alias gerado (geralmente email_status), não com o label "Email Status". Veja o alias real em Custom Fields e use-o no corpo da Mautic API. Campos do tipo Select só aceitam valores da lista pré-definida — use Text pra aceitar deliverable/risky/undeliverable livremente.
A API REST vem desabilitada por padrão. Ative em Configuration > API Settings ("API enabled: Yes") e, pra PATCH em contatos, garanta que o usuário/OAuth tem permissão de edit em Contacts. Token OAuth2 expira — renove o access_token antes de assumir que a key está errada.
Comece grátis com 500 créditos. Sem cartão, sem compromisso.