Leaper Central de Ajuda
Desenvolvedores Entrar

Visão Geral do Onboarding

Checklist completo para configurar a Leaper

Para que a Leaper funcione corretamente e você não perca dados de leads ou conversões, é essencial seguir todos os passos de configuração. Este guia apresenta uma visão geral do processo e as consequências de pular cada etapa.

Atenção: Configuração parcial é pior que configuração nenhuma: você terá dados incompletos e pode tomar decisões erradas baseadas neles.
Atenção: Se você roda campanhas de MENSAGEM e de SITE, precisa configurar AMBOS os tipos. Um não substitui o outro.
Atenção: OAuth pode expirar. Verifique periodicamente se as conexões ainda estão ativas.

Por que a configuração é importante?

A Leaper rastreia leads vindos de campanhas de Meta Ads e Google Ads, identifica de qual campanha/anúncio vieram, e envia conversões de volta para otimizar suas campanhas. Para isso funcionar, cada peça precisa estar configurada corretamente.

  • Leads não rastreados não podem ser atribuídos a campanhas específicas
  • Conversões não enviadas impedem a otimização automática das plataformas
  • Configuração incompleta resulta em dados parciais ou incorretos no dashboard

Etapas do Onboarding

O processo de configuração segue uma ordem lógica. Cada etapa depende das anteriores:

  1. 11. Conectar WhatsApp (OBRIGATÓRIO)Sem o WhatsApp conectado, NENHUM lead é capturado. A plataforma fica completamente inoperante. Este é o primeiro e mais crítico passo. Vá em Configurar > WhatsApp e escaneie o QR Code.
  2. 22. Definir Fontes de TráfegoSelecione se você usa Meta Ads, Google Ads ou ambos. No Wizard de Onboarding, escolha as plataformas que usa. Isso define quais configurações serão exibidas.
  3. 33. Definir Tipo de CampanhaMENSAGEM: campanhas que levam direto para WhatsApp (botão 'Enviar Mensagem'). SITE: campanhas que levam para uma landing page antes do WhatsApp. AMBOS: se você roda os dois tipos, precisa configurar tudo.
  4. 44. Autorizar Plataformas (OAuth)Conecte sua conta do Meta e/ou Google via OAuth. Isso permite que a Leaper acesse dados das campanhas e envie conversões. Cada plataforma tem consequências específicas se não estiver conectada.
  5. 55. Configurar IDs e PixelsPara MENSAGEM: WhatsApp Business ID + Pixel de Mensagem. Para SITE: Pixel do Meta + IDs do Google. Esses identificadores são usados para rastrear e enviar conversões.
  6. 66. Criar Gatilhos de ConversãoDefina a lógica: 'quando lead entrar no status X, enviar evento Y'. Exemplo: status 'Qualificação' dispara evento 'Lead', status 'Convertido' dispara 'Purchase'.
  7. 77. Criar Link Rastreável (para Site)Links rastreáveis substituem os links normais de WhatsApp no seu site. Eles capturam UTMs e redirecionam para o WhatsApp com dados de origem.
  8. 88. Instalar Script no SiteO script Leaper deve ser instalado no <head> do seu site. Ele captura dados de origem, campanha e UTMs dos visitantes.

Consequências de Configuração Incompleta

Entenda exatamente o que acontece se você pular cada etapa:

  • WhatsApp não conectado → Nenhum lead é capturado, plataforma inoperante
  • OAuth Meta não conectado → Leads de mensagem chegam SEM campanha/conjunto/anúncio identificados
  • OAuth Google não conectado → Não consegue enviar conversões para Google Ads
  • Pixel de Mensagem não configurado → Leads de mensagem chegam COM origem, mas NÃO envia conversões
  • Pixel normal não configurado → Não envia conversões de campanhas de site para Meta
  • Gatilhos não criados → Plataformas não recebem conversões, não otimizam campanhas
  • Script não instalado → Link rastreável redireciona, mas não captura UTMs e origem
  • Links não substituídos → Leads do site chegam como 'Não Rastreados'
Dica: Use o Wizard de Onboarding (tela inicial após criar empresa) para ser guiado passo a passo em cada configuração.
Dica: Complete todo o onboarding ANTES de ativar campanhas para não perder dados iniciais.
Dica: Após configurar, faça um teste real: clique em um anúncio e verifique se o lead chega com todos os dados corretos.

Problemas comuns

O Wizard de Onboarding não aparece
O Wizard só aparece para empresas novas. Para empresas existentes, configure manualmente em Configurar > Meta Ads / Google Ads.
Não sei se preciso de configuração de Mensagem ou Site
Verifique suas campanhas no Gerenciador de Anúncios. Campanhas com objetivo 'Mensagens' ou 'Engajamento' direcionam para WhatsApp. Campanhas com 'Tráfego' ou 'Conversões' geralmente vão para site.
Configurei tudo mas leads ainda chegam sem dados
Verifique cada etapa: WhatsApp conectado (verde), OAuth ativo (não expirado), IDs corretos (copie novamente do Meta/Google), script instalado (verifique código-fonte da página).