> For the complete documentation index, see [llms.txt](https://nextcommerce.gitbook.io/nextcommerce-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextcommerce.gitbook.io/nextcommerce-docs/10-recupero-carritos.md).

# Recupero automático de carritos

El recupero automático detecta los carritos que quedaron abandonados y envía mensajes de seguimiento por **WhatsApp** y/o **Email** para invitar al cliente a completar su compra, en hasta **3 etapas por canal**.

## Acceder

En el menú lateral, ve a **Ventas > Recupero de carritos**.

> **Nota**: si tu tienda todavía no tiene la función habilitada, verás una pantalla informativa en lugar de la configuración. Contactá al equipo de soporte para activarla.

La pantalla se organiza en tres pestañas: **General**, **WhatsApp** y **Email**.

***

## Pestaña General

Acá se define **cuándo un carrito se considera abandonado**.

| Campo                     | Descripción                                                                                                                                        |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Recupero general**      | Switch que activa o pausa la detección de carritos abandonados. Si está apagado, los canales quedan configurados pero no se encolan nuevos envíos. |
| **Tiempo de inactividad** | Cantidad de **horas** sin actividad tras las cuales un carrito pasa a estado abandonado. Recién entonces los canales comienzan a procesarlo.       |

### Actividad reciente

Debajo de la configuración verás un registro de los últimos envíos y eventos por canal (WhatsApp / Email), incluyendo errores si los hubo. Es el primer lugar donde mirar si sospechás que los mensajes no están saliendo.

***

## Pestaña WhatsApp

### Conexión de la sesión

Para enviar mensajes por WhatsApp, primero hay que vincular una línea:

1. Ingresá el **número de WhatsApp** con prefijo internacional, sin `+` (ej.: `5491123456789`).
2. Iniciá la conexión y **escaneá el código QR** desde la app de WhatsApp (igual que al vincular WhatsApp Web).
3. Cuando el estado figure como **conectado**, la línea queda lista.

Consideraciones:

* El QR expira a los pocos segundos y se **renueva automáticamente**; si falla, reintentá la conexión.
* Con la sesión conectada, el número queda **bloqueado** (no editable). Para cambiarlo, primero desconectá la sesión.

### Configuración del envío

| Campo                     | Descripción                                           |
| ------------------------- | ----------------------------------------------------- |
| **Recupero por WhatsApp** | Switch que activa el envío automático por este canal. |

### Etapas de mensajes

Podés configurar hasta **3 etapas** (Primera, Segunda y Tercera). Para cada una:

| Campo                     | Descripción                                                                              |
| ------------------------- | ---------------------------------------------------------------------------------------- |
| **Activar etapa**         | Switch individual por etapa.                                                             |
| **Demora**                | Horas desde que el carrito entra en abandono hasta que se envía el mensaje de esa etapa. |
| **Plantilla del mensaje** | Texto del mensaje. Admite variables (ver abajo).                                         |
| **URL de imagen/media**   | Opcional: imagen o media que acompaña el mensaje.                                        |

**Variables disponibles en las plantillas:**

| Variable            | Se reemplaza por            |
| ------------------- | --------------------------- |
| `{{nombre}}`        | Nombre del cliente          |
| `{{tienda}}`        | Nombre de tu tienda         |
| `{{productos}}`     | Productos del carrito       |
| `{{total}}`         | Total del carrito           |
| `{{link_checkout}}` | Link para retomar la compra |

> **Ejemplo**: `Hola {{nombre}}, vi que dejaste productos en tu carrito de {{tienda}}. Completá tu compra acá: {{link_checkout}}`

***

## Pestaña Email

| Campo                  | Descripción                                           |
| ---------------------- | ----------------------------------------------------- |
| **Recupero por Email** | Switch que activa el envío automático por este canal. |

También trabaja con **3 etapas**, cada una con su **demora en horas**:

* **Primera etapa**: usa la plantilla del sistema `abandoned-cart`, que se edita en **Configuración > Emails** (Notificaciones). Desde esta pantalla solo se configura la demora.
* **Segunda y Tercera etapa**: cada una requiere su propio **Asunto** y **Contenido HTML** si está activa (la pantalla valida que no falten).

***

## Solución de problemas

### No se envían mensajes

Verificá en este orden:

1. ¿El switch **Recupero general** está activo (pestaña General)?
2. ¿El **tiempo de inactividad** es razonable? (si es muy alto, los carritos tardan en entrar en abandono)
3. ¿El canal (WhatsApp / Email) está activado y con etapas activas?
4. En WhatsApp: ¿la sesión figura como **conectada**?
5. Revisá **Actividad reciente** en la pestaña General: ahí aparecen los errores de envío.

### Quiero cambiar el texto del primer email

El contenido de la primera etapa de email se edita en la plantilla `abandoned-cart` dentro de **Configuración > Emails**, no en la pantalla de recupero.

### Veo una pantalla de publicidad en lugar de la configuración

La función no está habilitada para tu tienda. Contactá al equipo de soporte.

***

## Relación con otras pantallas

* **Ventas > Carritos en curso**: listado manual de los carritos activos/abandonados.
* **Estadísticas > Carritos Recuperados**: métricas de los resultados del recupero.
* **Configuración > Emails**: plantilla `abandoned-cart` usada en la primera etapa de email.