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

      • Integrar Kiwify

      Crie a integração na Clickmax, copie a URL gerada e cadastre-a como webhook na Kiwify. A cada pedido, a Kiwify envia os dados para a Clickmax, que cria o contato (marcado como cliente quando a venda é paga) e registra a venda externa.

      Antes de começar

      • Você precisa de acesso para criar integrações no workspace.
      • Tenha login na sua conta Kiwify com acesso a Apps > Webhook.

      Passo a passo

      1. Na Kiwify, no menu lateral, vá até Apps, selecione Webhook e clique em Criar webhook.
      2. Copie o token exibido pela Kiwify e cole no campo Token da Clickmax. Esse token é usado para validar a assinatura de cada requisição — se não conferir, a Clickmax recusa o envio.
      3. Na Clickmax, informe um apelido para a integração e defina o status.
      4. Clique em Criar integração. A Clickmax gera a URL do webhook.
      5. Na Kiwify, defina um nome, configure quais serão os produtos da integração e quais eventos serão enviados.
      6. No campo URL da Kiwify, cole a URL gerada pela Clickmax e clique em Testar Webhook.
      7. Clique em Concluir integração para finalizar.

      Cada pedido pago entra como venda externa e o contato recebe a tag kiwify. Para os campos que a Clickmax preenche a partir do webhook, veja a referência de webhooks e a referência de campos.

      Relacionados

      Se não funcionou

      • Nada chega e a Kiwify mostra erro de autenticação: o Token colado não confere com a assinatura da requisição — refaça o passo 2. Veja os códigos de erro.
      • O contato não aparece: a Clickmax só cria o contato quando o pedido traz e-mail do comprador. Confira os campos enviados na referência de webhooks.
      • A venda não é registrada: só pedidos com status pago viram venda externa. Confira os campos enviados na referência de webhooks.