Conectar Kirvano

Envía a Clakta las ventas, renovaciones, reembolsos y contracargos de Kirvano mediante un webhook, y descubre qué anuncio o canal trajo cada venta.

Kirvano avisa a Clakta cada vez que se aprueba una venta, se renueva una suscripción o un pedido se reembolsa o recibe un contracargo. Ese aviso se llama webhook. Solo tienes que crear uno en el panel de Kirvano con dos datos que Clakta genera para ti: una URL y un token.

Conectar

  1. En Clakta, ve a Configuración del proyecto → Plataformas de venta.
  2. Elige Kirvano, ponle un nombre a la conexión (por ejemplo, el de tu tienda) y haz clic en Crear conexión. Clakta muestra la URL del webhook y el Token. Deja esa ventana abierta.
  3. En otra pestaña, abre el panel de Kirvano y ve a Integrações → Webhooks → Criar Webhook.
  4. Rellena el formulario de Kirvano:
    • Nome: el que quieras, por ejemplo "Clakta".

    • URL do Webhook: pega la URL que mostró Clakta.

    • Token: pega el token que mostró Clakta.

    • Produto: selecciona todos los productos que vendes.

    • Evento: marca estos cinco eventos:

      Evento en KirvanoQué pasa en Clakta
      Compra aprovadaRegistra la venta.
      Assinatura renovadaRegistra cada renovación como una venta nueva.
      Compra recusadaRegistra el intento de compra rechazado.
      ReembolsoMarca el pedido como reembolsado.
      ChargebackMarca el pedido como reembolsado.

      Si vendes suscripciones, no dejes fuera Assinatura renovada. Sin él, Clakta solo ve el primer pago de cada suscriptor.

      Marcar otros eventos no causa problemas: Clakta los recibe e ignora lo que no usa. Eso incluye PIX gerado y Boleto gerado. Un Pix o un boleto generado todavía no es una venta. La venta llega a Clakta cuando se aprueba el pago y Kirvano envía Compra aprovada.

  5. Guarda el webhook en Kirvano. Después vuelve a Clakta y haz clic en Finalizar.

Listo. A partir de ahí, cada venta nueva aparece en Clakta pocos segundos después de producirse en Kirvano.

Activa el script de Clakta

Para saber de qué anuncio o canal vino cada venta, instala el script de Clakta en las páginas que llevan al checkout de Kirvano. Cuando el visitante hace clic en el enlace del checkout, el script añade su visita a ese enlace por sí solo. No tienes que cambiar tus enlaces.

Los proyectos en modo privacidad no envían esta información, así que las ventas llegan igual, pero sin su origen.

Si tu sitio arma el enlace del checkout por su cuenta

Si el visitante llega al checkout mediante una redirección desde tu servidor, el script no ve el clic. En ese caso, pide a quien gestiona tu sitio que añada la sesión al enlace:

clakta.decorateKirvanoUrl(url) hace lo mismo.

Solución de problemas

En Kirvano, abre el webhook y haz clic en Ver logs para ver cada envío y la respuesta de Clakta. Los casos más comunes:

Artículos relacionados

Conectar Kirvano | Clakta