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

  1. No Clakta, vá em Configurações do projeto → Plataformas de vendas.
  2. 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.
  3. Em outra aba, abra o painel da Kirvano e vá em Integrações → Webhooks → Criar Webhook.
  4. 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 KirvanoO que acontece no Clakta
      Compra aprovadaRegistra a venda.
      Assinatura renovadaRegistra cada renovação como uma nova venda.
      Compra recusadaRegistra a tentativa de compra recusada.
      ReembolsoMarca o pedido como reembolsado.
      ChargebackMarca 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.

  5. 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.

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 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