> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Recupera carritos abandonados

> Envía un correo de recordatorio cuando un comprador deja un carrito y no hace ningún pedido en el día siguiente.

Al terminar tendrás una automatización que espera tras cada evento de carrito, comprueba si hay un pedido y envía al comprador un correo con los artículos que dejó.

## Antes de empezar

- Una clave API con permiso de **escritura en Contactos**, creada en **Configuración** → **Equipo y claves API**. Los eventos personalizados dependen del permiso de Contactos.
- El ID de tu espacio de trabajo y la dirección de tu instancia de Notifuse (`YOUR_HOST` en los ejemplos).
- Una lista para la automatización, como la lista de tu newsletter. Una automatización no puede tener un nodo de correo sin ella.
- Un proveedor de correo asignado a **Correos de marketing**.

## Configura la recuperación de carritos

### 1. Envía un evento de carrito desde tu tienda

Cuando un comprador crea un carrito, envía un evento personalizado a `POST /api/customEvents.import`. El cuerpo contiene tu `workspace_id` y un array `events` de 1 a 50 eventos.

Cada evento necesita:

- `external_id`: el ID del carrito en tu tienda. Un `external_id` nuevo inicia la automatización. Si vuelves a enviar el mismo, se actualiza el evento guardado y no se inicia nada.
- `email`: la dirección del comprador.
- `event_name`: letras minúsculas, números, `_`, `.`, `/` y `-`, 100 caracteres como máximo. Esta guía usa `cart.created`.
- `properties`: todo lo que mostrará el correo, como los artículos y un enlace para volver al carrito.

`occurred_at` es opcional y por defecto es el momento actual. No le pongas un `goal_type` al evento de carrito.

**cURL**

```bash
curl -X POST https://YOUR_HOST/api/customEvents.import \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "YOUR_WORKSPACE_ID",
    "events": [
      {
        "external_id": "cart_8f3a2c",
        "email": "jane@example.com",
        "event_name": "cart.created",
        "properties": {
          "cart_url": "https://shop.example.com/cart/8f3a2c",
          "total": 89.9,
          "items": [
            { "name": "Linen shirt", "quantity": 1, "price": 59.9 },
            { "name": "Canvas tote", "quantity": 1, "price": 30.0 }
          ]
        }
      }
    ]
  }'
```

**Node.js**

```javascript
const response = await fetch('https://YOUR_HOST/api/customEvents.import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NOTIFUSE_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    workspace_id: 'YOUR_WORKSPACE_ID',
    events: [
      {
        external_id: `cart_${cart.id}`,
        email: cart.email,
        event_name: 'cart.created',
        properties: {
          cart_url: cart.url,
          total: cart.total,
          items: cart.items.map((item) => ({
            name: item.name,
            quantity: item.quantity,
            price: item.price
          }))
        }
      }
    ]
  })
})

if (!response.ok) {
  throw new Error(`Notifuse returned ${response.status}: ${await response.text()}`)
}
```

**Python**

```python
import os
import requests

response = requests.post(
    "https://YOUR_HOST/api/customEvents.import",
    headers={"Authorization": f"Bearer {os.environ['NOTIFUSE_API_KEY']}"},
    json={
        "workspace_id": "YOUR_WORKSPACE_ID",
        "events": [
            {
                "external_id": f"cart_{cart['id']}",
                "email": cart["email"],
                "event_name": "cart.created",
                "properties": {
                    "cart_url": cart["url"],
                    "total": cart["total"],
                    "items": [
                        {"name": i["name"], "quantity": i["quantity"], "price": i["price"]}
                        for i in cart["items"]
                    ],
                },
            }
        ],
    },
)
response.raise_for_status()
```

Notifuse no crea un contacto a partir de un evento, y un recorrido no puede ejecutar sus pasos sin contacto. Si es posible que el comprador todavía no sea un contacto, créalo antes con `POST /api/contacts.upsert`.

El correo muestra el carrito tal como estaba cuando llegó este primer evento. Las actualizaciones que envíes después con el mismo `external_id` cambian el evento guardado, pero no el recorrido que ya empezó.

### 2. Envía los pedidos como objetivos de compra

La automatización comprueba si hay un pedido con una condición de **Objetivo**, y una condición de objetivo solo cuenta los eventos que llevan un `goal_type`. Envía cada pedido con `goal_type: "purchase"` y su importe en `goal_value`, que es obligatorio para las compras.

**cURL**

```bash
curl -X POST https://YOUR_HOST/api/customEvents.import \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "YOUR_WORKSPACE_ID",
    "events": [
      {
        "external_id": "order_1042",
        "email": "jane@example.com",
        "event_name": "order.completed",
        "goal_type": "purchase",
        "goal_value": 89.9,
        "properties": { "cart_id": "8f3a2c" }
      }
    ]
  }'
```

**Node.js**

```javascript
await fetch('https://YOUR_HOST/api/customEvents.import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NOTIFUSE_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    workspace_id: 'YOUR_WORKSPACE_ID',
    events: [
      {
        external_id: `order_${order.id}`,
        email: order.email,
        event_name: 'order.completed',
        goal_type: 'purchase',
        goal_value: order.total,
        properties: { cart_id: order.cartId }
      }
    ]
  })
})
```

**Python**

```python
requests.post(
    "https://YOUR_HOST/api/customEvents.import",
    headers={"Authorization": f"Bearer {os.environ['NOTIFUSE_API_KEY']}"},
    json={
        "workspace_id": "YOUR_WORKSPACE_ID",
        "events": [
            {
                "external_id": f"order_{order['id']}",
                "email": order["email"],
                "event_name": "order.completed",
                "goal_type": "purchase",
                "goal_value": order["total"],
                "properties": {"cart_id": order["cart_id"]},
            }
        ],
    },
).raise_for_status()
```

Notifuse no vincula un pedido con un carrito. La propiedad `cart_id` solo sirve para tus propios registros.

### 3. Redacta el correo de recordatorio

Crea una plantilla en la categoría **Marketing**. El evento que inició el recorrido está disponible como `trigger_event`, con las propiedades del carrito en `trigger_event.properties`:

```liquid
<p>Hi {{ contact.first_name | default: "there" }}, you left these in your cart:</p>
{% for item in trigger_event.properties.items %}
  <p>{{ item.quantity }} × {{ item.name }}: {{ item.price }}</p>
{% endfor %}
<p><a href="{{ trigger_event.properties.cart_url }}">Back to your cart</a></p>
```

### 4. Crea la automatización

Ve a **Automatizaciones** y haz clic en **Nueva automatización**. En **Configuración**, a la izquierda, elige la **Lista** y define la **Frecuencia**:

- **Cada vez**: cada carrito nuevo inicia su propio recorrido.
- **Una vez por contacto**: solo recibe un recordatorio el primer carrito que crea un contacto, y ninguno de los siguientes.

En el disparador, pon **Evento disparador** en **Evento personalizado** y **Nombre del evento** en `cart.created`.

### 5. Añade un Retraso

Añade un paso de **Retraso** después del disparador. Pon **Duración de espera** en 1 y la unidad en **Días**.

El paso siguiente explica por qué una espera de 1 día es la que mejor encaja con la comprobación del pedido.

### 6. Añade un Filtro que busque un pedido

Añade un paso de **Filtro** después del Retraso y haz clic en **Añadir condiciones de filtro**. Añade una **Condición** de tipo **Objetivo** y rellénala:

- **El contacto**: **no ha alcanzado**, **Compra**.
- **Medida**: **número**, **mayor o igual que**, 1.
- **Cuándo**: **en los últimos** 1 **días**.

Haz clic en **Confirmar**. Los contactos que cumplen la condición siguen la rama **Sí**. Deja **No** vacía: un comprador que hizo un pedido termina ahí el recorrido.

![El paso de filtro de una automatización de carritos, con su condición y cuántos contactos siguieron cada rama](https://www.notifuse.com/docs/assets/screenshots/automation_filter_goal.png)

> [!NOTE]
>
> El Filtro no puede comprobar "ningún pedido desde este carrito". La ventana del objetivo cuenta días enteros hacia atrás desde el momento en que se ejecuta el Filtro, y no puede empezar en el evento de carrito.
>
> Con un Retraso de 1 día y una ventana de 1 día, las dos coinciden: el Filtro mira hacia atrás hasta más o menos la hora en que llegó el evento de carrito. Un Retraso más corto con la misma ventana mira más atrás que el carrito. Con un Retraso de 4 horas, un comprador que hizo un pedido en las 20 horas anteriores a crear el carrito cuenta como comprador y no recibe recordatorio.
>
> La ventana también cuenta todas las compras, así que un pedido de algo totalmente distinto también detiene el recordatorio.

En el Filtro también puedes limitar el correo a los suscriptores. Los contactos que nunca estuvieron en la lista de la automatización reciben igualmente un correo de marketing; solo se omiten los que se dieron de baja, rebotaron o presentaron una queja en ella. Para enviar el correo solo a los miembros de la lista, añade una condición de **Suscripción a lista** junto a la de Objetivo.

### 7. Añade el paso de correo y activa

Añade un paso de **Correo electrónico** en la rama **Sí** y elige tu recordatorio en **Plantilla de correo**.

Haz clic en **Activar** y luego en **Sí, activar**. Solo los carritos que lleguen a partir de ese momento inician un recorrido.

![Una automatización de recuperación de carritos: disparador por evento personalizado, retraso y después un filtro sobre las compras recientes](https://www.notifuse.com/docs/assets/screenshots/automation_abandoned_cart.png)

## Comprueba que funciona

1. Mientras pruebas, pon el Retraso en unos pocos **Minutos**.
2. Envía un evento `cart.created` para tu propia dirección, con un `external_id` que no hayas usado todavía.
3. Abre tu contacto en **Contactos**, ve a la pestaña **Actividad** y elige el filtro **Eventos**. Deberías ver el evento de carrito y "Entró en la automatización".
4. Cuando termina el retraso, llega el recordatorio y la actividad muestra "Completó la automatización".
5. Envía un segundo carrito y luego un evento de compra antes de que termine el retraso. Ese recorrido termina en el Filtro y no sale ningún correo.

Vuelve a poner el Retraso en 1 día antes de que lleguen carritos reales.

## Siguientes pasos

> [card] [Eventos personalizados y objetivos](https://www.notifuse.com/es/docs/features/custom-events.md)
>
> Tipos de objetivo, reembolsos como valores negativos y los campos del evento.

> [card] [Recupera a los clientes inactivos](https://www.notifuse.com/es/docs/guides/win-back-customers.md)
>
> Usa los mismos objetivos de compra para encontrar a los clientes que dejaron de comprar.

> [card] [Variables de automatización](https://www.notifuse.com/es/docs/features/templates.md#automation-variables)
>
> Todo lo que contiene `trigger_event` en un correo de automatización.
