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), Conversa Labs 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 completa generada para esa fuente. Incluye la cuenta y la fuente; no elimines ningún segmento. Configura también el secreto de verificación. En Kiwify, el registro automático puede generar y guardar el token; en Hotmart, indica el Hottok de la aplicación.
- 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.).
Elegir qué eventos recibir
Al editar la fuente en Catálogo → Fuentes de sincronización → editar la fuente, la sección Eventos lista los eventos que envía esa plataforma y te permite mapear cada uno a una etapa del ciclo de vida — o marcarlo como Apagado (ignorar) para descartarlo por completo.
Todo evento habilitado recorre el resto de la plataforma: automatizaciones, flows, webhooks, Follow-up y el CRM. El mapeo es lo que decide en qué etapa entra.
Un botón destacado de Recuperación de carrito abandonado enciende y apaga el evento de carrito de la
plataforma — es el que alimenta la cadencia de recuperación en Follow-up (disparador
commerce.cart_abandoned).
Disponible para:
| Fuente | Eventos que mapeas |
|---|---|
| Hotmart | eventos de compra, carrito, suscripción y área de miembros |
| Kiwify | sus 10 disparadores reales: compra_aprovada, pix_gerado, boleto_gerado, compra_recusada, compra_reembolsada, chargeback, carrinho_abandonado, subscription_renewed, subscription_late, subscription_canceled |
| Nuvemshop | los valores de payment_status del pedido: paid, authorized, pending, refunded, partially_refunded, abandoned — el webhook de Nuvemshop trae solo el ID, así que la etapa viene del estado de pago del pedido |
| Fuentes genéricas | los nombres de evento documentados por tu sistema. Tú defines explícitamente el campo del evento, el ID, las rutas de comprador/producto/ítems y la etapa canónica; no se infiere nada por el nombre de una plataforma |
Las fuentes administradas sin un contrato verificado de ciclo de venta, como Mercado Libre y OLX, no muestran un selector de eventos. Las fuentes atendidas por el conector genérico — incluida una configuración propia de Shopify/API — muestran la configuración del webhook genérico firmado y reciben solo los eventos que mapees explícitamente.
Los valores por defecto ya son sensatos: solo cambia el mapeo si quieres una etapa distinta o si quieres ignorar un evento.
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: Conversa Labs normaliza cada evento; no necesitas preocuparte por la conversión — la tarjeta ya muestra el importe correcto.
- Secreto de verificación: mantenlo configurado para que solo se acepten eventos legítimos de la plataforma. Los webhooks de Hotmart, Kiwify, Nuvemshop y los genéricos se rechazan si no hay un secreto configurado. Un emisor genérico también debe enviar la firma con marca de tiempo y un ID de entrega estable por evento.
- 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 completa de webhook se pegó correctamente en la plataforma y que el secreto de verificación está configurado y 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: las entregas genéricas con el mismo ID se procesan una sola vez. Si algo se ve extraño, confirma que el emisor reutiliza ese ID en los reintentos y que solo hay un webhook configurado para la misma fuente.