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/guru.md.
  • Português

      • Integrar Guru

      Crie uma integração de entrada na Clickmax, cole o Account Token da sua conta Guru, registre a URL gerada nos webhooks de Vendas e de Assinaturas do Guru — e cada evento com e-mail passa a criar ou atualizar um contato (com a tag guru), enquanto as vendas aprovadas viram vendas na Clickmax.

      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.
      • Plano:
      • Da sua conta Guru você precisa do Account Token (aba Detalhe da conta), que valida os webhooks e é obrigatório. O Api Token (aba Tokens API do perfil) é opcional — serve para a Clickmax buscar os nomes dos produtos.

      Passo a passo

      1. Na Clickmax, abra Integrações e selecione o card Digital Manager Guru.
      2. Em outra aba, acesse a Digital Manager Guru e faça login.
      3. No Guru, no canto superior direito, vá em Minha Conta > aba Detalhe, copie o Account Token e cole no campo Token da Clickmax.
      4. (Opcional) No Guru, em Meu Perfil > aba Tokens API, copie o Api Token e cole no campo Token da API da Clickmax.
      5. Informe um Apelido para a integração e clique em Criar integração.
      6. A Clickmax gera uma URL de webhook. Copie essa URL.
      7. No Guru, configure os webhooks de Vendas e de Assinaturas e cole a URL em cada um.
      8. No Guru, marque os status que deseja receber (vendas e assinaturas).
      9. Volte à Clickmax e clique em Concluir integração.

      O que passa a chegar

      Cada evento com e-mail cria ou atualiza um contato com a tag guru. Vendas aprovadas marcam o contato como cliente e registram a venda; cancelamento, reembolso, chargeback e recusa também viram venda registrada. Assinaturas (ativa, atrasada, cancelada, expirada e trial) chegam como atividade e gatilho. Eventos sem e-mail do comprador são ignorados.

      Para a lista completa de status reconhecidos e o que cada um dispara, veja a referência de webhooks de entrada e a referência de eventos.

      Relacionados

      Se não funcionou

      • Venda ou assinatura não aparece: confira se o Account Token colado no campo Token é exatamente o da conta que envia o webhook — token divergente faz a Clickmax rejeitar a entrega. Veja os códigos de erro.
      • Um evento específico não chega: eventos sem o e-mail do comprador são descartados (a Clickmax não consegue resolver o contato). Confira se o Guru envia o e-mail no payload. Veja os códigos de erro.
      • Nenhum evento chega: verifique se os status foram marcados nos webhooks de Vendas e Assinaturas do Guru e se a integração está ativa. Veja as perguntas frequentes.