---
title: Como conectar a Meta Ads na Simplesdesk e rastrear a origem dos seus leads
source: https://simplesdesk.com.br/blog/como-conectar-meta-ads-rastrear-origem-leads
author: Equipe SimplesDesk
published_at: 2026-08-05T19:46:13.425228+00:00
updated_at: 2026-08-05T19:46:13.425228+00:00
tags: Meta Ads, Conversions API, Rastreamento, Origem de Leads
attribution: "Fonte: SimplesDesk (https://simplesdesk.com.br/blog/como-conectar-meta-ads-rastrear-origem-leads)"
license: uso permitido com atribuição e link para a fonte original
---

# Como conectar a Meta Ads na Simplesdesk e rastrear a origem dos seus leads

Passo a passo para obter Dataset ID (Pixel), token da Conversions API, token da Marketing API e Test Event Code — e por que o rastreamento de origem muda o jogo do seu custo por lead.


Investir em anúncios sem saber qual campanha gerou qual cliente é o erro mais caro do marketing digital brasileiro. Você olha o gerenciador da Meta, vê 300 conversas iniciadas, olha o CRM, vê 12 vendas — e não consegue ligar uma ponta na outra.

Este guia mostra, na prática, como conectar sua conta Meta à Simplesdesk usando **Dataset ID (Pixel)**, **token da Conversions API**, **token da Marketing API** e **Test Event Code**, e como isso alimenta a tela **Origem dos Leads** com dados reais de campanha, conjunto e criativo.

## Neste guia

- [Por que rastrear a origem do lead](#por-que-rastrear-a-origem-do-lead)
- [As quatro credenciais que você vai precisar](#as-quatro-credenciais-que-voce-vai-precisar)
- [1. Dataset ID (Pixel)](#1-dataset-id-pixel)
- [2. Token da Conversions API](#2-token-da-conversions-api)
- [3. Token da Marketing API (ads_read)](#3-token-da-marketing-api-ads-read)
- [4. Test Event Code](#4-test-event-code)
- [Conectando tudo na Simplesdesk](#conectando-tudo-na-simplesdesk)
- [Como funciona o rastreamento na prática](#como-funciona-o-rastreamento-na-pratica)
- [A tela Origem dos Leads](#a-tela-origem-dos-leads)
- [Erros comuns e como evitar](#erros-comuns-e-como-evitar)
- [Checklist final](#checklist-final)
- [FAQ](#faq)

## Por que rastrear a origem do lead

A Meta otimiza campanhas com base no que você devolve para ela. Se o único sinal que ela recebe é "alguém clicou" ou "alguém iniciou uma conversa", o algoritmo vai buscar mais pessoas que clicam e conversam — não mais pessoas que compram.

Quando você devolve os eventos certos (lead qualificado, oportunidade criada, venda ganha) com valor monetário, a Meta passa a procurar o perfil de quem realmente fecha negócio. Na prática, três coisas acontecem:

1. **O custo por lead qualificado cai** porque a otimização deixa de perseguir volume.
2. **Você descobre quais criativos vendem**, não apenas quais geram cliques baratos.
3. **Você para de cortar campanha boa por engano** — aquela que gera menos leads, mas de ticket muito maior.

![Jornada do lead: do anúncio à receita e de volta para a Meta](/blog/diagrama-jornada-lead-meta.svg)

Há ainda um motivo técnico: o rastreamento apenas pelo navegador (Pixel) perde uma parte enorme dos eventos por bloqueadores, restrições de cookies, iOS e conversas que acontecem dentro do WhatsApp — onde não existe navegador nenhum. A **Conversions API (CAPI)** resolve isso enviando os eventos do servidor da Simplesdesk direto para a Meta.

## As quatro credenciais que você vai precisar

| Campo | Onde obter | Obrigatório | Para que serve |
| --- | --- | --- | --- |
| Dataset ID (Pixel) | Events Manager | Sim | Identifica para qual conjunto de dados os eventos vão |
| Token da Conversions API | Events Manager | Sim | Autoriza o envio de eventos server-side |
| Token da Marketing API | Meta for Developers | Opcional | Traz nomes de campanha, conjunto e criativo |
| Test Event Code | Events Manager | Opcional | Valida a integração antes de ir para produção |

![Onde encontrar cada credencial da Meta](/blog/diagrama-credenciais-meta-ads.svg)

> Pré-requisito: você precisa ser **administrador do Business Manager** e ter a conta de anúncios e o dataset dentro do mesmo BM. Se o seu BM ainda não é verificado, comece por [este guia de verificação](/blog/como-verificar-business-manager-meta).

## 1. Dataset ID (Pixel)

O Dataset ID é o antigo "Pixel ID". Desde 2024 a Meta unificou pixel, eventos offline e eventos de app em um único conceito: **dataset**.

Como obter:

1. Acesse o **Events Manager** (business.facebook.com/events_manager).
2. No menu lateral, clique em **Fontes de dados**.
3. Selecione o dataset da sua operação (ou crie um novo em **Conectar fontes de dados → Web**).
4. O número que aparece abaixo do nome é o Dataset ID — algo como `112329758171301`, com 15 ou 16 dígitos.

Copie e guarde. É um identificador público, não é um segredo — mas confira duas vezes: colar o dataset errado faz seus eventos irem para o lugar errado e você não recebe nenhum erro.

### Um dataset por operação, não por campanha

Um erro clássico é criar um dataset por campanha. Não faça isso. Quanto mais eventos um mesmo dataset acumula, mais rápido a Meta sai da fase de aprendizado. Use **um dataset por negócio** (ou por marca, no caso de whitelabel com operações distintas).

## 2. Token da Conversions API

Esse é o token que autoriza a Simplesdesk a enviar eventos direto para a Meta, sem depender do navegador do lead.

Como gerar:

1. No **Events Manager**, abra o seu dataset.
2. Vá em **Configurações** (aba superior).
3. Role até a seção **Conversions API**.
4. Clique em **Gerar token de acesso**.
5. Copie o token inteiro — ele começa com `EAA...` e é longo.

Pontos de atenção:

- O token é exibido **uma única vez**. Se perder, gere outro (o anterior continua válido até você revogá-lo).
- O token herda as permissões do usuário que o gerou. Se essa pessoa sair da empresa e for removida do BM, o token para de funcionar. Gere com um usuário administrador estável, de preferência uma conta corporativa.
- Nunca envie esse token por WhatsApp, e-mail ou planilha compartilhada. Cole diretamente na tela de integração.

## 3. Token da Marketing API (ads_read)

Esse token é **opcional**, mas é ele que transforma "veio de anúncio Meta" em "veio da campanha Black Friday – Conjunto Lookalike 1% – Criativo Vídeo 15s".

Sem ele, a Simplesdesk consegue identificar que o lead veio de um anúncio, mas exibe apenas o ID da campanha. Com ele, exibe os nomes legíveis.

Como gerar:

1. Acesse **developers.facebook.com** e entre no app que você usa para essa integração (ou crie um app do tipo **Business**).
2. Abra o **Graph API Explorer**.
3. Selecione o app e o Business Manager corretos.
4. Em permissões, adicione **`ads_read`** (e `business_management` se você gerencia várias contas).
5. Gere o token e, em seguida, converta-o em **token de longa duração** na ferramenta **Access Token Debugger** — tokens curtos expiram em cerca de 1 hora.

> Dica: no Access Token Debugger, confira o campo **Expires**. Se estiver "Never", você tem um token de sistema; se mostrar uma data, agende a renovação. Tokens de usuário de sistema (System User) no Business Settings são a opção mais estável para produção.

A permissão `ads_read` é somente leitura — ela não permite criar, pausar ou alterar campanhas. É o mínimo necessário e o mais seguro.

## 4. Test Event Code

O Test Event Code serve para você validar a integração **antes** de contaminar os dados reais.

Como obter:

1. No **Events Manager**, abra o dataset.
2. Vá na aba **Testar eventos**.
3. Copie o código exibido, no formato `TEST12345`.

Enquanto esse código estiver preenchido na Simplesdesk, os eventos aparecem na tela de teste em tempo real e **não** entram na otimização das campanhas. É exatamente o que você quer durante a configuração.

**Importante:** remova o Test Event Code assim que a validação terminar. Se ele ficar preenchido, seus eventos reais continuarão sendo tratados como teste e a Meta não vai usá-los para otimizar nada — é a causa número um de "configurei tudo e não aconteceu nada".

## Conectando tudo na Simplesdesk

Com as credenciais em mãos:

1. Abra **Relatórios → Origem Leads → Campanhas → Meta Ads**.
2. Clique em **Conexão Meta (Conversions API)**.
3. Cole o **Dataset ID**, o **Token da Conversions API** e, se tiver, o **Token Marketing API**.
4. Cole o **Test Event Code** temporariamente.
5. Marque as opções desejadas:
   - **Ativar envio de eventos de conversão (CAPI)** — liga o envio server-side.
   - **Etiquetar automaticamente leads vindos de anúncios Meta** — cria etiquetas de origem no contato.
   - **Enviar evento ao qualificar lead (oportunidade criada)** — dispara `Lead` quando a oportunidade nasce no CRM.
   - **Enviar evento de compra ao ganhar a oportunidade** — dispara `Purchase` com o valor do negócio.
6. Clique em **Testar conexão** e confirme no Events Manager que o evento apareceu.
7. Salve, volte, **apague o Test Event Code** e salve de novo.

Todos os tokens ficam criptografados no nosso banco e nunca são exibidos novamente na interface.

### Quais eventos a Simplesdesk envia

| Evento Meta | Quando dispara | Valor enviado |
| --- | --- | --- |
| `Lead` | Oportunidade criada no CRM a partir do contato | Opcional (valor estimado) |
| `Purchase` | Oportunidade marcada como ganha | Valor do negócio fechado |
| `Contact` | Primeira mensagem de um lead vindo de anúncio | — |

Os eventos são enviados com dados de correspondência com hash (telefone, e-mail quando disponível) seguindo o padrão SHA-256 exigido pela Meta. Nada em texto puro sai da plataforma.

## Como funciona o rastreamento na prática

Quando alguém clica em um anúncio **Click to WhatsApp**, a Meta injeta na primeira mensagem um objeto de referral que contém o identificador do clique (`ctwa_clid`), o ID do anúncio e, às vezes, o texto do criativo.

A Simplesdesk lê esse objeto no momento em que a mensagem chega, guarda no contato e usa três coisas:

1. **Etiqueta automática de origem** — o contato já nasce marcado como "Meta Ads".
2. **Enriquecimento via Marketing API** — busca os nomes de campanha, conjunto e criativo pelo ID do anúncio.
3. **Chave de atribuição** — o `ctwa_clid` volta junto com os eventos de `Lead` e `Purchase`, fechando o ciclo.

Para leads que vêm do site, do Instagram ou de outros canais, o mesmo mecanismo funciona com parâmetros UTM e com o identificador do clique do navegador (`fbclid`), quando presentes.

### Por que isso importa mais no WhatsApp

No WhatsApp não existe cookie, não existe pixel de página e o usuário nunca passa por um navegador que você controla. Sem o referral capturado no servidor, a atribuição simplesmente não existe. É por isso que operações que vendem por WhatsApp e não usam CAPI costumam ter uma diferença de 40% a 70% entre o que a Meta reporta e o que aparece no CRM.

## A tela Origem dos Leads

Com a conexão ativa, a aba **Origem dos Leads** passa a mostrar:

- **Total de contatos no período** (7 dias, 30 dias, 90 dias, 12 meses).
- **Distribuição por origem** — WhatsApp, Instagram, Facebook, Site, Panfleto, Workshop e origens personalizadas, com contagem e percentual.
- **Aba Campanhas** — desempenho por campanha, conjunto e criativo, quando o token da Marketing API estiver configurado.
- **Exportar CSV** — para cruzar com planilhas ou BI.

O valor prático aparece quando você compara: a origem com mais volume raramente é a com melhor conversão. É comum ver o Instagram trazer 18% dos contatos e responder por 40% da receita, ou um criativo com CPL alto ser o único que gera ticket acima da média.

### Origens offline também contam

Nem todo lead vem de anúncio. Panfleto, workshop, indicação e evento são origens legítimas e devem ser registradas — senão você atribui ao digital vendas que vieram de outro lugar, e vice-versa. Na Simplesdesk essas origens são cadastráveis e aparecem no mesmo relatório, o que dá uma visão honesta do funil inteiro.

## Erros comuns e como evitar

| Erro | Sintoma | Correção |
| --- | --- | --- |
| Test Event Code esquecido | Eventos aparecem só na aba de teste | Apague o campo e salve |
| Dataset de outro BM | "Nenhum evento recebido" sem erro | Confirme o dataset dentro do BM correto |
| Token da Marketing API sem `ads_read` | Campanhas aparecem só como ID | Regenere com a permissão correta |
| Token de curta duração | Para de funcionar em ~1 hora | Converta em token de longa duração ou use System User |
| Usuário que gerou o token removido do BM | Integração quebra do nada | Gere com conta corporativa administradora |
| Evento duplicado (Pixel + CAPI) | Conversões infladas | Use o mesmo `event_id` nos dois canais (deduplicação) |
| CAPI desativado no checkbox | Nada é enviado, mesmo com tokens corretos | Marque "Ativar envio de eventos de conversão" |

### Sobre deduplicação

Se você já usa o Pixel no site e ativa a CAPI, o mesmo evento pode chegar duas vezes. A Meta deduplica automaticamente quando os dois envios compartilham o mesmo `event_id` e o mesmo `event_name`. A Simplesdesk gera esse ID de forma determinística; se você tem uma implementação de Pixel própria no site, alinhe o `event_id` com o time técnico.

## Checklist final

- [ ] Business Manager verificado
- [ ] Dataset criado e Dataset ID copiado
- [ ] Token da Conversions API gerado por administrador estável
- [ ] Token da Marketing API com `ads_read` e longa duração (se for usar nomes de campanha)
- [ ] Test Event Code preenchido para validar
- [ ] Evento de teste visto no Events Manager
- [ ] Test Event Code removido
- [ ] CAPI ativado e eventos de Lead/Purchase marcados
- [ ] Origens offline cadastradas
- [ ] Primeira leitura do relatório feita depois de 7 dias de dados

## FAQ

**Preciso do token da Marketing API para funcionar?**
Não. Sem ele a integração envia e recebe eventos normalmente; você só perde os nomes legíveis de campanha, conjunto e criativo, que passam a aparecer como identificadores numéricos.

**O Test Event Code atrapalha as campanhas?**
Ele impede que os eventos sejam usados na otimização enquanto estiver preenchido. Serve para validar e deve ser removido logo depois.

**Quanto tempo leva para a Meta usar os dados novos?**
Os eventos aparecem no Events Manager em segundos. A otimização das campanhas normalmente leva de 3 a 7 dias para refletir o novo sinal, dependendo do volume de conversões.

**Dá para usar mais de uma conta de anúncios?**
Sim, desde que as contas estejam no mesmo Business Manager e o dataset esteja compartilhado com elas.

**Os dados dos contatos são enviados para a Meta?**
Apenas dados de correspondência com hash SHA-256, conforme a documentação da Conversions API. Nenhum dado pessoal em texto puro sai da plataforma.

**E se eu vendo por WhatsApp e não tenho site?**
Esse é justamente o cenário em que a CAPI faz mais diferença: sem site, o Pixel não tem onde rodar e a atribuição depende inteiramente do envio server-side.

## Próximo passo

Se você quiser revisar sua configuração de rastreamento ou entender como a atribuição fica na sua operação, [fale com nosso time comercial](https://wa.me/551131362329).

### Fontes e leitura

- [Meta — Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/)
- [Meta — Events Manager](https://www.facebook.com/business/help/898185560232180)
- [Meta — Anúncios de clique para o WhatsApp](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/set-up-ads-that-click-to-whatsapp)
- [Meta — Permissões da Marketing API](https://developers.facebook.com/docs/marketing-api/overview/authorization/)


---
_Conteúdo produzido pela SimplesDesk. Ao citar, credite: SimplesDesk — https://simplesdesk.com.br/blog/como-conectar-meta-ads-rastrear-origem-leads_