Leaper Central de Ajuda
Desenvolvedores Entrar

Campanhas de Mensagem

Configure rastreamento para campanhas Meta direto para WhatsApp

Campanhas de Mensagem são aquelas do Meta Ads que levam o usuário diretamente para o WhatsApp (botão 'Enviar Mensagem' ou 'Enviar WhatsApp'). Este tipo de campanha requer configurações específicas para rastrear a origem e enviar conversões.

Atenção: Se o Dataset NÃO estiver configurado: leads de mensagem chegam COM origem identificada (campanha/conjunto/anúncio), mas você NÃO CONSEGUE enviar conversões de volta. As campanhas não otimizam!
Atenção: Dataset e Pixel Normal são coisas diferentes. Configurar só um não resolve o outro tipo de campanha.
Atenção: O Dataset precisa estar associado ao MESMO número de WhatsApp Business usado nas campanhas.
Atenção: Se o OAuth do Meta não estiver conectado, leads de mensagem chegam SEM dados de campanha/conjunto/anúncio, independente do Dataset.

O que são Campanhas de Mensagem?

No Meta Ads (Facebook/Instagram), você pode criar campanhas com objetivo de 'Mensagens' ou 'Engajamento' que direcionam o usuário para iniciar uma conversa no WhatsApp. Quando alguém clica no anúncio, o WhatsApp abre automaticamente com uma mensagem pré-definida.

  • Objetivo de campanha: 'Mensagens' ou 'Engajamento'
  • Destino: WhatsApp (direto, sem passar por um site)
  • Botão do anúncio: 'Enviar Mensagem', 'Enviar WhatsApp' ou similar
  • Lead chega diretamente no WhatsApp conectado à Leaper

O que você precisa configurar

Para campanhas de mensagem funcionarem corretamente, você precisa de três elementos:

  • OAuth do Meta conectado - para identificar de qual campanha/conjunto/anúncio o lead veio
  • WhatsApp Business ID - para vincular o número à conta de anúncios
  • Pixel de Mensagem - para enviar conversões de volta ao Meta

Configurar WhatsApp Business ID

O WhatsApp Business ID vincula seu número comercial ao Meta Business Manager:

  1. 1Acesse Configurar > Meta AdsNo menu lateral, vá em Configurar e depois em Meta Ads.
  2. 2Localize a seção 'WhatsApp Business'Role a página até encontrar a seção de configuração do WhatsApp Business.
  3. 3Clique em 'Importar' ou digite manualmenteSe o OAuth está conectado com permissões corretas, clique em 'Importar' para buscar automaticamente. Caso contrário, copie o ID do Business Manager do Meta e cole no campo.
  4. 4Verifique se o número correto foi selecionadoSe você tem múltiplos números no WhatsApp Business, certifique-se de selecionar o mesmo número que está conectado na Leaper.

Configurar Pixel de Mensagem

O Pixel de Mensagem' do Meta é diferente do Pixel normal e serve especificamente para enviar conversões de campanhas de mensagem:

  1. 1Na página Meta Ads, localize 'Pixel de Mensagem'O Dataset aparece na seção de configuração de campanhas de mensagem.
  2. 2Clique em 'Importar' ou digite o IDSe você tem permissão no Business Manager, clique em 'Importar' para buscar automaticamente. O Dataset geralmente é criado automaticamente quando você cria campanhas de mensagem no Meta.
  3. 3Verifique se o Dataset está vinculado ao número corretoO Dataset deve estar associado ao mesmo número de WhatsApp Business que você usa nas campanhas.

Diferença: Dataset vs Pixel Normal

É fundamental entender a diferença entre esses dois identificadores:

  • Dataset (Pixel de Mensagem): usado APENAS para campanhas de mensagem (WhatsApp direto). Envia conversões quando o lead veio de um anúncio de mensagem.
  • Pixel Normal (Pixel do Facebook): usado APENAS para campanhas de site. Envia conversões quando o lead veio de um anúncio que levou para uma landing page.
  • Se você roda AMBOS os tipos de campanha, precisa configurar OS DOIS identificadores.
  • Um não substitui o outro - são canais completamente separados.

Criar Gatilhos de Conversão

Após configurar os IDs, você precisa criar gatilhos para enviar as conversões:

  1. 1Na página Meta Ads, vá para 'Gatilhos de Mensagem'Esta seção é específica para campanhas de mensagem e usa o Dataset.
  2. 2Clique em 'Adicionar Gatilho'Você vai definir: quando o lead entrar em qual status, qual evento enviar.
  3. 3Configure o primeiro gatilho: LeadExemplo: Status = 'Qualificação' → Evento = 'Lead'. Isso envia uma conversão quando o lead é qualificado.
  4. 4Configure o segundo gatilho: PurchaseExemplo: Status = 'Convertido' ou 'Ganho' → Evento = 'Purchase'. Isso envia quando o lead converte em venda.
  5. 5Salve os gatilhosOs gatilhos começam a funcionar imediatamente para novos leads.
Dica: Teste a configuração: clique em um anúncio de mensagem ativo e envie uma mensagem. Verifique se o lead aparece com campanha identificada.
Dica: No Meta Events Manager, você pode verificar se os eventos do Dataset estão sendo recebidos.
Dica: Use pelo menos dois gatilhos: um para 'Lead' (qualificação) e outro para 'Purchase' (conversão).
Dica: Se não encontrar o Dataset para importar, crie uma campanha de mensagem no Meta primeiro - o Dataset é criado automaticamente.

Problemas comuns

Leads de mensagem chegam mas sem campanha/conjunto/anúncio
O OAuth do Meta não está funcionando. Vá em Configurar > Meta Ads e reconecte. Verifique se as permissões foram todas aceitas.
Não consigo encontrar o Dataset para importar
O Dataset é criado quando você cria a primeira campanha de mensagem no Meta. Crie uma campanha de teste ou procure o ID manualmente no Events Manager do Meta.
Conversões não aparecem no Meta Events Manager
Verifique: 1) Dataset está correto? 2) Gatilho está criado? 3) Lead mudou para o status configurado? Conversões podem levar alguns minutos para aparecer.
Erro 'Dataset não encontrado' ou 'ID inválido'
O ID informado está incorreto ou o Dataset foi excluído. Copie novamente o ID do Events Manager do Meta.
Gatilhos criados mas conversões não são enviadas
Verifique se o lead veio de uma campanha de mensagem (não de site). Gatilhos de mensagem só funcionam para leads de campanhas de mensagem.
Tenho campanha de mensagem E de site, qual configurar?
Você precisa configurar AMBOS: Dataset para mensagem E Pixel normal para site. Um não substitui o outro. Configure gatilhos separados para cada tipo.