Integrar Kirvano
Crie a integração na Clickmax, copie a URL da integração e o Token gerados e cadastre um webhook na Kirvano com os dois valores. A partir daí cada compra, PIX, boleto, reembolso, carrinho abandonado ou mudança de assinatura da Kirvano vira um contato e uma atividade na Clickmax.
Papel exigido: apenas Proprietário e Administrador gerenciam integrações — veja Papéis e permissões. Plano necessário:
Antes de começar: tenha acesso à conta da Kirvano, em Integrações > Webhooks.
Passo a passo
O Token desta integração é gerado pela Clickmax — diferente de outras plataformas, não há token para buscar na Kirvano antes de começar.
- Na Clickmax, em Integrações, escolha Kirvano.
- Preencha o campo Nome com um apelido e clique em Criar integração.
- Copie a URL da integração e o Token exibidos pela Clickmax.
- Na Kirvano, acesse Integrações > Webhooks e clique em Criar Webhook.
- Cole a URL no campo URL do Webhook e o Token no campo Token.
- Escolha os produtos e os eventos que devem disparar o webhook.
- Salve o webhook na Kirvano e clique em Concluir integração na Clickmax.
O Token é o que garante que só a sua conta da Kirvano consegue enviar dados para essa URL. Sem ele preenchido no painel da Kirvano, os disparos são recusados.
Eventos recebidos
Cada evento cria ou atualiza um contato com a tag kirvano e registra uma atividade no histórico dele. Uma compra aprovada em produto único é registrada como compra; em produto recorrente, como início de assinatura.
Os eventos que registram venda transicionam a mesma venda conforme o status muda (aprovada → reembolsada, por exemplo), em vez de criar uma venda nova. Todos os produtos do pedido são considerados, inclusive os order bumps.
Todos esses eventos também estão disponíveis como gatilho de automação — veja a referência de gatilhos.
Relacionados
Se não funcionou
- O contato não aparece: eventos sem o e-mail do comprador são ignorados. Confira se o checkout da Kirvano captura e-mail; consulte os códigos de erro.
- A Kirvano acusa erro ao enviar: confirme que o campo Token no webhook da Kirvano tem exatamente o valor gerado pela Clickmax, sem espaços extras, e que a URL foi colada por inteiro.
- Chega contato mas nenhuma venda: confira quais eventos você marcou no webhook da Kirvano. PIX/boleto gerado, carrinho abandonado e mudanças de assinatura entram só como atividade, por definição.
- A automação não dispara: o gatilho precisa de uma integração ativa recebendo os webhooks. Confira também se o produto escolhido no gatilho é o mesmo do pedido — deixe vazio para disparar em qualquer produto.