## 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

1. En el área de **Catálogo y Comercio**, crea una **fuente de comercio** para la plataforma deseada.
2. Copia la **URL de webhook** generada para esa fuente y define el **secreto de verificación** cuando
   la plataforma lo exija.
3. 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).
4. Realiza una venta de prueba (o un carrito de prueba) para confirmar que el evento llega.
5. 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.
6. 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.

## Ver también

- [Visión general de Catálogo y Comercio](/hc/ajuda/articles/catalog-commerce-overview-es)
- [Enviar producto y recibir pedidos en la conversación](/hc/ajuda/articles/catalog-commerce-enviar-produto-pedido-na-conversa-es)
- [Catálogo nativo: productos, categorías, imágenes y precios](/hc/ajuda/articles/catalog-commerce-catalogo-nativo-es)