Como atribuir vendas do WooCommerce aos links de WhatsApp

O que você precisa antes de conectar a loja

A integração associa pedidos recebidos do WooCommerce aos links da Grapnel. Entre como proprietário da conta, tenha um link criado e acesso à configuração de webhooks da loja. A configuração fica em Links → Análises do link → Vendas · WooCommerce. Colaboradores e visitantes de relatórios compartilhados não podem configurar a loja.

Uma loja é conectada por conta e atende todos os links dessa conta. Use o endereço HTTPS da loja, sem parâmetros. Depois de salvar, o endereço fica vinculado à integração: não substitua a loja por outra para tentar corrigir uma falha. A ativação dos webhooks, por si só, não importa todo o histórico de pedidos.

Escolha como identificar as vendas do link

O cupom vinculado tem prioridade. Em Cupom deste link (opcional), informe o código que o comprador usará na loja e clique em Salvar cupom antes de ativar os webhooks. A Grapnel vincula o código ao link; ela não cria o cupom nem define seu desconto no WooCommerce. Confira separadamente se o cupom existe e está disponível na loja.

Use um código exclusivo por link: o mesmo cupom não pode ser associado a dois links da conta. Por exemplo, campanha-setembro é apenas um código ilustrativo. Se um pedido usar cupons vinculados a links diferentes, a atribuição pode precisar de conferência, em vez de distribuir a mesma venda entre eles.

Sem cupom vinculado no pedido, a indicação é estimada pela última conversa confirmada no WhatsApp com o mesmo telefone, registrada até o pagamento, sem limite de tempo. O telefone do pedido precisa corresponder ao da conversa, e a conversa precisa ter sido atribuída ao link. Abrir o WhatsApp sem enviar a mensagem não comprova essa etapa. A associação descreve uma regra de atribuição, não demonstra que a campanha causou a compra.

Conecte a loja e guarde o segredo

A URL de entrega e o segredo são gerados na configuração da Grapnel. Copie os valores da sua própria conta: exemplos de outras lojas ou links de divulgação não servem como URL de webhook.

1. No painel da Grapnel, abra Links e escolha Análises no link da campanha.
2. Expanda Vendas · WooCommerce e salve o cupom, caso a campanha utilize um.
3. Em Endereço da loja, informe a URL HTTPS e clique em Conectar loja.
4. Copie a URL de entrega e o Segredo — disponível somente agora. Guarde o segredo em um local privado enquanto configura a loja.
5. Mantenha essa tela disponível até terminar os dois webhooks. O segredo existente não é exibido novamente ao reabrir a configuração.

Configure os dois webhooks no WooCommerce

Os webhooks enviam o estado dos pedidos à Grapnel. O evento de atualização é necessário para acompanhar pagamento, alterações de status e reembolsos recebidos depois da criação do pedido.

1. No WooCommerce, abra Configurações → Avançado → Webhooks e adicione um webhook.
2. Dê um nome que identifique a integração, selecione o tópico Pedido criado e defina o status como Ativo.
3. Preencha URL de entrega e Segredo com os valores copiados da Grapnel e salve.
4. Crie o segundo webhook com o tópico Pedido atualizado, também Ativo, usando exatamente a mesma URL de entrega e o mesmo segredo.
5. Confira os dois registros após salvar. O ping inicial do WooCommerce testa a URL, mas não é um pedido e não preenche o histórico de vendas.

Como conferir se os pedidos estão chegando

Ao salvar a integração, Aguardando o primeiro evento da loja é um estado esperado. Depois de um evento válido de pedido, a configuração passa a mostrar Último evento recebido. Essa data confirma recebimento de um evento; não comprova que todos os pedidos da loja chegaram ou que houve uma venda atribuída.

Se você tiver loja e conta separadas para homologação, valide com um pedido de teste nesse ambiente, incluindo pagamento e atualização de status. Em produção, acompanhe um pedido novo que já faça parte da operação. Não altere o pagamento de um pedido real apenas para fazer o teste.

1. Anote o número do pedido, a data de pagamento e o cupom usado. Para atribuição por telefone, confira também a conversa confirmada anterior à compra.
2. No WooCommerce, abra Status → Logs e procure a entrega do webhook. Confira a resposta da Grapnel; não compartilhe o conteúdo do pedido nem o segredo em capturas públicas.
3. Volte a Análises na Grapnel, use Atualizar e escolha um período que inclua a data do pagamento.
4. Abra Vendas, produtos e gráficos e confira os pedidos e a atribuição. Um pedido recebido ainda sem pagamento não deve ser interpretado como venda paga.

Como interpretar os totais sem confundir receita com lucro

Vendas conta pedidos pagos, em processamento ou concluídos, com saldo positivo. Pedidos cancelados ou totalmente reembolsados não entram nessa contagem. O painel separa a atribuição por cupom e por telefone; conversas e vendas continuam sendo métricas diferentes.

Total atribuído após reembolsos desconta os valores devolvidos do total dos pedidos atribuídos e inclui frete e impostos. Não é lucro. O filtro usa a data de pagamento: um reembolso posterior pode alterar os valores de um período anterior. Compare o mesmo período e a mesma moeda nos dois sistemas.

Dados parciais ou dias sem registro de vendas significam que não há base para afirmar zero vendas no período inteiro. Detalhes de produtos também dependem dos dados enviados pela integração; se faltarem itens ou detalhes dos reembolsos, produtos e preços médios podem aparecer como indisponíveis. Não interprete indisponível como valor zero.

O que conferir quando a venda não aparece

Se a tela disser Integração pausada, novos eventos não estão sendo recebidos. O histórico continua disponível. Se disser Integração ativa. Aguardando o primeiro pedido da loja, confira a entrega de um evento de pedido; o ping de ativação não altera esse estado. Verifique também se os dois webhooks continuam ativos no WooCommerce, que pode desativar entregas após falhas repetidas.

Assinatura inválida indica que o evento não passou pela autenticação. Compare o segredo dos dois webhooks com o último segredo gerado e confira se a integração está ativa. Loja não autorizada indica divergência entre a origem enviada pelo WooCommerce e a URL da loja cadastrada. Dados do pedido inválidos ou inconsistentes exige revisar o evento enviado e eventuais personalizações da loja.

Se o evento chegou, confira o status e o pagamento do pedido, o período selecionado e o cupom. Sem cupom vinculado, confira o telefone e a última conversa confirmada atribuída até o pagamento, sem limite de tempo. Pedidos que precisam de conferência para definir a indicação não entram nos totais enquanto houver essa pendência. Gerar um novo segredo não resolve ausência de pagamento, diferença de período ou falta de uma correspondência de atribuição.

Como trocar o segredo ou pausar a integração

Gerar novo segredo invalida o anterior. Faça a troca somente quando precisar e atualize os dois webhooks da loja para continuar recebendo eventos. Depois, confira a próxima entrega e o horário de Último evento recebido.

Desativar integração interrompe novos eventos para todos os links da conta, não apenas para o link aberto. Compartilhe relatórios pelo recurso de acesso aos resultados e mantenha o PIN privado; a URL do webhook, o segredo e o acesso de proprietário não são necessários para um parceiro acompanhar a campanha.