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
- En Clakta, ve a Configuración del proyecto → Plataformas de venta.
- 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.
- En otra pestaña, abre el panel de Kirvano y ve a Integrações → Webhooks → Criar Webhook.
- 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 Kirvano Qué pasa en Clakta Compra aprovada Registra la venta. Assinatura renovada Registra cada renovación como una venta nueva. Compra recusada Registra el intento de compra rechazado. Reembolso Marca el pedido como reembolsado. Chargeback Marca 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.
-
- 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.
Clakta guarda el token cifrado y no puede volver a mostrarlo. Cópialo antes de cerrar la ventana. Si lo pierdes, abre la conexión en Clakta, haz clic en Generar un token nuevo y pega el nuevo valor en el webhook de Kirvano. El token anterior deja de funcionar en cuanto generas otro.
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 Shopify
Instala la app de Clakta en tu tienda de Shopify. Configura el seguimiento del checkout, importa tus pedidos recientes y asocia cada venta al anuncio que la produjo.
Conectar Lemon Squeezy
Envía a Clakta tus pedidos, renovaciones y reembolsos de Lemon Squeezy mediante un webhook, y acredita cada venta al visitante que la hizo.
Conectar Dodo Payments
Apunta Dodo Payments a Clakta con un webhook para que tus pagos, reembolsos y contracargos lleguen automáticamente, y cada venta se asocie al visitante que la hizo.