Cómo usar Zapier con VSL Max

Zapier funciona en los dos sentidos: recibe eventos de VSL Max y envía a VSL Max ventas de cualquier checkout.

Los dos sentidos

En la tarjeta Zapier, en Configuración › Integraciones, hay dos pestañas:

  • Enviar eventos: VSL Max avisa a tu Zap cuando hay una venta, un reembolso, un video queda listo y otros eventos. Sirve para alimentar una hoja de cálculo, un CRM, Slack y todo lo que Zapier alcanza.
  • Recibir ventas: un checkout que no está en nuestra lista de plataformas envía la venta a VSL Max mediante un Zap, y la venta entra atribuida al video.

Enviar eventos a Zapier

  1. En Zapier, crea un Zap con el disparador Webhooks by Zapier, opción Catch Hook. Zapier genera una URL.
  2. En VSL Max, abre la tarjeta Zapier, pestaña Enviar eventos, y pega la URL en URL del Catch Hook. Solo se aceptan URLs que empiezan con https://hooks.zapier.com/hooks/catch/.
  3. Ponle un nombre (opcional) y elige los eventos. Si no eliges, quedan los cuatro de venta: venta aprobada, reembolso, contracargo y venta cancelada.
  4. Haz clic en Conectar Zap.
  5. Usa Probar para enviar un evento de prueba ahora. En Zapier aparece como muestra para que mapees los campos en los siguientes pasos del Zap.

Al conectar, VSL Max muestra un secreto de firma una sola vez. En Zapier es opcional; úsalo si tu Zap reenvía el evento a un servidor que verifique la firma. Los eventos, el formato del cuerpo y la firma son los mismos del webhook genérico: mira Webhook genérico.

Eventos disponibles: venta aprobada, reembolso, contracargo, venta cancelada, video listo, saldo de plays bajo y cuenta suspendida. Puedes tener hasta 5 Zaps conectados.

Recibir ventas con Zapier

Úsalo cuando tu checkout no está en la lista de plataformas de Conversiones. También funciona con Make y n8n.

  1. En Conversiones, crea una conversión con la plataforma Zapier (o Make, o n8n). La pestaña Recibir ventas tiene un atajo para esto.
  2. Indica los dominios de tu checkout (de 1 a 10). Con ellos el player sabe qué enlaces de la página llevan al checkout y reciben la clave de seguimiento.
  3. Copia la URL de la conversión, que aparece después de guardar.
  4. En el Zap, usa el disparador de tu checkout (venta aprobada, por ejemplo) y la acción Webhooks by Zapier, POST, con la URL de la conversión.
  5. Mapea los campos de la lista de abajo. La clave viene del parámetro de seguimiento que tu checkout devuelve en la venta.
  6. Vincula la conversión al video, en la pantalla del video. Mira Conversión vinculada.

El cuerpo aceptado es compatible con el de VTurb: quien migra solo cambia la URL en el Zap.

Campos aceptados en la venta

  • Clave (conversion_key o key): necesaria para atribuir la venta al video. Sin ella, la venta entra sin atribución.
  • Valor: obligatorio. En centavos, como entero, en order_amount_cents o amount_cents. En decimal, con punto o coma, en amount o value.
  • Moneda (currency): tres letras. Si no viene, vale BRL.
  • Estado (status, category o event): approved, paid, sale o purchase pasan a venta aprobada; también se aceptan refunded, chargeback y canceled. Si no viene, la venta queda aprobada.
  • ID del pedido (order_id, transaction_id, sale_id o id): mapéalo siempre. Sin él, dos ventas con el mismo valor y la misma fecha pueden contarse como una sola.
  • Fecha (order_created_at, occurred_at o created_at): ISO 8601 o epoch. Si no viene, vale el momento de la recepción.

El nombre del producto y la IP del comprador se aceptan y se descartan: VSL Max no guarda datos personales del comprador.

Si algo no llega

  • El evento no llega al Zap: abre los detalles del Zap en la lista y mira Últimas entregas. Cada entrega muestra el estado HTTP y cuántos intentos hubo.
  • La venta llega sin video: casi siempre falta la clave. Revisa que el dominio del checkout esté registrado en la conversión y que el Zap envíe el campo de la clave. Mira Parámetro de seguimiento.