Skill Whatsapp Meta Ads Leads

---
name: skill-whatsapp-meta-ads-leads
description: Configurar campanhas de WhatsApp no Meta Ads para gerar leads qualificados para negócios locais, baseado nas melhores práticas atuais.
category: marketing
risk: medium
source: meta-ads-and-whatsapp-patterns
last_verified: 2026-08-06
---

# Campanhas de WhatsApp para Leads no Meta Ads

Use esta skill para planejar campanhas, instrumentar aquisição e devolver sinais de qualidade de lead ao Meta. A interface e os nomes de objetivos podem mudar; confirme o fluxo disponível no Ads Manager da conta antes de publicar.

## Estratégia

1. Defina o resultado de negócio: conversa iniciada, lead capturado, lead qualificado ou venda.
2. Escolha o objetivo e o local de conversão exibidos atualmente para a conta; não trate “Leads” como universalmente superior a “Engajamento” ou “Vendas”.
3. Conecte um número do WhatsApp Business elegível e confirme permissões, horário de atendimento, responsáveis e política de opt-in.
4. Use criativos, perguntas iniciais e segmentação local coerentes com o serviço real.
5. Registre `campaign_id`, `adset_id`, `ad_id`, UTMs, timestamp, consentimento e telefone normalizado no CRM.

## Integração de API

- Para eventos de site ou CRM, prefira a Meta Conversions API pelo backend, com token e pixel/dataset ID fora do navegador.
- Envie somente eventos necessários, como `Lead`, um evento interno de qualificação mapeado para o esquema aceito pela conta, e `Purchase` quando houver compra confirmada.
- Use `event_id` estável para deduplicar eventos enviados pelo Pixel e pela Conversions API.
- Valide o consentimento e minimize PII; aplique hash somente conforme o formato exigido pela documentação da Meta e nunca faça hash de dados que não deveriam ser coletados.
- Fixe a versão da Graph/Marketing API no cliente do servidor e registre a data de revisão. Não copie uma versão encontrada em exemplo antigo.
- Ao usar WhatsApp Cloud API diretamente, trate webhook de mensagens, janela de atendimento, templates aprovados, limites e qualidade como contratos separados da campanha. Para Evolution API, encaminhe para `skill-evolution-api`.

## Operação e Métricas

| Métrica | Uso |
|---|---|
| CPL | Custo por lead capturado |
| Taxa de qualificação | Qualidade real do tráfego |
| Tempo de primeira resposta | Velocidade do atendimento |
| Conversão em venda | Resultado de negócio |
| ROAS | Retorno sobre mídia quando a receita é confiável |

Compare campanhas por coortes e janela de atribuição. Não use metas fixas como “>10%” ou “<5 min” sem contexto de setor, horário e capacidade de atendimento.

## Segurança e Conformidade

- Nunca coloque tokens da Meta, segredos de webhook ou chaves do WhatsApp em `VITE_`, bundles ou mensagens do cliente.
- Valide assinatura de webhook quando disponível, responda rapidamente e processe eventos de forma idempotente.
- Respeite opt-out, finalidade, retenção e direitos do titular; encaminhe análise de dados pessoais para `skill-lgpd-brasil`.

## Verificação

- Teste evento duplicado, evento fora de ordem, token expirado, permissão insuficiente, falha de entrega e reconciliação no CRM.
- Confirme no Events Manager a deduplicação e a qualidade dos eventos antes de otimizar orçamento.
- Revalide versões e parâmetros na documentação oficial antes de cada mudança de integração.

## Referências Oficiais

- https://developers.facebook.com/docs/marketing-api/conversions-api
- https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks
- https://developers.facebook.com/docs/graph-api/changelog

## Skills Relacionadas

- `skill-evolution-api` — integração WhatsApp via Evolution API
- `skill-lgpd-brasil` — dados pessoais e conformidade
- `skill-unified-analytics` — taxonomia e métricas de produto