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

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
• As quatro credenciais que você vai precisar
• 1. Dataset ID (Pixel)
• 2. Token da Conversions API
• 3. Token da Marketing API (ads_read)
• 4. Test Event Code
• Conectando tudo na Simplesdesk
• Como funciona o rastreamento na prática
• A tela Origem dos Leads
• Erros comuns e como evitar
• Checklist final
• 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.

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

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.

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.

1. Clique em Testar conexão e confirme no Events Manager que o evento apareceu.
2. 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

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

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.

Fontes e leitura

• Meta — Conversions API
• Meta — Events Manager
• Meta — Anúncios de clique para o WhatsApp
• Meta — Permissões da Marketing API