Recursos avançados do Mautic para usuários experientes

Se você já domina o básico do Mautic — formulários, campanhas e disparos de e-mail rodando —, o próximo salto não está em fazer mais do mesmo, e sim em conectar, personalizar e estender a plataforma. A tese em uma frase: o que separa o usuário experiente do iniciante no Mautic não é saber montar uma campanha, é usar a API e os webhooks para integrar, o conteúdo dinâmico para personalizar de verdade e os plugins para estender — transformando o Mautic no centro nervoso da operação de marketing, e não em mais um disparador de e-mails.

Como uso o Mautic em produção há anos, minha régua para "recurso avançado" é objetiva: precisa entregar algo que o construtor visual sozinho não entrega. Se você ainda está montando essa base, comece por o que é o Mautic e pelo guia definitivo do Mautic. Aqui o foco é o que vem depois. O caminho é este:

A API REST: o Mautic falando com o resto da operação

A API REST é, disparado, o recurso que mais diferencia uma operação avançada. Com ela você cria, lê, atualiza e apaga praticamente qualquer entidade do Mautic — contatos, empresas, segmentos, campanhas, e-mails, formulários — de forma programática, a partir de qualquer sistema.

Antes de usar, dois passos: habilitar a API em Settings → Configuration → API Settings e criar as credenciais em Settings → API Credentials. A autenticação aceita OAuth 2.0 (o método recomendado para integrações de servidor) e Basic Auth (mais simples, menos seguro — deixe para testes internos). Alguns endpoints que uso no dia a dia:

• POST /api/contacts/new — cria um novo contato.
• PATCH /api/contacts/{id}/edit — atualiza parcialmente um contato existente.
• POST /api/contacts/{id}/points/plus/{points} — soma pontos a um contato.
• POST /api/segments/{segmentId}/contact/{contactId}/add — adiciona um contato a um segmento.
• GET /api/contacts?search=email:contato@dominio.com — busca um contato pelo e-mail.

Repare no padrão da rota de segmento: o identificador do segmento vem antes do contato (/segments/{segmentId}/contact/{contactId}/add) — inverter isso é o erro mais comum de quem está começando na API. A referência completa de cada rota está na documentação para desenvolvedores do Mautic.

Webhooks: o Mautic avisando em tempo real

Se a API é o Mautic sendo consultado, o webhook é o Mautic falando primeiro. Em vez de um sistema externo ficar perguntando "tem novidade?" a cada minuto (polling), o Mautic dispara uma chamada HTTP no exato momento em que o evento acontece. É a diferença entre push e pull — e, para integração em tempo real, o push quase sempre ganha.

Crie um webhook em Settings → Webhooks → New e configure:

• Webhook URL: o endereço do sistema que recebe os dados (seu CRM, o n8n, o Make, uma função sua).
• Events: quais eventos disparam — novo contato, contato atualizado, e-mail aberto, formulário enviado, pontuação alterada, entre outros.
• Headers: cabeçalhos HTTP personalizados, úteis para autenticar no sistema que recebe.

Um detalhe que separa quem domina webhooks: o Mautic pode processá-los na hora ou em fila, quando o volume é alto. No modo em fila, é o comando php bin/console mautic:webhooks:process (agendado no cron) que faz o envio — mais um motivo para os cron estarem sempre rodando. Se o conceito de webhook ainda é novo, vale a leitura de o que é webhook e como funciona.

O mapa dos recursos avançados

Antes de aprofundar os próximos, vale ter o panorama. Cada um destes resolve um problema que o construtor visual sozinho não resolve:

Conteúdo dinâmico: uma mensagem, vários contatos

O conteúdo dinâmico exibe partes diferentes de um e-mail ou de uma página conforme o segmento ou o dado do contato. Em vez de disparar dez e-mails para dez públicos, você monta um e ele se adapta a quem abre.

A personalização mais simples são os tokens. Além do básico, qualquer campo do contato vira token no formato {contactfield=alias} — e a variação {contactfield=alias|texto} cobre o caso do campo vazio. É o mecanismo que faz um disparo em massa soar como mensagem escrita para uma pessoa só; o passo a passo de campos está em como criar campos customizados no Mautic.

Um degrau acima está o bloco de Dynamic Content no construtor de e-mail: você define um conteúdo padrão e variações, cada uma filtrada por um critério (segmento, valor de campo). Quem bate o filtro vê a variação; o resto vê o padrão. E, para o site, existe a Dynamic Web Content (em Components → Dynamic Content): o script de rastreamento do Mautic troca um trecho da página pelo conteúdo certo quando reconhece o contato — mostrando, por exemplo, um CTA para quem já visitou a página de preços e outro para quem chegou pelo blog. Para o lado da escrita, personalização de e-mails e conteúdo no Mautic aprofunda a estratégia.

A/B testing no Segment Email

O Mautic tem teste A/B nativo, mas com um limite que confunde muita gente: ele foi desenhado para o Segment Email — o disparo único para um segmento —, não para os e-mails de template usados dentro das campanhas. No Segment Email você cria uma variante, o Mautic distribui o envio entre as versões, mede o critério de vitória que você escolheu (maior taxa de abertura ou de cliques) e passa a enviar só a vencedora para o restante da lista. É a forma correta de otimizar assunto e chamada com dado, não com achismo. Dentro de uma campanha, para comparar variações, o caminho é dividir a base em ramos ou segmentos e medir cada um — como detalho em criando campanhas de marketing no Mautic.

Focus Items, Preference Center e DoNotContact

Três recursos que raramente aparecem em tutoriais de iniciante, mas que fazem diferença:

• Focus Items (Components → Focus Items): pop-ups, barras de notificação, slides e modais que aparecem no seu site para os visitantes rastreados. Servem para capturar e-mail, anunciar uma promoção ou reforçar um CTA — e, por rodarem sobre o tracking, conversam com o histórico do visitante.
• Preference Center: uma página onde o próprio contato escolhe o que quer receber (assuntos, frequência) e entra ou sai de segmentos sozinho. Além de reduzir descadastro, é um belo aliado de conformidade com a LGPD.
• DoNotContact (DNC): a lista que registra quem pediu descadastro, deu bounce ou foi marcado manualmente. O Mautic respeita o DNC em todos os envios — entender essa lista evita continuar batendo em quem já saiu.

Points, Stages e Segments não são a mesma coisa

Esse é o ponto de precisão que mais gera confusão em usuários avançados — e vale fixar antes de automatizar qualquer coisa. São três eixos independentes que convivem no mesmo contato:

• Points — o score numérico que sobe e desce com o comportamento (o lead scoring propriamente dito).
• Stages — a etapa fixa do funil (MQL, SQL, cliente), que avança em uma direção.
• Segments — o grupo dinâmico por filtro, do qual o contato entra e sai conforme o dado muda.

Um mesmo contato tem, ao mesmo tempo, uma pontuação, um estágio e a participação em vários segmentos. Tratar os três como sinônimos é a origem de metade das automações que "não fazem sentido". A mecânica completa de pontuação e o modelo prático estão em rastreamento de atividades e pontuação de leads no Mautic.

Plugins, Marketplace e a linha de comando

Por ser open source, o Mautic se estende por plugins. A partir do Mautic 4 há um Marketplace (em Settings → Plugins) para encontrá-los; os arquivos vão para o diretório plugins/ (manualmente ou via Composer) e o comando php bin/console mautic:plugins:reload registra o que foi adicionado. É por aí que entram integrações com CRMs, canais como SMS (o Mautic já traz a integração nativa com o Twilio) e conectores diversos — o panorama está em integrações populares do Mautic.

A linha de comando, aliás, é território do usuário experiente. Além do mautic:plugins:reload, comandos como mautic:import (importação em lote) e os cron de segmentos e campanhas são a espinha dorsal de uma instalação que roda sozinha. A lista do que precisa estar agendado está em quais cron o Mautic precisa.

Orquestrando tudo com n8n ou Make

Para automações que cruzam o Mautic com dezenas de outros sistemas sem escrever código, ferramentas de orquestração como o n8n (open source, o que combina com a filosofia do Mautic) ou o Make (antigo Integromat) se conectam via API e webhooks. É com elas que você monta fluxos do tipo: lead atinge 100 pontos no Mautic → webhook aciona o n8n → o n8n consulta o CRM, envia um alerta no Slack e dispara uma mensagem por uma API de WhatsApp. Como conectar o Mautic ao seu ambiente está em como integrar o Mautic com o seu site ou CRM.

Perguntas frequentes sobre recursos avançados do Mautic

Qual a diferença entre a API REST e os webhooks do Mautic?

É a direção do dado. A API REST é pull: um sistema externo chama o Mautic quando quer criar, ler ou atualizar algo (contatos, segmentos, campanhas). O webhook é push: o Mautic avisa o sistema externo na hora em que um evento acontece (novo contato, e-mail aberto, formulário enviado), sem ninguém precisar ficar consultando. Na prática você usa os dois juntos — o webhook dispara o alerta, e a API busca o detalhe completo quando precisa.

O Mautic tem integração nativa com WhatsApp?

Não. O Mautic não traz um conector nativo de WhatsApp. A integração é feita por fora: um webhook (ou uma campanha) dispara para uma API de WhatsApp Business de terceiros — Twilio, Z-API, Evolution API — que envia a mensagem. Para orquestrar isso sem escrever código, ferramentas como n8n ou Make ficam entre o Mautic e a API do WhatsApp.

O teste A/B de e-mail funciona em qualquer e-mail do Mautic?

Não. O A/B nativo com escolha automática de vencedor foi desenhado para o Segment Email, o disparo único para um segmento. Você cria uma variante do e-mail, define o critério de vitória (maior taxa de abertura ou de cliques) e o Mautic distribui o envio e passa a mandar só a vencedora. E-mails de template usados dentro de campanhas não têm esse A/B automático — ali você compara dividindo a base em ramos ou segmentos diferentes.

Qual a diferença entre Points, Stages e Segments no Mautic?

São três eixos independentes. Points é o score numérico que sobe e desce com o comportamento (lead scoring). Stages é a etapa fixa do funil (MQL, SQL, cliente), que avança em uma direção. Segments é o grupo dinâmico por filtro, do qual o contato entra e sai conforme o dado muda. Um mesmo contato tem, ao mesmo tempo, uma pontuação, um estágio e pode pertencer a vários segmentos — não confunda os três.

Como instalo plugins avançados no Mautic?

Plugins ficam no diretório plugins/ da instalação; a partir do Mautic 4 há também o Marketplace, em Settings → Plugins, para encontrá-los. Depois de colocar os arquivos (manualmente ou via Composer), rode php bin/console mautic:plugins:reload para o Mautic registrar o plugin, e então configure-o em Settings → Plugins. Como o Mautic é open source, você também pode desenvolver plugins próprios seguindo a documentação para desenvolvedores.

Conclusão

O Mautic é muito mais do que um disparador de e-mails, e são os recursos avançados que provam isso: a API REST e os webhooks o transformam no centro de uma operação integrada, o conteúdo dinâmico personaliza de verdade, o A/B testing tira o achismo da otimização e os plugins estendem a plataforma até onde a sua necessidade for. Tudo isso sem custo de licença, porque é open source e roda sob o seu controle.

Meu conselho de quem opera o Mautic há tempo: avance um recurso de cada vez. Comece integrando por webhook o que hoje você faz na mão, depois personalize com conteúdo dinâmico e só então parta para plugins e API. A referência oficial de cada peça está na documentação do Mautic. Para mais conteúdos, acesse os artigos de Mautic no atraca.com.br.