Visión general
El ciclo de vida de e-commerce conecta plataformas externas — Kiwify, Hotmart, Nuvemshop y Shopify — para que los eventos de venta lleguen dentro de la atención. Cuando algo ocurre en la plataforma externa (carrito abandonado, PIX/boleto generado, compra aprobada, rechazada o reembolsada), ConversaLabs recibe el webhook, normaliza el evento y muestra una tarjeta en la conversación del cliente, con los datos de pago cuando están disponibles.
Con esto, recuperas ventas sin cambiar de herramienta: el equipo ve la etapa de la compra en la propia conversación y puede activar Follow-ups automáticos para reconquistar a quien no finalizó.
Requisitos previos
- El módulo de Catálogo y Comercio habilitado y permiso para configurar fuentes de comercio.
- Acceso a la plataforma externa (Kiwify, Hotmart, Nuvemshop o Shopify) para configurar el webhook.
- Para la recuperación automática: el módulo de Follow-ups configurado con secuencias por evento.
Paso a paso
- En el área de Catálogo y Comercio, crea una fuente de comercio para la plataforma deseada.
- Copia la URL de webhook generada para esa fuente y define el secreto de verificación cuando la plataforma lo exija.
- Pega la URL en el panel de la plataforma externa (o usa el registro automático cuando esté disponible, por ejemplo en Kiwify y Nuvemshop).
- Realiza una venta de prueba (o un carrito de prueba) para confirmar que el evento llega.
- Observa la tarjeta del evento aparecer en la conversación del cliente, con ítems, importes y el enlace/datos de pago según la etapa.
- Configura Follow-ups activados por evento (por ejemplo, "carrito abandonado") para recuperar la venta automáticamente.
Configuración y opciones
- Fuente de comercio: una por plataforma, con su propia URL de webhook y secreto de verificación.
- Registro automático del webhook: disponible en algunas plataformas (ej.: Kiwify y Nuvemshop); en las demás, la configuración es manual en el panel de la propia plataforma.
- Tarjeta del evento: muestra la etapa de la compra y, cuando la plataforma lo expone, datos de PIX/boleto y el enlace de checkout.
- Variables de comercio: los datos del último evento quedan disponibles para usar en mensajes de Follow-up (enlace de pago, importe, código PIX/boleto, etc.).
Casos de uso
- Carrito abandonado: dispara una secuencia de Follow-up recordando al cliente que concluya.
- PIX/boleto pendiente: reenvía el código de pago y hace seguimiento hasta confirmar.
- Compra aprobada: confirma con el cliente y libera el siguiente paso de la atención.
- Reembolso/rechazo: alerta al equipo para tratar el caso en la propia conversación.
Consejos, límites y buenas prácticas
- Lo que expone cada plataforma varía: algunas envían el código PIX y la línea del boleto en el evento (recuperación completa dentro de la conversación); otras solo proporcionan el enlace de checkout — en esos casos, la tarjeta muestra el enlace para que el cliente concluya.
- Los importes y formatos difieren por plataforma: ConversaLabs normaliza cada evento; no necesitas preocuparte por la conversión — la tarjeta ya muestra el importe correcto.
- Secreto de verificación: manténlo configurado para que solo se acepten eventos legítimos de la plataforma.
- Combínalo con Follow-ups para automatizar la recuperación en lugar de depender de la acción manual.
Solución de problemas
- El evento no aparece: verifica que la URL de webhook se pegó correctamente en la plataforma y que el secreto de verificación coincide.
- No veo PIX/boleto en la tarjeta: no todas las plataformas exponen esos datos; cuando no los hay, la tarjeta trae el enlace de checkout.
- Eventos duplicados: la plataforma maneja repeticiones del mismo evento; si algo se ve extraño, verifica si hay más de un webhook configurado para la misma fuente.