Rastreio de anúncios e Envio de evento compra para Facebook

Criação De App, Geração De Token E Dataset (whats App + Marketing Api)

Objetivo deste guia é complementar o vídeo abaixo

Não estamos criando o App para uso funcional direto, e sim para:

• Gerar um token de sistema confiável

• Integrar esse token ao CRM Datacrazy

• Rastrear leads vindos de anúncios (Tracking #1)

• Enviar eventos de compra para o Pixel do WhatsApp (Tracking #2)

Este token é a base de toda a integração de tracking com a Meta.

Etapa 1 – Criar o APP

Casos de uso ao criar o App

Durante a criação do App, selecione os seguintes casos de uso principais:

• Criar e gerenciar anúncios com a API de Marketing

• Conectar-se com clientes pelo WhatsApp

• Gerenciar tudo pela sua Página do Facebook

Casos de uso adicionais (obrigatórios)

Após criar o App, adicione também:

• read_insights
  Caminho: Gerenciar Páginas → clicar em ADICIONAR

• whatsapp_business_manage_events
  Caminho: Conectar no WhatsApp → clicar em ADICIONAR

Esses casos de uso são necessários para liberar permissões que serão usadas no token.

Etapa 2 – Configurar links obrigatórios do App

No menu de configurações do App, informe:

• URL da Política de Privacidade
  https://datacrazy.io/politica

• URL dos Termos de Serviço
  https://datacrazy.io/termos

• URL para Exclusão de Dados do Usuário
  https://datacrazy.io/politica

Após preencher:

Clique em Salvar
Depois em Publicar
Status do App: OK / Ativo

Etapa 3 – Criar Usuário de Sistema

1. Acesse Usuários de Sistema

2. Crie um usuário com:

   • Tipo: ADMIN

   • Nome: Tracking

Atribuir o App ao usuário

1. Selecione o usuário criado

2. Clique nos três pontos (…)

3. Escolha Atribuir ativos

4. Selecione APP

5. Atribua o App criado anteriormente com:

   • Permissão: Controle total

Etapa 4 – Gerar Token de Sistema

1. Com o usuário Tracking selecionado

2. Clique em Gerar Token

3. Selecione o App criado

4. Defina a expiração: NUNCA

Permissões necessárias no token

Marque as seguintes permissões:

• ads_read

• whatsapp_business_management

• whatsapp_business_messaging

• whatsapp_business_manage_events (necessita caso de uso ativo)

• read_insights (necessita caso de uso ativo)

Gere e salve o token com segurança.

Atenção importante: O token só é exibido uma única vez no momento da geração. Se você fechar a janela/modal sem salvar, ele não poderá ser visualizado novamente.

Caso isso aconteça, será necessário gerar um novo token (não causa problemas técnicos, apenas retrabalho). Por isso, salve o token imediatamente em um local seguro.

Etapa 5 – Identificar o WABA ID

O WABA ID é o ID da sua conta de WhatsApp Business e será utilizado nas chamadas de API.

Como encontrar o WABA ID

1. Acesse Conexões no CRM Datacrazy

2. Clique na sua conexão de WhatsApp

3. Acesse Gerenciar / Atualizar conexão

4. Localize o campo ID do WhatsApp Business (WABA ID)

Imagem #1 – Localização do WABA ID
A imagem abaixo destaca exatamente onde o WABA ID pode ser encontrado na tela de configuração da conexão.

Este é o valor que deve ser utilizado nas chamadas de API nas próximas etapas.

Imagem #1

Etapa 6 – Consultar ou criar Dataset via API

Para esta etapa, utilizaremos o ReqBin para testar a API:

https://reqbin.com/

Endpoint

https://graph.facebook.com/v16.0/_WABA_ID_/dataset?access_token=_SEU_TOKEN_

Substitua:

• _WABA_ID_ pelo WABA ID da sua conta

• _SEU_TOKEN_ pelo token gerado na etapa anterior

Passo 6.1 – Consultar Dataset (GET)

• Method: GET

• URL: endpoint acima

Resultado esperado

• Se retornar dados → dataset já existe

• Se retornar vazio → será necessário criar

Passo 6.2 – Criar Dataset (POST)

Se o GET não retornar nenhum dataset:

• Method: POST

• URL: mesmo endpoint

• Headers:

Content-Type: application/json

O corpo da requisição pode variar conforme a API. Caso seja exigido, siga o padrão indicado no vídeo/tutorial.

Resultado esperado

• Status 200 ou 201 → Dataset criado com sucesso
  
  Imagem #2

  

Etapa 7 – Finalização

Após concluir todas as etapas:

App criado e publicado
Usuário de sistema configurado
Token gerado com permissões corretas
Dataset criado ou validado

Observações finais

• Sempre siga a ordem das etapas

• Permissões só aparecem no token se o caso de uso estiver ativo

• Use o vídeo de apoio para validar detalhes específicos de payload

Siga os passos do vídeo conforme indicado.

Fluxos utilizados:

Tracking #1 – Rastreamento de Leads

Responsável por receber leads e salvar as informações do anúncio que originou o clique.

Este fluxo utiliza o token gerado pelo App para:

• Identificar a origem do lead (campanha, conjunto, anúncio)

• Associar o lead ao anúncio correto

Persistir esses dados no CRM Datacrazy

Link fluxo #1:
https://drive.google.com/file/d/1-ZomxV6V44HQly1Rmk4CHM1_aoVGoOSl/view?usp=drive_link,

Tracking #2 – Envio de Evento de Compra (Pixel WhatsApp)

Responsável por enviar eventos de compra (ganho) para o Pixel do WhatsApp Business.

Este fluxo permite:

• Reportar conversões para a Meta

• Melhorar otimização e aprendizado dos anúncios

• Fechar o ciclo de rastreamento entre anúncio → lead → compra

Link fluxo #2:

https://drive.google.com/file/d/1GxH3Cbzrh7mhkiXY_CTNZCoEN4bejsSS/view?usp=drive_link