# Listas y etiquetas

En la **Listas** sección, puedes crear, editar y usar listas personalizadas de clientes para automatización.\
Agregar clientes a una lista puede automatizarse según pasos del flujo del bot, activados por condiciones específicas o acciones del usuario.

Las listas se pueden usar para:

* Filtrar y segmentar clientes dentro de un proyecto
* Exportar datos

Puedes exportar una lista como archivo e importarla en otro proyecto de MaviBot.

<div data-with-frame="true"><figure><img src="/files/e35029a4ce47eb0a2954e5b844f72f4137014bf4" alt=""><figcaption></figcaption></figure></div>

#### **Ventajas de usar listas:**

* **Automatización:** Los clientes se agregan o se eliminan automáticamente de las listas según la lógica del bot.
* **Portabilidad:** Las listas se pueden exportar e importar entre diferentes proyectos.
* **Comunicación dirigida:** Envía mensajes masivos o mensajes específicos del embudo directamente a listas de clientes filtradas.

Usar listas agiliza la segmentación de la audiencia y hace que la interacción con los clientes sea más precisa y eficiente.

## Cómo crear una lista

Las listas se crean en la **"Listas"** pestaña dentro de la misma sección.

<div data-with-frame="true"><figure><img src="/files/f263653a25a470bb4cc28debfc80162ab21d0a05" alt=""><figcaption></figcaption></figure></div>

Haz clic en el **"Crear una lista"** botón para abrir una ventana con campos de entrada donde puedes introducir el nombre de la lista y seleccionar una carpeta (si existe alguna) para añadir la lista.

<div data-with-frame="true"><figure><img src="/files/6720e4ad7fa06fed11d9e81f62bb989b5e528d01" alt=""><figcaption></figcaption></figure></div>

En la **"Listas"** sección, puedes ordenar las listas por ID de lista o alfabéticamente (por nombre):

<div data-with-frame="true"><figure><img src="/files/c54f6bf2478fc5d11d3483d2ee87e2f9cf54e767" alt="" width="212"><figcaption></figcaption></figure></div>

La flexibilidad de las listas de clientes radica en su versatilidad. Puedes, por ejemplo, agregar un solo cliente a **múltiples listas simultáneamente**.

Las listas pueden ser:

* Agrupadas en carpetas
* Renombradas
* Eliminadas (los clientes en sí permanecen en la base de datos)
* Usadas para **eliminar de un proyecto a todos los clientes dentro de una lista** del proyecto

<div data-with-frame="true"><figure><img src="/files/d089f9927d960e54b6ac35dd706066a7785085fb" alt="" width="563"><figcaption></figcaption></figure></div>

Puedes incluir o excluir clientes aplicando tipos de filtro: de forma manual mediante un formulario o cargando un archivo.

Para ver los clientes dentro de una lista:

1. Haz clic en la lista para abrir el menú del lado derecho.
2. Haz clic en el **"Ver lista de clientes"** botón.

<div data-with-frame="true"><figure><img src="/files/9e9ce5bc240546da6d5c6008b65b0deb94bc9efd" alt="" width="563"><figcaption></figcaption></figure></div>

Entonces se abrirá una nueva ventana desde la **"Clientes"** sección, donde puedes ver a todos los usuarios de esa lista.

## Cómo automatizar tu trabajo con listas

Puedes agregar, eliminar o mover clientes entre listas automáticamente mientras el chatbot está en funcionamiento.

Encuentra el conjunto de **acciones de lista** en cualquier bloque del constructor:

<div data-with-frame="true"><figure><img src="/files/35ab5d071cd3c75394853624efcacef8f2f9f29a" alt=""><figcaption></figcaption></figure></div>

Cuando la **"Acción"** sección está activada, puedes elegir qué acciones realizar en tus listas.

<div data-with-frame="true"><figure><img src="/files/a65e6baa738790f6dc62355722ede90bce59018f" alt="" width="375"><figcaption></figcaption></figure></div>

Después de seleccionar una acción, puedes elegir a qué lista específica aplicarla. También puedes especificar varias acciones diferentes dentro del mismo bloque: no hay límite en la cantidad de acciones que puedes añadir en un bloque.

<div data-with-frame="true"><figure><img src="/files/99f7d78201c843d9e103e01b651813df5fc6d684" alt="" width="375"><figcaption></figcaption></figure></div>

Los comandos se ejecutan en el orden en que aparecen en la configuración del bloque.

### Comprobar si una persona está en la lista

Para <mark style="color:verde;">**comprobar si un cliente está en la lista**</mark>, puedes usar el <mark style="color:verde;">**`inlist (número_de_lista)`**</mark> función en la **"Variable"** campo para comparación dentro de bloques y conexión.

El resultado de la ejecución de la función es un valor booleano (Verdadero o Falso).

`inlist(número de lista) == Verdadero -` el cliente SÍ está en la lista o

`inlist(número de lista) == Falso -` el cliente NO está en la lista.

<figure><img src="/files/26c94fd0b0809652a518c0a70e5dc941a27b0ed9" alt=""><figcaption></figcaption></figure>

El número de lista se puede encontrar haciendo clic en la lista requerida. En este caso, se abre el menú derecho con información sobre la lista:

<div data-with-frame="true"><figure><img src="/files/89d56fa37f147e78b0f3489b818bf947bd9b3ec7" alt=""><figcaption></figcaption></figure></div>

### Otras funciones relacionadas con listas

{% hint style="info" %}
[Puedes encontrar aquí las instrucciones detalladas para trabajar con funciones de listas y etiquetas.](/doc/es/chatbot/functions/calculadora/lists.md)
{% endhint %}

## **Cómo trabajar con listas manualmente**

Cada lista tiene botones para:

* Agregar/eliminar clientes de la lista
* Lanzar un envío masivo basado en la lista
* Descargar la lista como archivo

El menú contextual incluye opciones para:

* Agregar la lista a una carpeta
* Editar la lista
* Eliminar la lista (los clientes permanecen en el proyecto)
* Eliminar del proyecto a todos los clientes de la lista

{% hint style="danger" %}

#### **Advertencia**

**"Eliminar miembros de la lista del proyecto"** elimina permanentemente a esos clientes del proyecto. Esta acción no se puede deshacer.
{% endhint %}

### Añadir clientes a una lista

<div data-with-frame="true"><figure><img src="/files/5fe598b773d09707c479e58535d9c443995a1156" alt="" width="375"><figcaption></figcaption></figure></div>

Puedes agregar manualmente **clientes existentes** a una lista filtrándolos mediante un formulario, cargando un archivo o seleccionando desde otra lista.

{% hint style="warning" %}

#### Importante

Al agregar clientes existentes a una lista **desde un archivo**, la primera columna debe contener los **IDs internos de cliente** (el `client_id` variable).
{% endhint %}

#### Cómo agregar clientes desde un archivo:

1. Selecciona el **"Clientes desde un archivo"** tipo de filtro:

<div data-with-frame="true"><figure><img src="/files/e2726b57193b2d176fd3d877e145bbe3f7135eac" alt="" width="375"><figcaption></figcaption></figure></div>

2. A continuación, carga una lista de clientes en formato .CSV

<div data-with-frame="true"><figure><img src="/files/423b9f376227a20e3fe00a831ced5bbbdac234ee" alt="" width="375"><figcaption></figcaption></figure></div>

Para <mark style="color:verde;">**agregar NUEVOS clientes**</mark> a una lista específica, ve a la sección **"Canales"** . Luego haz clic en el botón **"Cargar lista de clientes"** y selecciona la lista a la que deseas cargar clientes.

### Cómo eliminar clientes de una lista

Puedes eliminar clientes de una lista de la misma manera: haz clic en el **"— Eliminar de la lista**" y aplica filtros si es necesario.

<div data-with-frame="true"><figure><img src="/files/cde3712dda71df0efafb51578a8097eace054b83" alt="" width="375"><figcaption></figcaption></figure></div>

Aplica los filtros necesarios para eliminar un grupo específico de clientes **DE ESTA LISTA** (no de la base de datos de clientes).

{% hint style="danger" %}
**Ten cuidado al rellenar el formulario.**

Si dejas los campos de filtro en el formulario **"Eliminar de la lista"** vacíos **se eliminarán**, **todos los clientes** de esa lista.

Para eliminar solo una parte de la lista, completa los filtros relevantes:

* **Por mensajeros conectados** — selecciona un bot específico
* **Clientes en un bloque** — especifica el/los número(s) de bloque en el embudo (se pueden añadir varios bloques)
* **Por variables del cliente** — introduce un valor exacto de variable
* **Registrado antes/después** — establece el rango de fechas correspondiente
* **Excluir listas** — si se introducen números de lista, solo se eliminarán los clientes **no** presentes en cualquiera de esas listas de exclusión de la lista actual.
  {% endhint %}

## Cómo crear un envío masivo

Cuando hagas clic en la lista, también verás el botón **"Crear un envío masivo"** en la barra lateral derecha.

<div data-with-frame="true"><figure><img src="/files/fff208015e28edb91d7e007bfa64c8b6f15f02aa" alt="" width="563"><figcaption></figcaption></figure></div>

Puedes crear un envío masivo para ambos **mensajeros** y **correo electrónico** (si el correo electrónico está habilitado en tu proyecto).

## Cómo transferir clientes desde otras plataformas

Al cargar clientes desde otras plataformas en la sección **"Mensajeros"** , puedes seleccionar una o más listas donde se colocarán los clientes después de la carga.

Para hacerlo:

1. Ve a la pestaña **"Mensajeros"** sección.
2. Selecciona el mensajero conectado donde deseas cargar los clientes.

<div data-with-frame="true"><figure><img src="/files/ece8efa885287ba8e1fffdab4e203f99ceb4522c" alt=""><figcaption></figcaption></figure></div>

Haz clic en el **"Cargar clientes"** botón y configura los ajustes de carga (codificación, lista de destino, etc.) para importar tu lista.

<div data-with-frame="true"><figure><img src="/files/2993e2508ff7630fbfeba7284b9add8cc2ce1005" alt="" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/es/crm/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.