Como integrar o Mautic com o seu site ou CRM

Integrar o Mautic ao seu site e ao CRM da empresa é o passo que transforma a plataforma de um simples disparador de e-mails no hub central da sua operação de marketing e vendas. A tese em uma frase: sem integração, o Mautic vive isolado; com o site alimentando contatos e o CRM recebendo oportunidades já qualificadas, ele passa a ligar marketing e vendas num fluxo automático — e continua de graça, porque o Mautic é open source.

Neste guia você vai integrar o Mautic ao seu site (WordPress ou qualquer outra plataforma) e aos CRMs do mercado, usando desde os plugins que já vêm embarcados na ferramenta até webhooks, a API REST e plataformas de automação como o n8n. O caminho completo, da primeira visita à oportunidade no comercial, é este:

Integrando o Mautic ao seu site

A integração com o site é o ponto de partida de qualquer operação com o Mautic. É por ela que o rastreamento de visitantes e a captura de leads acontecem.

Passo 1: Instalar o script de tracking

O script de tracking do Mautic precisa carregar em todas as páginas do seu site. Você encontra o snippet nas configurações da plataforma, em Configurações (engrenagem, canto superior direito) → Configuration → Tracking Settings. O código é este:

<script>
(function(w,d,t,u,n,a,m){w['MauticTrackingObject']=n;
w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)},a=d.createElement(t),
m=d.getElementsByTagName(t)[0];a.async=1;a.src=u;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://seu-mautic.com.br/mtc.js','mt');
mt('send', 'pageview');
</script>

Cole-o antes do fechamento da tag </body> em todas as páginas. Em sites com CMS, use os campos de "scripts personalizados" do tema ou um plugin de injeção de código.

Passo 2: Incorporar formulários no site

Crie os formulários em Components → Forms → New e use o embed code que o Mautic gera para inseri-los nas páginas. Há duas formas:

• iFrame embed: mais simples, mas limita a customização visual e pode dar conflito de conteúdo misto (HTTP dentro de HTTPS).
• Script embed: injeta o formulário direto no HTML da página, respeitando o CSS do site. É a forma recomendada.

Integração com WordPress

O WordPress é a plataforma de site mais usada em conjunto com o Mautic. A integração é feita pelo plugin oficial, gratuito no repositório WordPress.org.

Instalando o plugin Mautic for WordPress

1. No painel do WordPress, acesse Plugins → Adicionar Novo.
2. Busque por "Mautic for WordPress" (mantido pela comunidade do Mautic).
3. Instale e ative o plugin.
4. Vá em Configurações → Mautic e informe a URL da sua instância.

Com o plugin ativo, o script de tracking é injetado automaticamente em todas as páginas e você passa a exibir formulários e focus items por shortcode em posts e páginas.

Shortcodes disponíveis

• [mautic type="form" id="X"] — exibe o formulário de ID X.
• [mautic type="focus" id="X"] — exibe o focus item (pop-up, barra ou modal) de ID X.
• [mautic type="content" slot="nome"]conteúdo padrão[/mautic] — exibe conteúdo dinâmico personalizado para o contato identificado.

Integração do Mautic com CRMs

A integração com o CRM fecha o ciclo entre marketing e vendas: o Mautic qualifica os leads, o CRM cuida da negociação e do fechamento.

Integrações nativas (via Configurações → Plugins)

Alguns CRMs já vêm com plugin embarcado no núcleo do Mautic. Nesses casos, o processo é direto:

1. Acesse Configurações (engrenagem) → Plugins e encontre o plugin do seu CRM.
2. Clique em "Install/Upgrade" e depois em "Publish/Enable".
3. Informe as credenciais de API do CRM (geralmente client ID, client secret e URL, conforme o método de autenticação).
4. Faça o mapeamento de campos: qual campo do Mautic corresponde a qual campo do CRM.
5. Defina a direção da sincronização (Mautic → CRM, CRM → Mautic ou bidirecional, quando o plugin suportar).

O Mautic também traz plugins embarcados para vTiger e Connectwise. Para qualquer CRM fora dessa lista — incluindo Pipedrive, SuiteCRM e RD Station — a ligação é feita por webhook, pela API REST ou por uma ferramenta de automação.

Integração via webhook (qualquer CRM)

Para CRMs sem plugin nativo, use os webhooks do Mautic. Configure em Configurações (engrenagem) → Webhooks → New:

1. Defina a URL do endpoint do CRM que vai receber os dados.
2. Escolha os eventos que disparam o webhook (por exemplo, Contact Points Changed ou Form Submit).
3. O Mautic envia o payload em JSON com os dados do contato e do evento.
4. No CRM, configure o endpoint para receber esse payload e criar ou atualizar o lead ou a oportunidade.

Por padrão, o Mautic pode enfileirar os webhooks e processá-los pelo cron mautic:webhooks:process — por isso é importante ter o cron do Mautic rodando para que os disparos não fiquem parados na fila.

Integração via n8n (a melhor relação custo-benefício)

O n8n é uma plataforma de automação open source que tem um nó pronto para o Mautic. Com o n8n rodando no mesmo servidor do Mautic ou em um VPS separado, você conecta o Mautic a centenas de ferramentas — CRMs, planilhas, Slack, WhatsApp — sem custo de licença e com total controle sobre os dados. É a escolha natural para quem já roda o Mautic self-hosted e quer evitar a dependência de serviços pagos como o Zapier.

Fluxo de integração Mautic → CRM na prática

Um fluxo típico de integração entre Mautic e CRM funciona assim:

1. O lead preenche um formulário no site, vira contato no Mautic e entra em uma campanha de nutrição.
2. O Mautic rastreia o comportamento (páginas visitadas, e-mails abertos, cliques) e ajusta a pontuação do contato.
3. Ao atingir o total de pontos definido, um Point Trigger empurra o contato para o CRM (ação push to a CRM) ou o adiciona a um segmento que a integração sincroniza.
4. O CRM cria a oportunidade com os dados do lead (nome, e-mail, empresa, pontuação).
5. O vendedor recebe a notificação no CRM e inicia a abordagem comercial.
6. Fechado o negócio, o CRM chama a API REST do Mautic para marcar o contato com a tag "cliente", removê-lo das campanhas de aquisição e iniciar a campanha de onboarding.

Perguntas frequentes sobre integração do Mautic

O que acontece se o mesmo contato existir no Mautic e no CRM ao mesmo tempo?

As integrações nativas do Mautic usam o e-mail como chave de identificação. Se um contato com o mesmo e-mail já existe nos dois sistemas, a sincronização atualiza o registro em vez de criar um duplicado. Vale padronizar o campo de e-mail e garantir que ele esteja sempre preenchido antes de sincronizar.

Posso sincronizar campos customizados do Mautic com campos customizados do CRM?

Sim. Na tela de mapeamento de campos da integração (Configurações → Plugins → nome do CRM), você associa cada campo customizado do Mautic a um campo correspondente no CRM. Assim dá para levar dados específicos do negócio, como "Produto de interesse", "Porte da empresa" ou "Origem do lead".

A integração Mautic + CRM funciona em tempo real?

Depende do método. Webhooks são quase instantâneos: em modo de fila, o Mautic dispara o POST assim que o cron de webhooks processa a fila. Já os plugins nativos que sincronizam por cron periódico têm a defasagem do intervalo que você agendar. Para casos críticos, como avisar o comercial de um lead pronto, prefira webhooks.

Como depurar problemas de integração entre Mautic e CRM?

Olhe os logs do Mautic em var/logs/mautic_prod.log e o histórico de cada webhook na própria tela do webhook, que registra as tentativas e as respostas recebidas. Reproduza o envio disparando o mesmo payload JSON para o endpoint do CRM com um cliente REST, como Postman ou Insomnia, e confira se as credenciais de API do CRM ainda estão válidas e com as permissões necessárias.

O Mautic pode receber dados do CRM para atualizar contatos?

Sim, pela API REST do Mautic. O CRM pode chamar a API para criar ou atualizar contatos, adicionar tags, ajustar pontuação e mexer em segmentos. Um exemplo comum: quando a oportunidade é marcada como "Ganha" no CRM, ele chama a API do Mautic para pôr a tag "cliente" no contato, tirá-lo das campanhas de aquisição e iniciar o onboarding.

Conclusão

Integrar o Mautic ao site e ao CRM é o que leva a plataforma ao seu potencial máximo. Com o tracking instalado, os formulários capturando leads e o CRM recebendo oportunidades qualificadas de forma automática, você monta uma operação de marketing e vendas enxuta e escalável — sem trabalho manual e sem perder informação entre as equipes.

Comece pela integração mais crítica para o seu negócio, valide o fluxo de dados de ponta a ponta e vá expandindo aos poucos. Para se aprofundar, o guia definitivo do Mautic reúne o passo a passo completo, e a documentação oficial de plugins e integrações do Mautic detalha cada recurso.