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

# Carrusel

> Envía un conjunto de tarjetas deslizables con imagen o video, texto y botones en WhatsApp

El nodo **Carrusel** envía un conjunto de tarjetas que el usuario puede deslizar horizontalmente. Cada tarjeta combina una imagen o video, texto y hasta dos botones. Es ideal para mostrar catálogos de productos, opciones de servicio o cualquier lista visual donde el orden importa.

<Note>
  El Carrusel está disponible únicamente en canales de **WhatsApp Cloud**. Otros proveedores de WhatsApp y otros canales no lo soportan.
</Note>

## Configuración general

* **Título del carrusel**: Texto principal que acompaña al carrusel (requerido, máximo 1,024 caracteres). Puedes escribir texto libre, agregar variables como `{{$user.names}}` o `{{$memory.categoria}}`, o combinar ambos.
* **Tipo de encabezado para tarjetas**: **Imagen** o **Video**. Aplica a todas las tarjetas del carrusel; no puede mezclarse.

<Warning>
  Cambiar el **Tipo de encabezado para tarjetas** (Imagen ↔ Video) borra los archivos multimedia ya cargados en todas las tarjetas. Confirma el tipo antes de subir el contenido.
</Warning>

## Tarjetas

Cada carrusel admite entre **2 y 10 tarjetas**.

Cada tarjeta tiene:

* **Media**: Imagen o video que se muestra en el encabezado. Puedes subir el archivo o pegar una URL. El tipo debe coincidir con el **Tipo de encabezado para tarjetas** elegido.
* **Texto de la tarjeta**: Descripción corta que aparece debajo del media.
* **Botones**: Acciones que el usuario puede tocar.

### Vistas del panel

Puedes alternar entre dos vistas con el ícono a la derecha del encabezado **Tarjetas**:

| Vista         | Cuándo usarla                                                 |
| :------------ | :------------------------------------------------------------ |
| **Expandida** | Editar el contenido de una o varias tarjetas al mismo tiempo. |
| **Compacta**  | Reordenar tarjetas o eliminarlas rápidamente.                 |

Arrastra el ícono de la izquierda de cada tarjeta para cambiar el orden. La cuenta actual se muestra abajo a la derecha (por ejemplo, `4/10`).

## Botones

Cada tarjeta admite hasta **2 botones** de estos tipos:

| Tipo                     | Comportamiento                                                       |
| :----------------------- | :------------------------------------------------------------------- |
| **Respuesta** (postback) | Envía un payload al flujo y continúa por la ruta conectada al botón. |
| **Web URL**              | Abre una URL externa en el navegador.                                |

Puedes reordenar los botones dentro de una tarjeta arrastrándolos.

<Note>
  Todas las tarjetas del carrusel deben tener **el mismo número de botones** y **el mismo tipo de botón**. La primera tarjeta define la estructura y el resto la hereda.

  Además, los botones de tipo **Web URL** admiten **1 por tarjeta** como máximo. Los botones de tipo **Respuesta** admiten hasta dos.
</Note>

## Casos de uso

<AccordionGroup>
  <Accordion title="Catálogo visual de productos">
    Un workflow que consulta el inventario de una tienda y muestra los productos como tarjetas con foto, nombre, precio y un botón **Comprar** que abre la URL del producto. Sirve para respuestas de un AI Agent o para campañas con contenido dinámico.
  </Accordion>

  <Accordion title="Menú de servicios con enrutamiento">
    Un workflow de atención donde el carrusel muestra cada servicio (Cita médica, Facturación, Reclamos) con una imagen ilustrativa y un botón **Elegir** de tipo Respuesta. El payload seleccionado se guarda en memoria y un nodo Condicional enruta la conversación al equipo correcto.
  </Accordion>

  <Accordion title="Sucursales y horarios">
    Un workflow de post-venta que muestra las sucursales cercanas con foto de la fachada, dirección y un botón **Cómo llegar** que abre Google Maps. Las tarjetas se generan a partir de una consulta a una base de datos o a una API.
  </Accordion>

  <Accordion title="Comparación de planes">
    Un carrusel con una tarjeta por plan de suscripción, video demostrativo, resumen del plan y un botón **Contratar** que dispara la siguiente parte del flujo. El plan elegido se guarda en memoria para personalizar el cobro y la confirmación.
  </Accordion>

  <Accordion title="Tarjetas de crédito de un banco">
    Un workflow de un banco que muestra su portafolio de tarjetas de crédito: cada tarjeta del carrusel usa la imagen del plástico, un resumen de beneficios y dos botones de tipo Respuesta — **Ver beneficios**, que despliega el detalle dentro del chat, y **Solicitar**, que continúa el flujo de solicitud. La tarjeta elegida se guarda en memoria para prellenar los datos del cliente.
  </Accordion>
</AccordionGroup>

## Nodos relacionados

<CardGroup cols={2}>
  <Card title="Botones" icon="hand-pointer" href="/guides/nodos/botones">
    Hasta 3 botones interactivos sin tarjetas.
  </Card>

  <Card title="Lista" icon="list" href="/guides/nodos/lista">
    Menú desplegable con hasta 10 opciones.
  </Card>

  <Card title="Call to Action" icon="arrow-up-right-from-square" href="/guides/nodos/call-to-action">
    Botón único que abre una URL externa.
  </Card>

  <Card title="Plantilla HSM" icon="envelope" href="/guides/nodos/hsm">
    Plantillas pre-aprobadas de WhatsApp con soporte de carrusel.
  </Card>
</CardGroup>