# Skill Whatsapp Meta Ads Leads

> Configurar campanhas de WhatsApp no Meta Ads para gerar leads qualificados para negócios locais, baseado nas melhores práticas atuais.

- Skill: `iapro-community/skill-whatsapp-meta-ads-leads` (Agent Skill)
- Install (CLI): `npx skillmds@latest add iapro-community/skill-whatsapp-meta-ads-leads`
- Raw SKILL.md: https://api.skillmd.com/api/skills/iapro-community/skill-whatsapp-meta-ads-leads/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: IAPro-Community (https://skillmd.com/u/iapro-community)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/iapro-community/skill-whatsapp-meta-ads-leads

---


# 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