Bienvenida al comprador de infoproducto en WhatsApp: un mensaje por checkout

En una suscripción, cada renovación aprobada es una nueva compra. Kiwify envía compra_aprovada y subscription_renewed juntos; para la bienvenida usa solo la primera compra (el subscription_id es el mismo en todos los cobros, así que guarda a quién ya se le dio la bienvenida). Los detalles por plataforma están en Hotmart, Kiwify y Eduzz.

En Fluxos, Recuperar vendas, elige la plataforma y el objetivo 'Bienvenida poscompra'. El asistente crea un flujo con un único mensaje, que usa {nome} y {produto}, y genera la URL del webhook. Pega la URL en la plataforma, marca el evento de compra aprobada e ingresa la clave de la plataforma en el asistente para validar el origen. En pocos minutos el comprador empieza a recibir el mensaje.

El texto de partida es corto y genérico; cámbialo por tu voz. Un buen patrón: agradecimiento, qué recibió el comprador, dónde está el acceso y cómo pedir ayuda. No pongas contraseñas ni enlaces de acceso personales de un solo uso en texto abierto por WhatsApp si tu plataforma ya los entrega por correo de forma segura; usa WhatsApp para avisar que el correo salió y para resolver dudas.

El order bump es la oferta extra marcada en el checkout. Para la plataforma, es otra compra, con otro evento. Si envías la bienvenida por evento, el comprador recibe una por producto. En Hotmart, el payload dice cuándo la compra es un bump (purchase.order_bump.is_order_bump) y trae el id de la compra principal (parent_purchase_transaction); cuando ese id viene vacío para un bump, la propia compra es la principal. En Eduzz, el campo data.orderBump.mainSaleId apunta a la factura principal.

La regla es: una bienvenida por checkout. Calcula la clave del checkout (la transacción principal), intenta 'reclamar' esa clave en una tabla con UNIQUE y solo envía si lo logras. El asistente sin código no hace esta agrupación por checkout: ignora el mismo teléfono en el mismo flujo durante 10 minutos, lo que cubre muchos casos de bump, pero no es garantía si los eventos llegan con más de 10 minutos de diferencia. Si eso te importa, usa el código de abajo.

// Hotmart 2.0.0: one welcome per checkout, even with order bumps
app.post("/hotmart", express.json(), async (req, res) => {
  if (req.get("X-HOTMART-HOTTOK") !== process.env.HOTMART_HOTTOK) return res.sendStatus(401);
  const { id, event, data } = req.body;
  res.sendStatus(200);
  if (event !== "PURCHASE_APPROVED") return;
  if (!(await saveEventOnce(id, req.body))) return; // duplicate delivery

  // An order bump is a separate purchase. The parent transaction id is the same for the whole checkout.
  const ob = data.purchase.order_bump;
  const parent = ob?.is_order_bump && ob.parent_purchase_transaction
    ? ob.parent_purchase_transaction
    : data.purchase.transaction;
  if (!(await claimWelcome(parent))) return;        // UNIQUE(parent): only the first purchase of the checkout welcomes

  const b = data.buyer;
  const phone = String((b.checkout_phone_code || "") + (b.checkout_phone || "")).replace(/\D/g, "");
  if (phone.length < 10) return;                     // no usable phone: log it, never guess
  await sendWhatsApp(phone.startsWith("55") ? phone : "55" + phone,
    "Oi, " + b.first_name + "! Sua compra de " + data.product.name + " foi confirmada. O acesso chega no e-mail " + b.email + ". Se não encontrar, olhe o spam ou responda aqui.");
});

// Shared helper: one send through the ZapZap API
async function sendWhatsApp(number, text) {
  const r = await fetch(`https://api.zapzapapi.com/api/v1/${process.env.ZAPZAP_INSTANCE}/send/text`, {
    method: "POST",
    headers: {
      "x-api-key": process.env.ZAPZAP_API_KEY,
      "x-api-secret": process.env.ZAPZAP_API_SECRET,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ number, text }),
  });
  if (!r.ok) throw new Error("ZapZap " + r.status + ": " + (await r.text()));
}

No todo comprador deja teléfono, y en un producto de afiliado el productor debe liberar el dato del comprador. Si el teléfono no llega, lo correcto es registrar y seguir: no intentes adivinar un número, no uses el teléfono de otro campo (como el del productor) y no escribas a un número que 'encontraste'. En Hotmart, el teléfono de un comprador brasileño puede llegar sin DDD, con el DDD en checkout_phone_code; el código de arriba junta los dos y descarta lo que quede con menos de 10 dígitos.

ZapZap solo dispara por el asistente cuando detecta un teléfono de 10 a 13 dígitos. Cuando el payload trae el número partido en dos campos, el asistente no los une; usa el endpoint del ejemplo.

La bienvenida es transaccional: ocurre por una compra, para quien compró. Eso la separa de la campaña para la base, que pide consentimiento específico y otro ritmo. Si aprovechas el mensaje para empujar otra oferta, deja de ser solo transaccional y el riesgo cambia. Si quieres ofrecer algo después, espera y pide permiso: '¿Quieres recibir consejos y novedades por aquí? Responde SÍ'.

Incluye una salida en cada mensaje y respétala. Mira la guía de LGPD en WhatsApp (LGPD es la ley de protección de datos de Brasil). ZapZap conecta números por un canal no oficial y gestionado; un mensaje de bienvenida por compra, sin repetición, es el uso de menor riesgo.