Principal Integrações Como usar o seu pixel atual para medir conversões dos anúncios de WhatsApp (API de Conversões)

Como usar o seu pixel atual para medir conversões dos anúncios de WhatsApp (API de Conversões)

Última atualização em Oct 02, 2026

Os anúncios que levam para o WhatsApp ("Click to WhatsApp") só registram conversões na Meta quando os eventos vão para um conjunto de dados (dataset/pixel) conectado à sua conta do WhatsApp Business. Se o seu pixel atual não está conectado ao WhatsApp, a aba Eventos de teste dele mostra apenas os canais Offline, Website e CRM, sem a opção Mensagens.

Este tutorial mostra como deixar o pixel que você já usa pronto para receber as conversões do WhatsApp enviadas pela SimplesDesk.

Antes de começar: você precisa ser administrador do Gerenciador de Negócios que é dono da conta do WhatsApp Business.


1. Descubra a qual empresa pertence o seu WhatsApp

  1. Acesse business.facebook.com/settings.
  2. No seletor do topo, escolha a empresa que aparece como dona da sua conta do WhatsApp Business (menu Contas › Contas do WhatsApp).
  3. Anote:
    • o ID da conta do WhatsApp Business;
    • o ID do pixel que você quer usar (em Fontes de dados › Conjuntos de dados).

2. Verifique se o pixel já está conectado ao WhatsApp

  1. Abra o Gerenciador de Eventos com a mesma empresa selecionada.
  2. Escolha o seu pixel e abra a aba Eventos de teste.
  3. Clique no seletor "Selecione um canal de marketing":
    • Se aparecer Mensagens, o pixel já está conectado. Pule para o passo 4.
    • Se aparecer só Offline, Website e CRM, siga o passo 3.

3. Conecte o pixel à conta do WhatsApp

Opção A: pelas configurações do pixel

  1. Em Configurações do Negócio › Fontes de dados › Conjuntos de dados, abra o seu pixel.
  2. Procure Ativos conectados › Adicionar ativos › Contas do WhatsApp e selecione a sua conta.
  3. Salve e repita o passo 2 para confirmar que a opção Mensagens apareceu.

Opção B: pelo suporte da Meta, se a opção A não aparecer ou a Meta bloquear porque a conta do WhatsApp já tem outro conjunto de dados

Abra um chamado em Meta Business Support (business.facebook.com/business/help → Falar com o suporte) e envie:

Olá! Usamos a API de Conversões para mensagens comerciais (WhatsApp). Precisamos que o conjunto de dados [ID do seu pixel] seja associado à conta do WhatsApp Business [ID da conta do WhatsApp], da empresa [nome / ID do Gerenciador de Negócios]. Se houver outro conjunto de dados associado a essa conta do WhatsApp, pedimos que ele seja substituído pelo [ID do seu pixel]. Obrigado!

Quando a Meta confirmar, repita o passo 2.

4. Gere o token do pixel

  1. No Gerenciador de Eventos, abra o seu pixel e vá em Configurações.
  2. Na seção API de Conversões, clique em Gerar token de acesso e copie o token.
    • Use esse botão. O da seção API de Qualidade do Dataset gera um token que não serve para este fim.
  3. Na aba Eventos de teste, com o canal Mensagens selecionado, copie o código de teste (começa com TEST).

5. Configure na SimplesDesk

  1. Acesse Marketing › Campanhas › Conexão Meta (CAPI) (ou Configurações › Integrações › Meta Ads).
  2. Preencha:
    • ID do conjunto de dados: o ID do seu pixel;
    • Token de acesso: o token gerado no passo 4;
    • Código de evento de teste: o código copiado no passo 4.
  3. Salve e clique em Testar conexão.

6. Como confirmar que está funcionando

  • Teste de conexão: se o botão Testar conexão mostrar "(#100) Missing Permission", veja a primeira pergunta abaixo. Para validar o envio, fale com o nosso suporte: enviamos um evento de teste que aparece na aba Eventos de teste do pixel.
  • Conversões do WhatsApp: só aparecem quando chega um lead real vindo de um anúncio de WhatsApp. A Meta não aceita evento de mensagem simulado, porque confere o clique no anúncio. Depois do primeiro lead, acompanhe em Integrações › Meta Ads › Últimos envios.

Dica: depois de validar, você pode apagar o código de teste. Enquanto ele estiver preenchido, os eventos de teste aparecem só na aba Eventos de teste.


Perguntas frequentes

O botão "Testar conexão" mostra "(#100) Missing Permission". O token está errado? Não necessariamente. O token gerado pelo Gerenciador de Eventos não tem permissão para ler o pixel, só para enviar eventos, e o teste tenta ler o pixel. Se você gerou o token pelo botão Gerar token de acesso da seção API de Conversões, ele está certo: fale com o nosso suporte para validarmos com um evento de teste.

Posso usar o mesmo pixel do meu site? Sim. A Meta recomenda usar o mesmo conjunto de dados para site e servidor. Ele só precisa estar conectado à conta do WhatsApp (passo 3).

Criei um conjunto de dados novo sem querer. Perco alguma coisa? Não. Se a conta do WhatsApp estiver conectada a outro conjunto de dados, peça à Meta (opção B) para trocar pelo seu pixel. Os eventos já enviados continuam no conjunto de dados antigo.

Este artigo foi útil?