EmailCheckerEmailChecker

Integração · ESP / Email Marketing

EmailChecker + Mautic

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

4 passos pra conectar

  1. 1

    Crie um campo customizado "email_status"

    Em Configuration > Custom Fields > Contact, adicione campo "email_status" do tipo Text.

  2. 2

    Crie um webhook em Settings

    Webhooks > New: trigger em "contact_post_save", URL pra um endpoint seu (Lambda, Cloudflare Worker, n8n) que vai chamar o EmailChecker.

  3. 3

    No endpoint intermediário, valide o email

    Receba o payload do Mautic, extraia o email, chame POST /api/v1/validate/single no EmailChecker, pegue o result.

  4. 4

    Atualize o contact via Mautic API

    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

Quando usar essa integração

Suprimir bounces antes de campanhas

Segmento "email_status = deliverable" — só dispara campanha pra esses. Reduz hard bounce drasticamente.

Limpar base existente em massa

Script externo paginando contacts via Mautic API → valida cada um no EmailChecker → atualiza email_status em batch.

Higienização periódica trimestral

Cron rodando a cada 3 meses revalida contacts com last_valid_check > 90 dias. Mantém base sempre fresca.

Troubleshooting

Problemas comuns

Os erros que mais aparecem ao conectar o Mautic — e como resolver cada um.

O webhook contact_post_save não dispara

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 custom field email_status não aceita o valor

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 Mautic API responde 403 mesmo com credenciais certas

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.

Mais integrações

Outras ferramentas suportadas

Comece agora

Pronto pra parar de mandar email pra endereço morto?

Comece grátis com 500 créditos. Sem cartão, sem compromisso.