For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/woocommerce.md.
  • Português

      • Integrar WooCommerce

      Digite o endereço da sua loja, clique em Conectar com WooCommerce e aprove o acesso no WordPress: a partir daí os pedidos da loja criam ou atualizam contatos (com a tag woocommerce), registram vendas e disparam automações. A Clickmax cadastra sozinha os webhooks na sua loja — não há URL para copiar.

      Funciona com qualquer forma de pagamento da loja (PagBank, Mercado Pago, Pagar.me, Pix, boleto, cartão…): a Clickmax acompanha o status do pedido no WooCommerce, que é o que o gateway atualiza quando o pagamento é confirmado, recusado ou devolvido.

      Antes de começar

      • Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
      • No WordPress da loja você precisa entrar como administrador.
      • A loja precisa abrir com https (cadeado no navegador).
      • Em Configurações → Links permanentes do WordPress, a opção não pode ser Simples.

      Passo a passo

      1. Na Clickmax, abra Integrações e selecione o card WooCommerce.
      2. Em Endereço da loja, digite o endereço que seus clientes acessam, por exemplo https://minhaloja.com.br.
      3. Clique em Conectar com WooCommerce.
      4. Você é levado ao WordPress da sua loja. Faça login, se ainda não estiver logado.
      5. Na tela de autorização, confira que o acesso pedido é de Leitura/Escrita e clique em Aprovar. A escrita é usada só para cadastrar os webhooks da Clickmax; os pedidos e produtos são apenas lidos.
      6. Você volta para Integrações com a mensagem WooCommerce conectado e a integração já aparece na lista.

      Para conferir, abra no WordPress WooCommerce → Configurações → Avançado → Webhooks: devem aparecer dois webhooks da Clickmax com status Ativo.

      Conectar manualmente, com as chaves da API

      Use este caminho se a tela de autorização não abrir (alguns plugins de segurança e hospedagens bloqueiam esse fluxo):

      1. No WordPress da loja, abra WooCommerce → Configurações → Avançado → REST API e clique em Adicionar chave.
      2. Em Descrição, escreva Clickmax. Em Usuário, escolha um administrador. Em Permissões, escolha Leitura/Escrita.
      3. Clique em Gerar chave de API e copie a Chave do consumidor (começa com ck_) e o Segredo do consumidor (começa com cs_). O segredo só aparece uma vez.
      4. Na Clickmax, no card WooCommerce, preencha o Endereço da loja e clique em Conectar manualmente. Cole a chave do consumidor no campo Consumer Key e o segredo no campo Consumer Secret.
      5. Clique em Conectar loja. A Clickmax valida as chaves e cadastra os webhooks na loja.

      O que passa a chegar

      Cada pedido com e-mail cria ou atualiza um contato com a tag woocommerce, registra uma atividade no histórico do contato, registra uma venda e pode disparar automações.

      Status do pedido no WooCommerceGatilho na automaçãoStatus da venda
      Pagamento pendente ou AguardandoWooCommerce — Pedido criadoAguardando
      Processando ou ConcluídoWooCommerce — Pedido pagoAprovada
      CanceladoWooCommerce — Pedido canceladoCancelada
      MalsucedidoWooCommerce — Pagamento recusadoFalha
      ReembolsadoWooCommerce — Pedido reembolsadoReembolsado

      Pontos que costumam gerar dúvida:

      • O mesmo pedido é uma venda só. Quando o status muda (por exemplo, o Pix gerado é pago), a mesma venda passa de Aguardando para Aprovada — não é criada outra.
      • Editar o pedido não dispara de novo. Adicionar uma nota, mudar o envio ou passar de Processando para Concluído não repete o gatilho: ele só dispara quando a venda muda de status.
      • Pedido que já nasce pago entra direto como Aprovada (comum no cartão), sem passar por Pedido criado.
      • Reembolso parcial não chega. O WooCommerce só muda o status do pedido para Reembolsado quando o valor inteiro é devolvido.
      • Reembolso não muda o valor da venda. A venda fica Reembolsada mantendo o total do pedido.
      • Venda com status Aguardando não conta como faturamento. Os indicadores de receita, o ticket médio e o LTV do contato somam apenas vendas aprovadas.
      • Uma venda por pedido, não por produto. Um pedido com três produtos gera uma venda com o total do pedido e três atividades no histórico do contato, uma por produto.
      • Pedido pago marca o contato como cliente.
      • Pedidos sem e-mail de cobrança são ignorados, porque sem e-mail não é possível identificar o contato.
      • Pode levar alguns minutos. O WooCommerce envia os avisos em segundo plano; em lojas com pouco movimento, eles podem demorar um pouco mais para chegar.
      • Não há gatilho de carrinho abandonado nem de chargeback: o WooCommerce não tem esses eventos.

      Filtro por produto

      Nos gatilhos você pode filtrar pelo produto: a Clickmax lista os produtos direto da sua loja. O gatilho dispara se o produto escolhido estiver em qualquer item do pedido. Produtos com variações (cor, tamanho) aparecem uma vez só, pelo produto principal.

      Desconectar

      Exclua a integração em Integrações. A Clickmax remove da loja os webhooks que ela criou e para de receber pedidos. Se a chave já tiver sido revogada, a exclusão funciona do mesmo jeito; os webhooks que sobrarem na loja são desativados pelo próprio WooCommerce depois de algumas entregas recusadas, ou você pode apagá-los em WooCommerce → Configurações → Avançado → Webhooks.

      Desativar a integração também não depende da loja: os pedidos param de ser registrados na hora.

      A chave de API continua cadastrada no WordPress. Para revogá-la, abra WooCommerce → Configurações → Avançado → REST API e exclua a chave da Clickmax.

      Reconectar a loja

      Use Reconectar loja, na página da integração, quando:

      • você revogou ou excluiu a chave da Clickmax no WordPress;
      • a loja parou de enviar pedidos porque o WooCommerce desativou os webhooks.

      A Clickmax abre a tela de autorização da mesma loja; depois de Aprovar, a mesma integração recebe chaves novas, volta a ficar ativa e os webhooks são religados. Contatos, vendas e histórico continuam iguais.

      Revogar a chave não interrompe os pedidos por si só: os webhooks continuam na loja e seguem enviando. O que deixa de funcionar é o que a Clickmax faz na loja — listar os produtos nos gatilhos e ativar a integração de novo.

      Contatos, vendas e atividades já recebidos continuam na sua conta. Para voltar a receber, conecte de novo: a integração anterior da loja é reaproveitada no mesmo workspace, sem duplicar.

      Relacionados

      Se não funcionou

      • Apareceu "Não encontramos sua loja WooCommerce": confira se ele abre com https:// e se é o endereço do site (não o do painel wp-admin). A loja precisa estar no ar com o WooCommerce ativo.
      • A tela de autorização não abriu, deu erro ou apareceu "Não foi possível conectar o WooCommerce": confira se os links permanentes do WordPress não estão em Simples. Se continuar, use Conectar manualmente.
      • Apareceu "Conexão cancelada": você clicou em Recusar no WordPress. Conecte de novo e clique em Aprovar.
      • Apareceu "Não foi possível validar as chaves": gere uma chave nova com permissão Leitura/Escrita e cole a chave e o segredo sem espaços.
      • Apareceu "A loja WooCommerce recusou as chaves da Clickmax": a chave foi revogada no WordPress ou não tem permissão Leitura/Escrita. Use Reconectar loja.
      • Nenhum pedido chega: confira se a integração está ativa em Integrações e se os webhooks da Clickmax estão Ativos no WordPress. O WooCommerce desativa um webhook depois de várias falhas de entrega; conectar de novo pela Clickmax reativa os dois.
      • Um pedido específico não chegou: pedidos sem e-mail de cobrança são descartados, e reembolsos parciais não mudam o status do pedido.