Conectar Kirvano
Envie vendas, renovações, reembolsos e chargebacks da Kirvano para o Clakta por webhook e veja de qual anúncio ou canal veio cada venda.
A Kirvano avisa o Clakta sempre que uma venda acontece, uma assinatura renova, um pedido é reembolsado ou sofre chargeback. Esse aviso se chama webhook. Você só precisa criar um no painel da Kirvano com dois dados que o Clakta gera para você: uma URL e um token.
Conectar
- No Clakta, vá em Configurações do projeto → Plataformas de vendas.
- Escolha Kirvano, dê um nome à conexão (por exemplo, o nome da sua loja) e clique em Criar conexão. O Clakta mostra a URL do webhook e o Token. Deixe essa janela aberta.
- Em outra aba, abra o painel da Kirvano e vá em Integrações → Webhooks → Criar Webhook.
- Preencha o formulário da Kirvano:
-
Nome: o que quiser, por exemplo "Clakta".
-
URL do Webhook: cole a URL que o Clakta mostrou.
-
Token: cole o token que o Clakta mostrou.
-
Produto: selecione todos os produtos que você vende.
-
Evento: marque estes cinco eventos:
Evento na Kirvano O que acontece no Clakta Compra aprovada Registra a venda. Assinatura renovada Registra cada renovação como uma nova venda. Compra recusada Registra a tentativa de compra recusada. Reembolso Marca o pedido como reembolsado. Chargeback Marca o pedido como reembolsado. Se você vende assinaturas, não deixe Assinatura renovada de fora. Sem ele, o Clakta só vê o primeiro pagamento de cada assinante.
Marcar outros eventos não causa problema: o Clakta recebe e ignora o que não usa. Isso inclui PIX gerado e Boleto gerado. Um Pix ou boleto gerado ainda não é uma venda. Ela entra no Clakta quando o pagamento é aprovado e a Kirvano envia Compra aprovada.
-
- Salve o webhook na Kirvano. Depois volte ao Clakta e clique em Concluir.
Pronto. A partir daí, cada venda nova aparece no Clakta poucos segundos depois de acontecer na Kirvano.
O Clakta guarda o token criptografado e não consegue mostrá-lo de novo. Copie antes de fechar a janela. Se perder, abra a conexão no Clakta, clique em Gerar novo token e cole o novo valor no webhook da Kirvano. O token antigo para de funcionar assim que você gera outro.
Ative o script do Clakta
Para saber de qual anúncio ou canal veio cada venda, instale o script do Clakta nas páginas que levam ao checkout da Kirvano. Quando o visitante clica no link do checkout, o script anexa a visita a esse link sozinho. Você não precisa mudar nada nos seus links.
Projetos no modo privacidade não enviam essa informação, então as vendas chegam mesmo assim, mas sem a origem.
Se o seu site monta o link do checkout por conta própria
Se o visitante chega ao checkout por um redirecionamento feito no seu servidor, o script não vê o clique. Nesse caso, peça para quem cuida do seu site acrescentar a sessão ao link:
clakta.decorateKirvanoUrl(url) faz a mesma coisa.
Solução de problemas
Na Kirvano, abra o webhook e clique em Ver logs para ver cada envio e a resposta do Clakta. Os casos mais comuns:
Artigos relacionados
Conectar Shopify
Instale o app do Clakta na sua loja Shopify. Ele configura o rastreamento de checkout, importa seus pedidos recentes e liga cada venda ao anúncio que a gerou.
Conectar Lemon Squeezy
Envie pedidos, renovações e reembolsos do Lemon Squeezy para o Clakta por webhook e credite cada venda ao visitante que a gerou.
Conectar Dodo Payments
Aponte o Dodo Payments para o Clakta com um webhook para receber pagamentos, reembolsos e chargebacks automaticamente, e ligar cada venda ao visitante que a fez.