Integração WhatsApp + Mautic: os caminhos que funcionam

Ligar o WhatsApp ao Mautic é uma das perguntas que mais recebo, e quase toda resposta que circula por aí começa errada, prometendo um "plugin nativo" que não existe. O Mautic não fala WhatsApp de fábrica: a integração real acontece por um provedor oficial (BSP) da API do WhatsApp, conectado ao Mautic por webhook e API — e o n8n costuma ser a peça que amarra tudo. Entender isso antes de escolher a ferramenta poupa dias de trabalho jogado fora.

Este guia mostra os três caminhos que funcionam de verdade, com os trade-offs de cada um, e as regras do WhatsApp Business que você não pode ignorar — opt-in, janela de 24 horas e templates aprovados — sob pena de ter o número banido.

1Capturaformulário do Mautic coleta o contato com telefone e opt-in

2Gatilhoum evento do Mautic dispara o webhook de saída

3BSPo provedor oficial aciona a API do WhatsApp Business

4Templatea mensagem sai por template aprovado, respeitando a janela de 24h

5Respostao inbound volta por webhook e atualiza o contato no Mautic

O padrão da integração: o Mautic captura o lead, um gatilho vira webhook, o BSP envia pela API do WhatsApp e a resposta volta para o Mautic.

Por que não existe "integração nativa"

O Mautic é forte em e-mail, formulários, segmentação e lead scoring, mas nasceu focado em e-mail — não traz um conector oficial de WhatsApp no núcleo. Qualquer material que te ofereça um "plugin oficial do Mautic para WhatsApp" pronto para baixar está inventando. O que existe, de fato, são três caminhos:

Caminho	Como funciona	Quando escolher
BSP + webhook/API	Um provedor oficial da WhatsApp Business Platform recebe a chamada do Mautic e envia a mensagem	É a base de todos os outros; inevitável para envio em escala
Plugin da comunidade	Extensões de terceiros do ecossistema Mautic que embrulham a API de um BSP	Só se o plugin for mantido e você aceitar o risco de abandono
n8n / Zapier orquestrando	O Mautic dispara um webhook, a ferramenta processa e chama a API do BSP	Quando você quer lógica, validação e controle dos dados

Os três apoiam no mesmo alicerce: a WhatsApp Business Platform, a API oficial da Meta, sempre intermediada por um BSP (Business Solution Provider) como Twilio, 360dialog, Meta Cloud API ou Zenvia. Não há atalho que fuja disso sem quebrar os termos de uso.

As regras do WhatsApp que definem o fluxo

Antes de desenhar qualquer automação, três regras da Meta moldam o que é possível. Ignorá-las é o caminho mais rápido para ter o número bloqueado.

Regra	O que significa	Efeito no seu fluxo no Mautic
Opt-in	O contato precisa autorizar receber mensagens antes do primeiro envio	Registre o consentimento num campo/tag e só inclua no segmento quem optou
Janela de 24h	Após o cliente te escrever, você tem 24h para responder com texto livre	Respostas rápidas cabem na janela; reengajamento fora dela, não
Templates (HSM)	Fora da janela, só templates pré-aprovados pela Meta, na categoria certa	Suas campanhas do Mautic disparam esses templates, não texto solto

Os templates se dividem em categorias — marketing, utilidade, autenticação e serviço —, cada uma com regra e preço próprios. Uma confirmação de pedido (utilidade) e uma oferta promocional (marketing) não são a mesma coisa aos olhos da Meta. Some a isso a LGPD: consentimento para tratar o dado e para contatar a pessoa. O opt-in do WhatsApp e o consentimento da LGPD andam juntos, mas são exigências distintas — guarde prova das duas.

Um aviso que vale repetir: automatizar o WhatsApp comum — o app pessoal ou o Business do celular — por bibliotecas não oficiais viola os termos e arrisca o banimento do número. Para escala, o único caminho suportado é a API oficial via BSP, que é o que o Mautic deve alimentar. Se ainda tem dúvida sobre a plataforma em si, o guia de automação com a WhatsApp Business API cobre o lado do WhatsApp com profundidade.

Preparar o Mautic

Independente do caminho, o Mautic precisa de duas coisas: guardar o telefone e separar quem pode receber.

Campo de telefone. Em Configurações → Campos de contato, confirme se já existe um campo de telefone/celular. Se precisar de um dedicado ao WhatsApp, crie um campo de texto — veja como criar campos customizados. Capture-o num formulário do Mautic pedindo o número com código de país (+55 11 9XXXX-XXXX), e inclua no mesmo formulário a caixa de opt-in.

Segmento de elegíveis. Em Contatos → Segmentos, monte um segmento com dois filtros simples e honestos: o campo de telefone não vazio e o campo de opt-in igual a sim. O Mautic filtra por operadores como "não está vazio", "igual" e "contém" — a validação fina do formato do número é melhor deixar para o formulário ou para o n8n, não para uma regex no segmento.

Caminho 1 e 2: BSP direto ou plugin da comunidade

O caminho mais direto liga o Mautic ao BSP por webhook. Em Configurações → Webhooks, crie um webhook que dispara nos eventos que interessam (contato criado, pontos alterados, adicionado a segmento) e aponta para um endpoint que aciona a API do provedor. O payload leva o que o BSP precisa:

{
  "contact_id": "{{contact_id}}",
  "phone": "{{contact.whatsapp_phone}}",
  "name": "{{contact_firstname}}",
  "template": "boas_vindas"
}

O detalhe que os tutoriais pulam: o Mautic não chama a API do WhatsApp sozinho a partir desse webhook. Ele empurra o evento; algo do outro lado precisa receber e traduzir para a chamada do BSP — e é aí que entra um endpoint próprio, um serviço serverless ou o n8n do próximo caminho.

Os plugins da comunidade tentam encurtar isso, embutindo a chamada ao BSP como uma ação de campanha dentro do Mautic. Alguns existem e funcionam; o problema é a manutenção. Antes de depender de um, confira quando foi a última atualização, se acompanha a sua versão do Mautic e se o BSP dele é o que você usa. Plugin abandonado quebra na primeira atualização de major — e você fica sem WhatsApp sem saber por quê. Não é que sejam ruins; é que exigem um cuidado que o "instale e esqueça" não cobre.

Caminho 3: n8n orquestrando (o que eu recomendo)

Para qualquer coisa além do envio mais trivial, o n8n é a peça que amarra os dois lados sem gambiarra e mantendo os dados na sua casa. O Mautic dispara o webhook, o n8n processa e chama a API do BSP — e faz a volta também.

O fluxo típico:

O lead preenche o formulário do Mautic com telefone e opt-in.
O Mautic Trigger entrega o evento ao n8n por webhook.
O n8n valida o número (formato, país) e checa se há opt-in — descartando o que não passa.
Um nó HTTP (ou o nó Twilio) chama a API do BSP com o template certo, respeitando a janela de 24h.
O n8n escreve de volta pela API do Mautic: tag whatsapp_enviado, nota ou pontos.

A vantagem sobre o webhook cru é o miolo: dá para tratar erro, tentar de novo com backoff, ramificar por idioma ou horário e logar cada passo — tudo que um webhook direto não faz. O passo a passo desse trilho está no guia de integração n8n + Mautic, que serve de base aqui.

Fechar o loop: a resposta de volta ao Mautic

Enviar é metade. O valor aparece quando a resposta do cliente vira dado no Mautic. Todo BSP oferece webhook de entrada (inbound): quando o contato responde no WhatsApp, o provedor faz um POST para uma URL sua.

Direcione esse webhook de entrada para o n8n (ou para o serviço que você mantém), não para um endpoint mágico do Mautic — o Mautic não tem um receptor de inbound de WhatsApp nativo. O n8n recebe a resposta, encontra o contato pelo telefone via API do Mautic e atualiza o registro:

Recebe o POST do BSP com telefone, texto e horário.
Busca o contato correspondente pela API.
Adiciona a tag respondeu_whatsapp e uma nota com a mensagem.
Opcionalmente soma pontos, disparando a próxima campanha no Mautic.

Com isso a conversa do WhatsApp alimenta o mesmo funil do e-mail, e a segmentação passa a considerar quem realmente respondeu.

O que medir (sem inventar número)

Depois que estiver rodando, acompanhe alguns indicadores — o BSP fornece a maioria e o Mautic guarda o resto. Não vou cravar "taxa ideal": o que importa é a tendência no seu funil, medida antes e depois.

Entregabilidade: quantas mensagens o BSP confirmou como entregues.
Taxa de resposta: proporção de quem respondeu — o sinal mais honesto de que a mensagem fez sentido.
Cliques: use parâmetros UTM nos links dos templates (?utm_source=whatsapp&utm_campaign=nome_da_campanha) para o Mautic e o analytics atribuírem o tráfego.
Conversão: de contato no WhatsApp a cliente. Compare com o mesmo público no e-mail em vez de mirar um múltiplo prometido por tutorial.

Perguntas frequentes sobre WhatsApp e Mautic

O Mautic tem integração nativa com o WhatsApp?

Não. O Mautic não traz um conector oficial de WhatsApp de fábrica. Toda integração séria passa por um provedor oficial (BSP) da WhatsApp Business Platform — Twilio, 360dialog, Meta Cloud API, Zenvia e outros — ligado ao Mautic por webhook e API, ou orquestrado por uma ferramenta como o n8n. Existem plugins da comunidade, mas com qualidade e manutenção variáveis.

Posso automatizar o WhatsApp comum, sem a API?

Tecnicamente dá para gambiarrar, mas não vale a pena: automatizar o WhatsApp pessoal ou o WhatsApp Business do celular por meios não oficiais viola os termos de uso e coloca o número em risco de banimento. Para envio em escala existe a WhatsApp Business Platform (API oficial), que é o caminho suportado e o único que o Mautic deve alimentar.

Preciso de opt-in para mandar mensagem via WhatsApp?

Sim, em duas frentes. A Meta exige opt-in explícito antes de enviar mensagens pela API, e a LGPD exige consentimento para tratar o dado e contatar a pessoa. Registre esse consentimento no próprio contato do Mautic (um campo ou tag) para ter prova de quem autorizou e quando.

O que é a janela de 24 horas do WhatsApp?

Depois que o cliente te envia uma mensagem, abre uma janela de 24 horas em que você pode responder com texto livre. Fora dessa janela, só é possível iniciar contato com um template pré-aprovado pela Meta (o antigo HSM), na categoria certa — marketing, utilidade, autenticação ou serviço. Seu fluxo no Mautic precisa respeitar essa regra.

Quanto custa integrar o WhatsApp ao Mautic?

O Mautic é gratuito e o custo real está no WhatsApp e no BSP. A Meta cobra pelo modelo dela, que muda com frequência (hoje por conversa/template, com preço diferente por categoria e país), e o provedor soma a margem dele. Some ainda o servidor, caso rode Mautic e n8n self-hosted. Consulte a tabela vigente no seu BSP antes de dimensionar — não confie em número de tutorial antigo.

Por onde começar

Não monte o funil inteiro de uma vez. Escolha um BSP, faça um único envio funcionar — captura no formulário, opt-in, um template de boas-vindas disparado pelo n8n — e só depois feche o loop com o webhook de entrada. É o trecho de maior retorno e o que ensina a lógica toda. Com ele estável, expanda para uma sequência de nutrição usando as campanhas do Mautic. Para dominar o lado do Mautic antes de plugar o WhatsApp, o guia definitivo do Mautic é o ponto de partida.