Integração n8n + Mautic: automação de marketing na prática
Como ligar o n8n ao Mautic por webhook e API REST, com cinco fluxos que valem a pena — lead scoring com IA, segmentação por comportamento e sincronia com o CRM.

Automação de marketing esbarra sempre no mesmo limite: a ferramenta faz bem o que faz, mas não fala com o resto do seu stack. O Mautic dá conta de e-mail, formulários e nutrição; o n8n é a peça que o conecta a CRM, WhatsApp, planilhas e IA — por API, sem plugin e sem código amarrado. Juntos, deixam de ser uma lista que alguém atualiza na mão e viram um funil que reage a comportamento em tempo real.
Este guia mostra como ligar os dois e cinco fluxos que valem a pena montar — do lead scoring com IA à sincronia com o CRM —, com honestidade sobre custo, limites e onde a automação atrapalha mais do que ajuda.
Por que ligar o n8n ao Mautic
O Mautic é forte no que se propõe, mas sozinho não fala nativamente com WhatsApp, Telegram, ERPs ou APIs próprias. O n8n preenche essa lacuna: constrói pontes entre o Mautic e praticamente qualquer ferramenta que exponha uma API.
| Capacidade | Só o Mautic | Mautic + n8n |
|---|---|---|
| E-mail marketing | Sim | Sim, com fluxo condicional em volta |
| Lead scoring | Regras de pontos | Pontos + classificação por IA |
| SMS / WhatsApp | Via plugin | Via nó Twilio no n8n |
| Integração com ERP | Limitada | Sob medida por API |
| IA generativa | Não | Sim (OpenAI, Anthropic) |
Setup: conectando os dois
1. Habilitar a API e criar credenciais no Mautic
Primeiro ligue a API: em Configurações → Configurações da API, marque a API como habilitada. Depois crie o acesso em Configurações → Credenciais de API, escolhendo OAuth 2 (ou Basic Auth de um usuário, para testes). Guarde o Client ID e o Client Secret — é o que o n8n vai usar.
2. Subir o n8n (nuvem ou self-hosted)
- Self-hosted (controle total): Docker no seu servidor, gratuito e com os dados na sua casa. Exige um mínimo de mão técnica.
- n8n Cloud (sem gerir servidor): serviço hospedado pela própria n8n, pago por execução, pronto em minutos.
Para automação que mexe em base de contatos, a versão self-hosted costuma ser a escolha por LGPD — os dados não saem do seu servidor.
3. Criar a credencial do Mautic no n8n
No n8n, adicione uma credencial do Mautic com a URL da sua instância e as chaves do passo 1, e teste a conexão. A partir daí, o nó Mautic oferece operações prontas — criar contato, atualizar contato, adicionar a um segmento, editar pontos — e o Mautic Trigger escuta os webhooks. A documentação oficial do nó Mautic no n8n lista todas as operações disponíveis.
Fluxo 1: lead scoring com apoio de IA
O scoring nativo do Mautic é baseado em regras de pontos. Dá para enriquecê-lo com o n8n e um modelo de IA que lê o contexto do lead antes de pontuar.
O fluxo:
- O lead preenche um formulário no Mautic.
- O Mautic Trigger entrega o evento ao n8n por webhook.
- Um nó de IA (OpenAI ou Anthropic) ou uma chamada HTTP avalia o contexto: perfil de compra ou curiosidade?
- O nó Mautic edita os pontos do contato e o adiciona ao segmento certo.
- O contato quente entra numa campanha de nutrição no próprio Mautic.
Um modelo de pontuação simples, só como ilustração:
- E-mail corporativo: +2 pontos
- Visitou a página de preços 3+ vezes: +3 pontos
- Abriu as duas últimas campanhas: +2 pontos
- Passou mais de 5 min no site: +1 ponto
O valor não é a fórmula em si — é o lead ser triado no momento em que chega, sem fila humana.
Fluxo 2: segmentação por comportamento
Em vez de segmentos estáticos, o n8n reage a eventos e ajusta a lista quase em tempo real.
Exemplo: um contato que abriu cinco ou mais e-mails nos últimos sete dias vai para um segmento de maior interesse.
Como fica no n8n:
- Gatilho: evento de e-mail aberto, capturado pelo Mautic Trigger
- Lógica: contar as aberturas recentes consultando a API do Mautic
- Ação: se passar do limite, adicionar o contato ao segmento pela operação adicionar a um segmento
- Sequência: o Mautic dispara a campanha ligada àquele segmento
Fluxo 3: personalização de conteúdo com IA
Cada contato recebe um trecho de e-mail gerado sob medida, sem escrever dez variações à mão.
Cenário ilustrativo: uma base grande, dividida em vários segmentos. Em vez de redigir uma versão por segmento, a IA gera a abertura personalizada a partir dos dados do contato.
Prompt de exemplo enviado ao modelo pelo n8n:
"Escreva um parágrafo de abertura para um e-mail de vendas. Destinatário: {contato.nome}, cargo: {contato.cargo}, empresa: {contato.empresa}, segmento: {contato.segmento}. Tom profissional e amigável, no máximo três linhas."
O truque que o torna real: o n8n grava o texto gerado num campo personalizado do contato e o template de e-mail do Mautic referencia esse campo por token. O disparo continua sendo do Mautic — o n8n só preenche o conteúdo.
Fluxo 4: sincronia bidirecional com o CRM
Quando o CRM é a fonte da verdade, o n8n mantém os dois lados em dia. O nó Mautic combina com os nós de HubSpot, Salesforce ou Pipedrive.
| Evento | Ação |
|---|---|
| Contato criado no CRM | Cria o contato no Mautic |
| Negócio ganho no CRM | Move para o segmento "Cliente" no Mautic |
| E-mail aberto no Mautic | Atualiza o engajamento no CRM |
| Contato removido em um lado | Remove no outro (higiene de base e LGPD) |
Se você ainda não tem esse trilho, o guia de integração do Mautic com site e CRM cobre a base.
Fluxo 5: qualificação por WhatsApp
Uma alternativa ao e-mail: o nó Twilio no n8n envia mensagens de WhatsApp ligadas ao Mautic.
- O lead preenche um formulário no Mautic.
- O n8n dispara pelo Twilio: "Olá {nome}, recebemos seu contato…".
- Se a pessoa responde, um webhook devolve o evento e o Mautic aplica a tag "Respondeu".
- O e-mail de acompanhamento sai para quem interagiu.
Para montar o outro lado desse fluxo, veja a integração do WhatsApp com o Mautic.
Webhooks: o gatilho da integração
O webhook é o que faz o Mautic "empurrar" eventos para o n8n no momento em que acontecem, em vez de o n8n ficar perguntando.
Entre os eventos que o Mautic pode enviar:
- Contato criado, atualizado ou apagado
- Pontos do contato alterados
- E-mail aberto
- Formulário enviado
- Página visitada
Configuração: em Configurações → Webhooks, crie um webhook apontando para a URL que o Mautic Trigger gera no n8n e marque os eventos que interessam. Se webhook ainda é território novo, o artigo como os webhooks funcionam ajuda a fixar o conceito.
Limites e custos, sem romance
- Custo: self-hosted, os dois são gratuitos — você paga o servidor. O que pode pesar são as APIs de IA e o serviço de e-mail, conforme o volume; o n8n Cloud, se optar por ele, cobra por execução.
- Rate limits: respeite os limites de API do seu servidor Mautic e prefira operações em lote no n8n a rajadas de chamadas.
- Latência: o webhook é quase instantâneo, mas o processamento dentro do n8n pode levar alguns segundos.
- Depuração: o n8n registra cada execução; use isso para rastrear falhas antes de culpar a integração.
Segurança: proteger os dados em trânsito
Ao trafegar dados entre o Mautic e o n8n:
- Use HTTPS sempre — atrás de um proxy reverso no self-hosted, ou já embutido no n8n Cloud
- Valide a origem do webhook (segredo/assinatura configurados no Mautic)
- Nunca deixe chaves de API expostas no fluxo; use as credenciais e variáveis de ambiente do n8n
- Mantenha logs de auditoria nos dois sistemas
Perguntas frequentes
O n8n é melhor que o Zapier para integrar o Mautic?
Depende do volume. O Zapier é mais simples de começar; o n8n ganha quando você precisa de muitos fluxos, controle dos dados e IA no meio do caminho — no self-hosted não há cobrança por execução, você paga só o servidor. Para poucos gatilhos ocasionais, o Zapier resolve com menos esforço. A comparação detalhada está em n8n vs Zapier vs Make.
Preciso saber programar para usar o n8n com o Mautic?
Não para o básico. O nó Mautic já traz operações prontas (criar contato, atualizar, adicionar a segmento, editar pontos), então a maior parte se monta na interface visual. Saber um pouco de JavaScript ajuda a tratar dados e exceções em fluxos mais avançados.
Quanto tempo leva para a integração dar retorno?
O retorno mais concreto aparece cedo: o lead recebe resposta em segundos, de madrugada ou no fim de semana, sem depender de alguém online, e o trabalho de copiar dado entre ferramentas some. Ganho de conversão varia demais de contexto para prometer número — meça o antes e o depois no seu funil.
Como faço para depurar um fluxo que não funciona?
O n8n guarda cada execução e deixa reexecutar passo a passo, mostrando o que entrou e saiu de cada nó. Confira também os logs do Mautic e teste a chamada de API isolada antes de plugar no fluxo. Antes de ativar, rode em modo de teste com dados fictícios.
A integração funciona com o Mautic 5 e o Mautic 7?
Sim. O n8n conversa com o Mautic pela API REST e por webhooks, presentes nas duas versões. Ao migrar de major, revalide as credenciais e um fluxo de cada tipo antes de confiar em tudo — mudanças pontuais na API podem exigir ajuste. O que muda na versão nova está em Mautic 7: novidades.
Por onde começar
Não monte cinco fluxos de uma vez. Suba um — captura de lead → pontuação → e-mail — e deixe rodando. É o de maior retorno e o que ensina a lógica da integração. Com ele estável, expanda para uma campanha de drip simples e, depois, para os padrões de automação de marketing com n8n e IA. Para dominar o lado do Mautic antes de automatizar, o guia definitivo do Mautic é o ponto de partida.


