--- title: "Integração PandaChat" description: "Aprenda a conectar o OneClick Tracking ao PandaChat para rastrear conversões de leads do WhatsApp nas suas campanhas Meta Ads com precisão." --- OneClick Tracking — Integração com o PandaChat :::tip[Você pode conectar várias plataformas ao mesmo tempo] O OneClick Tracking permite conectar **mais de uma plataforma na mesma conta de anúncios** ao mesmo tempo (por exemplo, Hotmart e Eduzz juntas). Cada plataforma tem a sua própria integração — com o seu próprio link de Webhook ou credencial de acesso — e elas convivem sem competir entre si; basta repetir o passo a passo de **"Nova Integração"** para cada uma que você quiser conectar. A atribuição de cada venda à campanha certa é feita pela **UTM**, e não pela plataforma. Por isso, se uma campanha vende por uma plataforma e outras campanhas vendem por outra, cada conversão é ligada automaticamente à campanha de origem, independentemente de qual plataforma originou a venda. O cenário recomendado é **cada campanha atender a uma única plataforma** — evite uma mesma campanha vendendo em duas plataformas ao mesmo tempo. ::: ## 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? 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) 1. O lead clica no seu anúncio de Click to WhatsApp e inicia uma conversa. 2. O PandaChat registra o lead e guarda a atribuição do anúncio de origem. 3. 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. 4. 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**). 5. Quando um lead entra em uma dessas etapas, o PandaChat dispara o evento `lead.stage_changed` para a URL do OneClick Tracking. 6. 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 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 A chave de API é **única por workspace** e fica disponível direto no seu painel do PandaChat — não é preciso falar com o suporte. 1. No painel do PandaChat, acesse a seção **Integração / API**. 2. 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. :::tip[A chave é só sua e é somente leitura] Segundo o próprio PandaChat, essa chave dá acesso **somente de leitura** aos seus funis e estágios — ela não permite alterar nada na sua conta. Não a compartilhe publicamente. Se desconfiar que alguém teve acesso a ela, gere uma nova chave na mesma tela do PandaChat e reconecte a integração no OneClick com a chave nova. ::: --- ## Passo 2 — Conectar o PandaChat e escolher as etapas de conversão 1. Acesse o **OneClick Tracking** dentro da OneClick Ads. 2. Selecione a conta de anúncios correspondente. 3. Clique em **Nova integração** (ou **Novo tracking**). 4. Selecione o tipo de produto **"Geração de leads"** e clique em Continuar. 5. Selecione **PandaChat** como plataforma de origem. 6. Cole a **chave de API** obtida no Passo 1 e clique em **Conectar PandaChat**. 7. 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. 8. Clique em Continuar. Na etapa seguinte, copie a **URL de webhook** gerada — você vai precisar dela no Passo 3. :::caution[A chave é validada na hora] Se a chave estiver incorreta ou já não for aceita pelo PandaChat, a conexão falha imediatamente e nada é salvo. Confira a chave com o suporte deles e tente novamente. ::: --- ## 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. 1. 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. 2. Envie essa URL ao suporte do PandaChat e peça para ativarem o envio do evento **`lead.stage_changed`** para ela. 3. Aguarde a confirmação de que o webhook foi ativado. :::danger[Sem este passo, nenhuma conversão é registrada] Enquanto o PandaChat não ativar o envio para a sua URL, a integração aparece configurada no OneClick mas **não recebe nada** — e não há como o OneClick detectar isso sozinho. Se depois de alguns dias você não vir conversões chegando, confirme com o suporte do PandaChat se o webhook foi mesmo ativado para a sua URL. ::: --- ## 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 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.