# Clientes de los mensajeros

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

## Funciones

### Escribir a WhatsApp / Escribir al correo electrónico

{% hint style="success" %}
Los botones solo son visibles si WhatsApp y/o el bot de Email están conectados al proyecto.
{% endhint %}

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

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

Haz clic para abrir una ventana y añadir un nuevo contacto de WhatsApp. También puedes crear un cliente del bot de Email y enviar un correo electrónico desde aquí.

### Menú de acciones adicionales

Para realizar acciones en la **Clientes** sección, haz clic en el icono de tres puntos (⁝) en la esquina superior derecha del menú.

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

#### Marcar todo como leído

Esta función marca todos los mensajes no leídos como leídos:

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

#### Reenviar mensajes de error

Esta función reenviará el último mensaje a **TODOS** clientes cuyo último mensaje del bot muestra un estado rojo de **ERROR** .

{% hint style="danger" %}

#### Atención

Esta acción reenvía el último mensaje del bot a todos los destinatarios fallidos, incluidos los mensajes enviados mucho antes.
{% endhint %}

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

Haz clic en el botón para abrir la configuración, donde puedes establecer la fecha de reenvío, elegir un mensajero y ajustar el intervalo de envío.

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

{% hint style="danger" %}

#### Atención

Un mensaje con un error como **"Demasiadas solicitudes por segundo..."** está **se** reenvía automáticamente después del número de segundos especificado en el texto del error.
{% endhint %}

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

#### Configuración de vista previa del cliente

<div data-with-frame="true"><figure><img src="/files/244c4c176ea853bc3969af91469eea38680b99fd" alt="" width="242"><figcaption></figcaption></figure></div>

El menú de configuración te permite elegir los datos que se muestran en el panel de vista previa del cliente.

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

#### Configuración de visualización de mensajes

<div data-with-frame="true"><figure><img src="/files/3de6e463a5d7035a2ea8c96b61d13c42f8cb157c" alt="" width="245"><figcaption></figcaption></figure></div>

Aquí puedes elegir qué mensajes se mostrarán en el chat:

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

#### Eliminar no suscritos

Esta acción eliminará permanentemente de tu base de datos a todos los usuarios que bloquearon el bot y a cualquier usuario que hayas bloqueado personalmente.

<div data-with-frame="true"><figure><img src="/files/8b7c85b097b3f6e247716986f2f15815e14b2d57" alt="" width="241"><figcaption></figcaption></figure></div>

### Acciones masivas en el chat

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

**Acciones masivas en el chat** te permite seleccionar varias conversaciones de clientes para añadirlas a listas, aplicar etiquetas, marcar como leído, etc.

**Qué acciones masivas están disponibles:**&#x20;

1. Marcar como no leído.

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

Si haces clic en este icono, todos los diálogos se marcarán como "no leído".

2. Marcar como leído.

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

Si haces clic en este icono, todos los diálogos se marcarán como "leído".

3. Bloquear (desbloquear) clientes.

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

Esta acción masiva ayudará a bloquear o desbloquear a todos los clientes marcados.

4. Eliminar clientes.

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

Si haces clic en este botón, todos los clientes marcados serán <mark style="color:rojo;">**PERMANENTEMENTE**</mark> eliminados!

{% hint style="warning" %}

#### Tenga en cuenta

Todas las acciones masivas (eliminar, bloquear/desbloquear, marcar leído/no leído) requieren una confirmación adicional en una ventana emergente.

<img src="/files/09e2906e8ae8178e4707081a59fa5309757ce00f" alt="" data-size="original">

La ventana modal indica que la acción es **¡IRREVERSIBLE!** Si escribes la palabra **"Confirmar"**, la acción masiva se aplicará a los clientes seleccionados.
{% endhint %}

5. Acciones con listas y etiquetas.

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

Usa acciones masivas para añadir varios clientes a una lista (o etiquetarlos) o eliminarlos de una lista a la vez.

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

Gestiona listas y etiquetas seleccionándolas y haciendo clic en **Agregar** o **Eliminar**.

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

#### **Cómo seleccionar varios chats**

Marca la casilla en la parte superior de la columna de acciones para seleccionar todos los clientes al mismo tiempo.

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

Selecciona chats individuales marcando sus casillas correspondientes.

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

{% hint style="success" %}
Ahora estás listo para gestionar listas de clientes con acciones masivas
{% endhint %}

## Filtros

La lista de clientes incluye una **función de filtro** para ordenar los clientes según diferentes criterios.

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

Las pestañas en la parte superior de la lista de clientes ofrecen filtrado rápido:

* **Todos** – muestra todas las conversaciones de clientes almacenadas en el CRM.
* **Sin respuesta** – muestra solo los clientes que tienen mensajes no leídos.

{% hint style="info" %}

#### **Importante**

La marca "No leído" se elimina una vez que un miembro del equipo abre la conversación con el cliente.
{% endhint %}

* **Míos** – muestra los clientes asignados al empleado que está viendo la lista en ese momento.
* **Otros** – muestra los clientes asignados a otros empleados del sistema.
* **Clientes libres** – muestra los clientes que no están asignados a ningún empleado.

Revisemos la configuración de filtros disponibles.

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

Los filtros te permiten centrarte en un conjunto específico de clientes según tus consultas.

{% hint style="info" %}
Guarda la configuración de tus filtros para reutilizarla fácilmente más adelante: solo tienes que seleccionarlos de tu lista de filtros guardados.
{% endhint %}

#### **Filtros disponibles**

**Buscar** — busca por nombre o por un identificador único del mensajero. Por ejemplo, al introducir `1988` encontrará un cliente llamado `Vasya1988` y uno con ID de Telegram `7771988777`.

**Por ID del cliente** — busca un cliente por su ID interno del servicio. Este campo funciona por coincidencia parcial. Por ejemplo, `10` coincidirá con IDs como 10, 110, 100, 210, etc.

**Bloques del embudo** — muestra clientes que actualmente están en un bloque específico, como el `Bienvenida` .

**Listas de correo** — muestra clientes que están en la(s) lista(s) de correo seleccionada(s).

**Excluir listas** — excluye a los clientes que están en la(s) lista(s) de correo especificada(s).

**Excluir etiquetas** — excluye a los clientes que tienen las etiquetas de Mavibot especificadas.

**Etiquetas** — muestra clientes que tienen las etiquetas de Mavibot especificadas.

**Canales de comunicación** — muestra clientes según el bot en el que están, por ejemplo, dos bots de Telegram diferentes.

**Registrado antes de** — muestra clientes que se registraron antes de una fecha específica.\
\&#xNAN;*Ejemplo:* `Registrado antes del 23/05/2023` incluye clientes registrados hasta el 22/05/2023 23:59, pero no a los registrados el 23/05/2023 a las 00:00.

**Registrado después de** — muestra clientes que se registraron después de una fecha específica.\
\&#xNAN;*Ejemplo:* `Registrado después del 20/05/2023` incluye clientes registrados a partir del 20/05/2023 00:01 en adelante, pero no a los registrados antes.

**Ordenar chats por fecha de creación del cliente** — ordena los clientes en orden descendente (los más recientes primero).

**No leído** — muestra clientes (basado en otros filtros) que tienen mensajes no leídos.

**Mostrar dados de baja** — muestra clientes que se han dado de baja de tus bots.

**Excluir dados de baja** — oculta a los clientes que se han dado de baja de tus bots.

**Mostrar clientes bloqueados** — muestra los clientes que han sido bloqueados.

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

**Etapa del trato con CRM** — muestra todos los clientes en las etapas seleccionadas del CRM integrado.

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

**Propietario** — cuando la asignación automática o manual del cliente está habilitada, el propietario (empleado asignado) se muestra en el perfil del cliente. Puedes usar este filtro para ver los clientes según su propietario asignado.

**Búsqueda de variables** — consta de dos campos: **"Nombre de la variable"** y **"Valor de la variable."** Este filtro solo funciona con una coincidencia exacta del nombre de la variable y su valor.

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

**Ejemplo:** Si introduces el campo **"Precio"** en el *Variable* se mostrarán los clientes con una **"Precio"** variable **vinculada. Sin embargo, al introducir** ya no programarán **no** "precios" **"Precio"** variable.

El **encontrar el campo** Valor de la variable

funciona de la misma manera: requiere una coincidencia exacta. Puedes completar ambos campos al mismo tiempo. Por ejemplo, si configuras **"Tamaño"** en el *Variable* campo y **"M"** en el *encontrar el campo* campo, solo verás los clientes en los que `tamaño = M`.

**Restablecer filtros**r**s** — restablece todos los filtros.&#x20;

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

También puedes combinar todos los filtros anteriores para crear el segmento exacto de clientes que necesitas.

### Cómo descargar la base de datos de clientes

Para descargar la base de datos de clientes como archivo, ve a:\
**Clientes → Filtro → Descargar**

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

{% hint style="danger" %}

#### **Atención**

* La exportación admite hasta **100.000 clientes** por archivo CSV cuando se incluyen todas las variables.
* Para bases de datos **que superen los 100.000 clientes**, divide la exportación en varias partes si necesitas todas las variables del cliente.
* En la **.xls** formato de archivo, solo las **11 columnas principales** se incluirán.
  {% endhint %}

El botón te permite exportar tu lista de clientes en un formato estándar — **CSV** o **XLS** — que se puede abrir en Excel. El archivo contendrá las siguientes columnas:

1. **ID del cliente** (`client_id`)
2. **Nombre del cliente**
3. **Mensajero** usado por el cliente
4. **Bot** con el que el cliente contactó
5. **ID único del mensajero** (p. ej., número de teléfono para WhatsApp)
6. **Datos de la última acción**
7. **Fecha de la última acción**
8. **URL del avatar del cliente**
9. **ID del bloque actual**
10. **Historial de clics** (bloques visitados)
11. **Etiqueta**

{% hint style="info" %}
**Después de estas 11 columnas, se incluirán variables personalizadas, pero solo en el formato de archivo .CSV.**
{% endhint %}

También puedes exportar clientes de una lista específica. Para ello, haz clic en el **Exportar clientes** botón en la **Listas** sección.

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

## tarjeta del cliente

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

La tarjeta del cliente muestra detalles clave del cliente:

* **Avatar**
* **Icono del mensajero** usado por el cliente
* **Nombre del cliente**
* **Estado del cliente** (p. ej., *bloqueado* / *en pausa*)
* **Empleado asignado**

– Vinculado a ti → muestra **"Tu cliente"**\
– Vinculado a otro empleado → muestra su correo electrónico o nombre\
– Sin asignar → no se muestra ninguna etiqueta

* **Hora de la última actividad**
* **Indicador del último mensaje** (uno de los siguientes):

— **Cliente** — último mensaje enviado por el cliente\
– **No** — último mensaje enviado por ti\
– **Correo electrónico del empleado** — último mensaje enviado por otro empleado\
– **Comentario** — el último mensaje es un comentario\
– **Adjunto** — el último mensaje contiene un archivo adjunto

* **Icono de cliente fijado**, si el cliente está fijado

{% hint style="info" %}
Para abrir un chat, haz clic en la tarjeta del cliente.
{% endhint %}

### Menú contextual

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

El menú contextual de la tarjeta del cliente incluye:

* **Marcar como no leído** – marca la conversación como no leída y mueve al cliente a **"Sin respuesta"** .
* **Fijar/Desfijar conversación** – fija el chat en la parte superior de la lista (por encima de todos los demás) o lo desfija.
* **Bloquear/Desbloquear** – bloquea o desbloquea al cliente.
* **Eliminar cliente** – elimina permanentemente al cliente de la base de datos. **Esta acción no se puede deshacer.**

Puedes personalizar la vista previa del cliente para mostrar la información que más te importa.

Al hacer clic en una tarjeta de cliente en la lista principal se abre el chat con ese cliente. En el panel derecho, verás el perfil completo del cliente. Cada sección de la tarjeta del cliente en el panel derecho se describe en detalle en [nuestra guía](/doc/es/crm/customers/helpdesk.md).&#x20;

Ten en cuenta que el menú de la izquierda muestra el **número de mensajes no leídos**.

Esto te permite ver cuántos mensajes están esperando tu atención sin abrir el **Clientes** sección.

Lo que se muestra depende de tu rol en el proyecto:

* **Los administradores** ven el número total de todos los mensajes no leídos en el proyecto.
* **Operadores** ven solo los mensajes no leídos de los clientes asignados a ellos.


---

# 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/customers.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.