WhatsApp Mautic integração

Integrar WhatsApp Business API com Mautic é a maneira mais poderosa de automatizar comunicação com leads e clientes. Enquanto email tem taxa de abertura de 25-30%, WhatsApp tem 98%+. Se você já tem Mautic configurado, adicionar WhatsApp é o próximo passo lógico para aumentar engajamento. Este guia técnico caminha você desde o setup básico com webhooks até workflows avançados de segmentação e lead nurturing completamente automatizados.

O desafio é que Mautic e WhatsApp Business API não se conectam nativamente (fora integração da Zenvia/LOCABOT). Vamos mostrar como usar webhooks, n8n e plugins customizados para fazer isso funcionar. Ao final, você terá uma máquina de automação que captura leads no blog, enriquece perfis em Mautic e os nutre via WhatsApp até conversão.

Arquitetura: Como Mautic Fala com WhatsApp

Antes de implementar, entenda o fluxo:

Blog (Lead Magnet Form)
    ↓
Mautic (Captura Lead, Email + Phone)
    ↓
Webhook Mautic (Dispara automaticamente)
    ↓
Zenvia/LOCABOT/Twilio (BSP)
    ↓
Envia Message (Template HSM)
    ↓
Usuário recebe no WhatsApp
    ↓
Usuário responde (opcional)
    ↓
Webhook de entrada (Zenvia → Mautic)
    ↓
Mautic atualiza contato (nota, segmento, score)
    ↓
Próxima automação Mautic dispara

A chave é webhooks — chamadas HTTP entre sistemas. Mautic pode disparar webhook quando um evento ocorre (lead criado, link clicado); Zenvia pode fazer o mesmo quando mensagem é entregue/respondida.

Passo 1: Preparar Seu Mautic para WhatsApp

Adicionar Campo de Telefone (se não tem)

Em Mautic, vá para Settings → Contact Fields e verifique se existe campo “Phone” ou “Mobile”. Se não, crie:

• Type: Text
• Name: whatsapp_phone
• Label: Telefone WhatsApp
• Field Group: Personal Data
• Required: Não

Agora, seu formulário captura telefone. Exemplo:

{form_NAME_de_formulario_id_123}
Label: Seu telefone WhatsApp (com código país)
Placeholder: +55 11 99999-8888
Field Type: Text

Criar Segmentação

Vá para Contacts → Segments e crie:

• Segment: “Leads WhatsApp Válidos”
• Filter: whatsapp_phone != empty AND whatsapp_phone matches regex “+55[0-9]{10,11}”
• Propósito: Garantir que só contatos com telefone válido entram em automações WhatsApp

Passo 2: Método 1 – Integração Nativa (Se Usa Zenvia/Brevo)

Zenvia + Mautic Plugin

Zenvia oferece plugin oficial para Mautic. Passos:

1. Download do plugin em zenvia.com/mautic-plugin
2. Extraia em /plugins/ZenviaPlugin
3. Em Mautic, vá para Settings → Plugins e ative “Zenvia WhatsApp Plugin”
4. Configure credenciais:
   • API Key (Zenvia → Settings → Integrations)
   • Account ID (você encontra no dashboard Zenvia)
5. Teste enviando mensagem de teste

Criar Automação Baseada em Email para WhatsApp

Uma vez instalado, você pode criar Campaigns em Mautic que enviam WhatsApp em vez de email:

1. Vá para Campaigns → New
2. Nomeie: “E-E-A-T Lead Nurture – WhatsApp”
3. Drag trigger: “Contact matches segment ‘Leads WhatsApp Válidos'”
4. Drag action: “Send Zenvia WhatsApp Message”
5. Configure:
   • Template: “lead_nurture_dia0” (confirmação de opt-in)
   • Delay: Imediato
6. Adicione segunda ação: “Wait 3 days”
7. Terceira ação: “Send Zenvia WhatsApp Message” (template “lead_nurture_dia3”)
8. Quarta ação: “Wait 5 days”
9. Quinta ação: “Send Zenvia WhatsApp Message” (template “ultima_chance_desconto”)
10. Clique “Publish”

Pronto! Agora qualquer lead que entra no segmento automaticamente recebe sequência de 3 mensagens WhatsApp em dias 0, 3 e 8.

Passo 3: Método 2 – Integração via Zapier (Flexível, Sem Código)

Se não usa Zenvia ou quer mais flexibilidade, Zapier é a solução intermediária.

Configurar Zapier

1. Abra zapier.com e crie conta
2. Crie novo Zap: “Webhook Trigger → Zenvia Action”
3. Trigger:
   • App: Webhooks by Zapier
   • Trigger: Catch Raw Hook
   • Copy the webhook URL
4. Ação:
   • App: Zenvia
   • Action: Send WhatsApp Message
   • Configure com dados do webhook

Configurar Mautic para Dispara Webhook

Em Mautic Campaign, após “Send Email”, adicione ação:

• Action Type: “Push contact to integration”
• Ou (Manual): Post webhook customizado

Se webhook customizado, em Settings → Webhooks, crie webhook:

Name: Mautic to Zenvia WhatsApp
Trigger: Lead points change / Contact updated
Payload URL: https://hooks.zapier.com/hooks/catch/SEU_ZAPIER_ID/

Payload (JSON):
{
  "contact_id": {{contact_id}},
  "email": {{contact_email}},
  "phone": {{contact.whatsapp_phone}},
  "name": {{contact_firstname}},
  "campaign_id": {{campaign_id}}
}

Passo 4: Método 3 – Automação Avançada com n8n

Para workflows muito complexos (multi-idioma, segmentação dinâmica, logs detalhados), n8n é superior. Requer server próprio (VPS ~R$ 30/mês).

Workflow n8n Exemplo

Trigger: Webhook Mautic (lead criado)
  ↓
Code: Validar telefone (remover caracteres, verificar padrão)
  ↓
Decision: Telefone válido?
  ├─ Sim → HTTP POST Zenvia (enviar mensagem)
  │   └─ Wait 30s para resposta
  │   └─ HTTP GET Zenvia (verificar status)
  │   └─ Mautic Update (adicionar tag "whatsapp_sent")
  │
  └─ Não → Mautic Update (adicionar nota "Telefone inválido")

If Zenvia returns 200 OK:
  └─ Continue campaign
Else:
  └─ Retry 3x com backoff exponencial
  └─ Notify admin

Instale n8n: npm install -g n8n && n8n start

Rastreamento: Respostas do Usuário de Volta para Mautic

Para fechar o loop, você quer saber quando usuário respondeu à mensagem WhatsApp — e levar essa informação de volta para Mautic.

Setup com Zenvia Webhook de Entrada

Em Zenvia, vá para Webhooks → Inbound Webhooks e crie:

Name: Mautic Inbound Messages
Trigger: Message received
Callback URL: https://seu-mautic.com.br/ws/webhooks/zenvia_inbound

Agora, quando usuário responde via WhatsApp:

Zenvia detecta resposta
  ↓
Envia POST para seu Mautic com:
{
  "from_phone": "+5511999998888",
  "message_text": "Sim, quero consulta",
  "timestamp": "2026-03-31T14:30:00Z"
}
  ↓
Mautic webhook recebe e processa:
  - Procura contato com esse telefone
  - Adiciona ponto de contato (interaction)
  - Adiciona tag "respondeu_whatsapp"
  - Dispara nova automação (ex: "Enviar agendador")

Implementar Webhook Customizado em Mautic

Em /app/webhooks/ZenviaInbound.php:

class ZenviaInboundWebhook {
  public function process($payload) {
    $phone = $payload['from_phone'];
    $message = $payload['message_text'];

    // Procurar contato no Mautic
    $contact = $this->findContactByPhone($phone);

    if (!$contact) return;

    // Adicionar nota
    $contact->addNote("Respondeu WhatsApp: " . $message);

    // Adicionar tag
    $contact->addTag('responded_whatsapp');

    // Incrementar pontos
    $contact->addPoints(20);

    // Disparar evento (ativa automações)
    $this->dispatcher->dispatch('contact.responded_whatsapp',
      ['contact' => $contact, 'message' => $message]
    );
  }
}

Exemplos de Fluxos Automáticos

Fluxo 1: Lead Magnet → Confirmação → Drip 5 Dias

Fluxo 2: Cliente Comprou → Onboarding via WhatsApp

Boas Práticas de Segmentação

Não envie todas as mensagens para todos. Segmente por:

• Comportamento: Quem baixou qual guia? Quali mensagens para guia E-E-A-T vs guia Mautic são diferentes
• Engajamento: Quem abriu emails? Só eles recebem promoções (reduz churn)
• Estágio de funil: Leads (educação) vs Oportunidades (venda) vs Clientes (suporte) — templates diferentes
• Idioma/Timezone: Se audiência internacional, respeite horários locais (não envie 3 da manhã para usuário em SP)

Monitoramento e KPIs

Configure dashboard em Mautic para monitorar:

• Taxa de entrega: % de mensagens que chegaram no WhatsApp (ideal: 95%+)
• Taxa de resposta: % que responderam (esperado: 10-30% para marketing, 40-60% para transacional)
• Tempo de resposta médio: Quanto tempo leva responder (ideal: <2h para atendimento, <1h para urgências)
• Taxa de conversão: % de leads WhatsApp que viraram clientes (comparar com email: esperado 2-3x maior)

Perguntas Frequentes (FAQ)

Qual é a latência entre Mautic disparar webhook e mensagem chegar no WhatsApp?

Típica: 2-5 segundos. Ocasionalmente, pode levar até 15s se BSP está sobrecarregado. Para garantir entrega crítica, sempre configure retry.

Posso usar mesmos templates para SMS e WhatsApp?

Não. SMS permite caracteres limitados (160); WhatsApp permite 4096. Use templates customizados para cada canal. Mensagens WhatsApp podem incluir emojis, quebras de linha, links — aproveite.

Como rastrear cliques em links dentro de mensagens WhatsApp?

Use UTM parameters. Exemplo: em template, em vez de “https://atraca.com.br/agendar”, use “https://atraca.com.br/agendar?utm_source=whatsapp&utm_medium=drip_d3&utm_campaign=eeat_nurture”. Mautic + Google Analytics rastrearão cliques.

E se usuário responder com spam ou conteúdo inadequado?

Configure filtro em n8n/webhook. Se mensagem contém palavras-chave ruins, não processa. Alternativa: enviar resposta automática padrão, human review depois. WhatsApp bloqueia contas que spam; seja responsável.

Quanto deve custar integração Mautic + WhatsApp?

Setup: R$ 0-500 (você mesmo com tutorial, ou freelancer 2-3h). Custo recorrente: R$ 0 (Mautic) + R$ 0.40-0.80/msg WhatsApp = ~R$ 400-800/mês se enviar 1k mensagens/mês. ROI positivo se 3+ conversões/mês.