Integração PandaChat
OneClick Tracking — Integração com o PandaChat
O que é o OneClick Tracking?
Seção intitulada “O que é o OneClick Tracking?”O OneClick Tracking é a funcionalidade da OneClick Ads que permite rastrear conversões reais geradas pelos seus anúncios de forma mais precisa e confiável.
No caso do PandaChat, o lead chega pelo WhatsApp — normalmente por um anúncio de Click to WhatsApp. Quando isso acontece, o PandaChat guarda junto do lead a informação de qual anúncio o trouxe (campanha, conjunto e anúncio da Meta). É esse dado que o OneClick Tracking usa para ligar a conversão ao anúncio certo, tornando o CPA e o ROAS das suas campanhas muito mais precisos.
O que é um webhook?
Seção intitulada “O que é um webhook?”Um webhook é uma forma de um sistema enviar dados automaticamente para outro sistema em tempo real, sempre que um determinado evento acontece.
Nesta integração:
- O PandaChat é quem envia o webhook (com os dados do lead) quando ele muda de etapa no funil.
- O OneClick Tracking é quem recebe esses dados e registra a conversão.
Como funciona a integração (visão geral)
Seção intitulada “Como funciona a integração (visão geral)”- O lead clica no seu anúncio de Click to WhatsApp e inicia uma conversa.
- O PandaChat registra o lead e guarda a atribuição do anúncio de origem.
- Dentro do OneClick Tracking, você conecta seu workspace do PandaChat (com a chave de API) e escolhe quais etapas do funil contam como conversão. Essa seleção acontece no próprio OneClick, não no PandaChat.
- Você envia a sua URL de webhook ao PandaChat, e eles ativam o envio para a sua conta (veja o Passo 3 — esse passo é obrigatório).
- Quando um lead entra em uma dessas etapas, o PandaChat dispara o evento
lead.stage_changedpara a URL do OneClick Tracking. - O OneClick Tracking recebe o evento, confirma que a etapa corresponde ao que você selecionou, identifica o anúncio de origem e registra a conversão.
O funil do PandaChat
Seção intitulada “O funil do PandaChat”O PandaChat usa um funil fixo de 8 etapas, iguais para todos os workspaces. O lead caminha por elas conforme o atendimento avança:
| # | Etapa | Significado |
|---|---|---|
| 1 | Novo lead | Chamou no WhatsApp, ainda não qualificado |
| 2 | Em atendimento | IA ou atendente conversando |
| 3 | Pediu preço | Chegou na parte de valor/oferta |
| 4 | Parou após preço | Recebeu o valor e parou de responder |
| 5 | Interesse alto | Perguntou detalhes importantes |
| 6 | Dados incompletos | Começou a passar dados, falta algo |
| 7 | Aguardando confirmação | Passou os dados, não confirmou |
| 8 | Pedido agendado | Pedido confirmado/agendado — a conversão |
Na maioria dos casos a etapa que representa a conversão é “Pedido agendado”. Você pode selecionar mais de uma etapa se fizer sentido para o seu negócio — por exemplo, acompanhar também “Interesse alto” como um sinal intermediário.
Passo 1 — Obter a chave de API do PandaChat
Seção intitulada “Passo 1 — Obter a chave de API do PandaChat”A chave de API é única por workspace e fica disponível direto no seu painel do PandaChat — não é preciso falar com o suporte.
- No painel do PandaChat, acesse a seção Integração / API.
- Em Sua chave de integração, clique no ícone do olho para revelar a chave (ou use o botão Copiar para copiar sem revelar).
Guarde essa chave — ela será colada no OneClick Tracking no próximo passo, e não é configurada em nenhum lugar dentro do PandaChat.
Passo 2 — Conectar o PandaChat e escolher as etapas de conversão
Seção intitulada “Passo 2 — Conectar o PandaChat e escolher as etapas de conversão”- Acesse o OneClick Tracking dentro da OneClick Ads.
- Selecione a conta de anúncios correspondente.
- Clique em Nova integração (ou Novo tracking).
- Selecione o tipo de produto “Geração de leads” e clique em Continuar.
- Selecione PandaChat como plataforma de origem.
- Cole a chave de API obtida no Passo 1 e clique em Conectar PandaChat.
- Com a conexão feita, o OneClick Tracking lista o seu funil e as 8 etapas. Selecione a(s) etapa(s) que representam uma conversão real — normalmente “Pedido agendado”. É essa seleção, feita aqui dentro do OneClick, que decide quais eventos do PandaChat contam como conversão.
- Clique em Continuar. Na etapa seguinte, copie a URL de webhook gerada — você vai precisar dela no Passo 3.
Passo 3 — Enviar a sua URL de webhook ao PandaChat
Seção intitulada “Passo 3 — Enviar a sua URL de webhook ao PandaChat”Este passo é obrigatório e não pode ser feito pelo OneClick. O PandaChat não tem uma tela de autoatendimento para cadastrar webhooks: a ativação é feita por eles, a pedido, para cada workspace.
- Copie a URL de webhook gerada no Passo 2. Ela é exclusiva da sua conta de anúncios — não reutilize a URL de outra conta.
- Envie essa URL ao suporte do PandaChat e peça para ativarem o envio do evento
lead.stage_changedpara ela. - Aguarde a confirmação de que o webhook foi ativado.
Notas Importantes
Seção intitulada “Notas Importantes”- Cada conta de anúncios tem uma URL de webhook diferente. Se você gerencia múltiplas contas, crie uma integração separada para cada uma e envie cada URL ao PandaChat.
- O webhook só é disparado quando o lead entra em uma etapa, e cada combinação de lead + etapa é enviada uma única vez. Um lead que volta para uma etapa anterior e avança de novo não gera conversão duplicada.
- Uma etapa que você não selecionou no Passo 2 continua sendo enviada pelo PandaChat, mas é descartada pelo OneClick — só as etapas selecionadas viram conversão.
- Para leads de WhatsApp, a atribuição usa o dado nativo de Click to WhatsApp do PandaChat, que é mais confiável que UTM. As UTMs clássicas no PandaChat são capturadas apenas em vendas por checkout, então podem não existir para um lead que veio direto pelo WhatsApp — isso é esperado e não impede o rastreamento.
- Um lead que chegou por um canal sem nenhuma atribuição de anúncio (por exemplo, alguém que salvou o seu número e chamou espontaneamente) não gera conversão rastreada, porque não há anúncio ao qual atribuí-la.
- Após configurar a integração, aguarde o próximo lead chegar à etapa de conversão para verificar se os dados estão chegando corretamente no OneClick Tracking.
Resultado esperado
Seção intitulada “Resultado esperado”Após a configuração — e com o webhook ativado pelo PandaChat — cada vez que um lead avançar até a etapa que você selecionou, o PandaChat enviará automaticamente os dados para o OneClick Tracking. O sistema registra a conversão e a associa ao anúncio de Click to WhatsApp que trouxe aquele lead, permitindo que você veja o CPA e o ROAS reais das suas campanhas diretamente na OneClick Ads.