---
title: "Rastrear anúncios e enviar evento de compra ao Facebook (Meta)"
description: "Guia passo a passo para criar um App no Meta, configurar casos de uso, gerar token de sistema, permissões necessárias e criar/consultar dataset via API usando WABA ID."
url: https://help.datacrazy.io/pt-br/articles/10670775-rastrear-anuncios-e-enviar-evento-de-compra-ao-facebook-meta
collection: "Automações"
updated: 2026-11-18
language: pt-br
alternates: [es, en]
---

# Rastrear anúncios e enviar evento de compra ao Facebook (Meta)

Guia passo a passo para criar um App no Meta, configurar casos de uso, gerar token de sistema, permissões necessárias e criar/consultar dataset via API usando WABA ID.

## Guia Completo de Tracking da Meta para Campanhas Click to WhatsApp

## API Graph v25.0

* * *

## Links relevantes:

### Tutorial no YouTube

### Fluxos para baixar e importar  
  
🎯[#1 Tracking UTMs.dc](https://drive.google.com/open?id=1kaDplV_DEpW11OirAmihOGdthiBKHWZh&usp=drive_copy)  
  
🎯[#2 Tracking Envio Ganho META](https://drive.google.com/open?id=1WMvmW2ELcJHM0Y9-Wdp177ERqEOf13nh&usp=drive_copy)📈 [- Pixel dataset do WhatsApp.dc](https://drive.google.com/open?id=1WMvmW2ELcJHM0Y9-Wdp177ERqEOf13nh&usp=drive_copy)  
  
🎯[#3 Tracking - Envio Ganho META(sha256-pixel Tradicional- Não do WhatsApp).dc](https://drive.google.com/open?id=1hx3CAVhoVdSYA2TmGVAxS6xHwncLJsLE&usp=drive_copy)  

### Objetivo

Este guia reúne todas as etapas necessárias para implementar corretamente o Tracking da Meta em campanhas **Click to WhatsApp**, desde a criação do App até o envio dos eventos de conversão.

Ao final da configuração você terá:

-   Token permanente da Meta
    
-   Dataset (Pixel do WhatsApp)
    
-   Rastreamento de Leads
    
-   Rastreamento de Compras
    
-   Melhor aprendizado do algoritmo da Meta
    
-   Melhor otimização das campanhas
    

* * *

## Como funciona o Tracking

```text
Facebook Ads
      │
      ▼
Click to WhatsApp
      │
      ▼
WhatsApp Business
      │
      ▼
Datacrazy CRM
      │
      ├──────────────► Tracking #1
      │                 Captura origem do Lead
      │
      ├──────────────► Tracking #2
      │                 Eventos de Conversão
      │
      └──────────────► Tracking #3
                        SHA256 (Fallback)

```

* * *

## Como a Meta aprende

Quando um usuário clica em um anúncio Click to WhatsApp, a Meta sabe apenas que uma conversa foi iniciada.

Ela não sabe:

-   se o lead respondeu;
    
-   se demonstrou interesse;
    
-   se recebeu uma proposta;
    
-   se iniciou um pagamento;
    
-   se comprou.
    

Os Eventos de Conversão informam exatamente em qual etapa do funil o cliente está.

Quanto mais fiel for esse envio, melhor será a otimização das campanhas.

* * *

## Funil recomendado

```text
Clique no anúncio
        │
        ▼
Primeira conversa
        │
        ▼
🟢 leadSubmitted
        │
        ▼
🔵 ViewContent
        │
        ▼
🟡 AddToCart
        │
        ▼
🟠 InitiateCheckout
        │
        ▼
🟣 Purchase

```

* * *

## Eventos

Os nomes de eventos são ‘CamelCase’ onde cada palavra do evento inicia em maiusculo, exemplo lead submitted vira ‘LeadSubmitted’.

## 🟢 LeadSubmitted

### Quando enviar

Quando o lead responder ao atendimento ou fornecer as informações mínimas para continuar o fluxo.

### Exemplos

-   Respondeu a primeira mensagem
    
-   Informou nome
    
-   Informou telefone
    
-   Confirmou interesse
    

### Objetivo

Informar que o clique no anúncio gerou um lead válido.

* * *

## 🔵 ViewContent

### Quando enviar

Quando o cliente visualizar uma oferta.

### Exemplos

-   Produto apresentado
    
-   Serviço apresentado
    
-   Catálogo enviado
    
-   Proposta enviada
    
-   Plano apresentado
    

### Objetivo

Demonstrar interesse em uma oferta.

* * *

## 🟡 AddToCart

### Quando enviar

Quando houver intenção clara de compra.

### Exemplos

-   Escolheu um produto
    
-   Escolheu um plano
    
-   Solicitou orçamento
    
-   Confirmou interesse em comprar
    

### Objetivo

Representar uma forte intenção de compra.

* * *

## 🟠 InitiateCheckout

### Quando enviar

Quando iniciar o processo de pagamento.

### Exemplos

-   PIX
    
-   Boleto
    
-   Link de pagamento
    
-   Checkout
    
-   Contrato enviado
    

### Objetivo

Indicar que o cliente entrou na etapa final da compra.

* * *

## 🟣 Purchase

### Quando enviar

Somente após confirmação do pagamento.

### Exemplos

-   PIX compensado
    
-   Cartão aprovado
    
-   Boleto pago
    
-   Assinatura criada
    
-   Venda concluída
    

### Objetivo

Representar a conversão final da campanha.

Sempre que possível envie o valor real da venda.

* * *

## Resumo dos Eventos

<table data-id="49009063-37b1-4043-bc44-4aecaf83a921" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="8ac8afe7-a52a-4439-a3cf-606a8a89b4cb">Evento</p></td><td colspan="1" rowspan="1"><p data-id="14bc1b71-ef91-4fb8-8abe-865ec6a553b6">Quando enviar</p></td><td colspan="1" rowspan="1"><p data-id="c3747191-4e78-41ab-bf7f-d3c754bdd672">Objetivo</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="65b7193d-8ddc-453c-9f13-37d9496e639e">LeadSubmitted</p></td><td colspan="1" rowspan="1"><p data-id="714faf54-8c54-42ed-8aec-79a24113dfff">Lead respondeu</p></td><td colspan="1" rowspan="1"><p data-id="c81a4e33-fcb4-4974-ba57-11f0614b8eb3">Lead válido</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="71bc0151-1633-4e8a-b6b3-3549e845a816">ViewContent</p></td><td colspan="1" rowspan="1"><p data-id="33904d66-6805-4960-99c2-0ce30eb42f63">Produto ou proposta apresentada</p></td><td colspan="1" rowspan="1"><p data-id="d61887cc-64c8-44aa-b0ae-d3f7266d2780">Interesse</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="5f9ff6f9-3454-4f70-be1b-def3e63c4022">AddToCart</p></td><td colspan="1" rowspan="1"><p data-id="9f10bca4-7655-48bc-91d5-b1e56def5cb2">Cliente confirmou interesse</p></td><td colspan="1" rowspan="1"><p data-id="3340ade7-6c7c-45e1-8caf-64b18796145c">Intenção de compra</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="399f9643-2a32-4ccf-aa18-c7b3325120b1">InitiateCheckout</p></td><td colspan="1" rowspan="1"><p data-id="7de8041e-c3c5-48eb-8c15-a3b0024c3624">Pagamento iniciado</p></td><td colspan="1" rowspan="1"><p data-id="1864d092-b3ad-4af5-8932-a94221a91aa6">Checkout</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="353cd52f-5b48-4582-9b38-fd29f99737d7">Purchase</p></td><td colspan="1" rowspan="1"><p data-id="102be788-0ab1-4c75-81e1-9979d65cba5d">Pagamento confirmado</p></td><td colspan="1" rowspan="1"><p data-id="8eba9cf9-333e-440a-915b-7c1e4a0964fb">Conversão</p></td></tr></tbody></table>

* * *

## Criação do App

O App será utilizado exclusivamente para gerar um Token permanente e permitir a integração entre o CRM Datacrazy e a Meta.

Esse App será responsável por:

-   Gerar Token de Sistema
    
-   Tracking de Leads
    
-   Tracking de Conversões
    
-   Envio de Eventos
    
-   Consulta do Dataset
    

* * *

## Casos de Uso

Durante a criação do App selecione:

-   Criar e gerenciar anúncios com a API de Marketing
    
-   Conectar-se com clientes pelo WhatsApp
    
-   Gerenciar tudo pela Página do Facebook
    

Após criar o App adicione também:

### read\_insights

Gerenciar Páginas → Adicionar

### whatsapp\_business\_manage\_events

Conectar no WhatsApp → Adicionar

Esses casos de uso liberam permissões necessárias para o Token.

* * *

## Configuração do App

Preencha:

Política de Privacidade

```text
https://datacrazy.io/politica

```

Termos de Serviço

```text
https://datacrazy.io/termos

```

Exclusão de Dados

```text
https://datacrazy.io/politica

```

Após isso:

-   Salvar
    
-   Publicar
    
-   Status Ativo
    

* * *

## Criando o Usuário de Sistema

Criar:

Nome

```text
Tracking

```

Tipo

```text
Administrador

```

Depois atribuir o App criado.

Permissão:

-   Controle Total
    

* * *

## Gerando o Token

Gerar Token utilizando:

-   App criado
    
-   Expiração Nunca
    

Permissões

-   ads\_read
    
-   whatsapp\_business\_management
    
-   whatsapp\_business\_messaging
    
-   whatsapp\_business\_manage\_events
    
-   read\_insights
    

> O Token é exibido apenas uma única vez. Salve-o imediatamente.

* * *

## Obtendo o WABA ID

No CRM Datacrazy:

Conexões

↓

Selecionar conexão

↓

Gerenciar

↓

Atualizar conexão

↓

Copiar o campo

```text
WhatsApp Business ID

```

Este será o WABA ID utilizado nas chamadas da API.

* * *

## Dataset (Pixel WhatsApp)

Todos os eventos da Meta são enviados para um Dataset.

Antes de enviar qualquer evento é necessário descobrir se ele já existe.

* * *

## Consultar Dataset

```http
GET https://graph.facebook.com/v25.0/{{wabaID}}/dataset?access_token={{metaToken}}

```

Resposta esperada

```json
{
    "data":[
        {
            "id":"123456789012345"
        }
    ]
}

```

O campo **id** será utilizado como:

```text
datasetId

```

* * *

## Dataset inexistente

Caso retorne:

```json
{
    "data":[]
}

```

Criar utilizando:

```http
POST https://graph.facebook.com/v25.0/{{wabaID}}/dataset?access_token={{metaToken}}

```

Resposta

```json
{
    "id":"123456789012345"
}

```

Armazene esse ID para reutilização.

* * *

## Fluxo do Dataset

```text
Consultar Dataset

        │

Existe?

 ┌──────┴──────┐

SIM           NÃO

 │             │

Usar ID      Criar

 │             │

 └──────┬──────┘

        ▼

Salvar datasetId

```

* * *

## Envio dos Eventos

Todos os eventos utilizam a URL:

```http
POST https://graph.facebook.com/v25.0/{{datasetId}}/events?access_token={{metaToken}}

```

* * *

## Payload(Corpo/Body JSON)

```json
{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1785282457,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "whatsapp_business_account_id": wabaID,
        "ctwa_clid": "SEU_CTWA_CLID"
      },
      "custom_data": {
        "currency": "BRL",
        "value": 19.97
      }
    }
  ]
}

```

* * *

## Campos do Payload

Campo

Descrição

<table data-id="1108944e-bb3a-49b7-bc09-77dc72603b78" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="eb06e5eb-588e-4058-ac5f-d97f5dec14de">event_name</p></td><td colspan="1" rowspan="1"><p data-id="29ca3914-1271-409f-bd8a-f332459b7a59">Evento enviado</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="e1527a76-feac-4fb9-b646-46e5b1febd1e">event_time</p></td><td colspan="1" rowspan="1"><p data-id="a3ac25b2-d512-4d48-95c1-5c2e7500e9c4">Timestamp Unix</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="7e75008e-ce81-4d2c-9e32-c43e46fd6eb1">action_source</p></td><td colspan="1" rowspan="1"><p data-id="543d6dfd-ffb6-4bc7-90e1-4a20e6d58731">business_messaging</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="65eb73a3-022e-4d22-af4f-eb8a26e6ee66">messaging_channel</p></td><td colspan="1" rowspan="1"><p data-id="451146b4-3721-45a3-9b0c-f0d8529c1855">whatsapp</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="3119a8e5-d016-445d-91cf-2f942e794c9f">whatsapp_business_account_id</p></td><td colspan="1" rowspan="1"><p data-id="7954f563-6881-4570-b522-7b1dc7b2d405">ID da WABA</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="84e6db31-2a4f-49dd-946b-616e59ced62d">ctwa_clid</p></td><td colspan="1" rowspan="1"><p data-id="c5776e74-22e4-4e97-acd7-1a28fe538dc8">Identificador do anúncio Click to WhatsApp</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a0ccee0e-f641-4b80-b73c-c703c85b3ea6">currency</p></td><td colspan="1" rowspan="1"><p data-id="bdf99b10-9c46-4e19-ac09-487727529e95">Moeda</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b0ec708a-2317-465e-958b-f850944f28df">value</p></td><td colspan="1" rowspan="1"><p data-id="45915d03-8538-41ac-b130-dc8c2e4c2696">Valor do evento</p></td></tr></tbody></table>

* * *

## CTWA CLID

O CTWA CLID é o identificador que permite à Meta relacionar a conversão com o anúncio que originou a conversa.

Sempre envie esse identificador quando disponível.

Sem ele, a Meta poderá registrar o evento, porém a atribuição da conversão ao anúncio será limitada.

* * *

## Tracking #1 — Rastreamento de Leads

Responsável por:

-   Capturar Campanha
    
-   Capturar Conjunto
    
-   Capturar Anúncio
    
-   Salvar Origem do Lead
    
-   Persistir dados no CRM
    

Fluxo:

(Adicionar link do fluxo)

* * *

## Tracking #2 — Eventos de Conversão

Responsável por enviar para a Meta:

-   leadSubmitted
    
-   ViewContent
    
-   AddToCart
    
-   InitiateCheckout
    
-   Purchase
    

Benefícios

-   Melhor atribuição
    
-   Melhor aprendizado
    
-   Melhor otimização
    
-   Fechamento completo do funil
    

Fluxo:

(Adicionar link do fluxo)

* * *

## Tracking #3 — SHA256 (Fallback)

Utilizado quando não existir:

-   CTWA CLID
    
-   FBCLID
    
-   FBC
    

Realiza o envio utilizando telefone em SHA256.

## Limitações

Método

Qualidade

<table data-id="804f16d4-3a7a-4ca8-980e-b44952e100ee" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="c1318ba7-4a14-4f1f-a9d8-62269a792d2a">CTWA CLID</p></td><td colspan="1" rowspan="1"><p data-id="12f77e4d-c603-4bc9-9c69-639aaab173a0"><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="192dec3e-83c9-4263-a7ae-4a2dea706f50">FBCLID</p></td><td colspan="1" rowspan="1"><p data-id="d713681f-32dc-4845-9e4b-c106ec2f4f5a"><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a3a4bdfe-5deb-4295-9384-c5a36e316113">FBC</p></td><td colspan="1" rowspan="1"><p data-id="61c638ac-4bfe-4116-b10e-52e8fd7785ff"><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span><span data-name="star" data-type="emoji">⭐</span></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="f9162c49-0724-4d40-ba52-21a34f6de562">SHA256</p></td><td colspan="1" rowspan="1"><p data-id="aa25f7d3-f319-4e8d-98db-643e70eb371d"><span data-name="star" data-type="emoji">⭐</span></p></td></tr></tbody></table>

Esse método continua alimentando a Meta, porém gera pouca atribuição e baixo impacto na otimização das campanhas.

Utilize apenas como complemento.

Fluxo:

(Adicionar link do fluxo)

* * *

## Boas Práticas

-   Envie apenas eventos reais.
    
-   Não envie Purchase antes da confirmação do pagamento.
    
-   Não envie eventos duplicados.
    
-   Salve o datasetId para reutilização.
    
-   Utilize sempre o CTWA CLID quando disponível.
    
-   Envie o valor real da venda no evento Purchase.
    
-   Utilize o Tracking #3 apenas quando não houver CTWA CLID ou FBCLID.
    

* * *

## Checklist Final

-   ☐ App criado
    
-   ☐ App publicado
    
-   ☐ Usuário de Sistema criado
    
-   ☐ Token gerado
    
-   ☐ Permissões corretas
    
-   ☐ WABA ID localizado
    
-   ☐ Dataset criado
    
-   ☐ Dataset salvo
    
-   ☐ Tracking #1 configurado
    
-   ☐ Tracking #2 configurado
    
-   ☐ Tracking #3 configurado SE necessário
    
-   ☐ Eventos chegando na Meta
    
-   ☐ Purchase validado
    
-   ☐ Conversões sendo atribuídas corretamente
