# Clientes

## Clientes

La sección Clientes se presenta en forma de widgets predeterminados, así como de un constructor de widgets donde puede mostrar cualquier dato necesario. Esta sección consta de las siguientes subsecciones:

En la sección Clientes, puede ver un resumen de boletines, mensajes enviados y recibidos, y la proporción de clientes en un gráfico circular por canales conectados.

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

De forma predeterminada, hay tres widgets en la sección "Analytics" - "Clientes", que se describirán con más detalle a continuación.

Los widgets se pueden intercambiar entre sí: para ello, arrastre el widget con este botón.

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

Luego coloque el widget en la ubicación deseada.

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

### Widgets predeterminados

#### Widget de resumen

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

El widget predeterminado "Resumen" es un resumen del análisis de clientes, subdividido en varias partes:

* Una vista general de la cantidad de nuevos clientes por canal durante un período determinado.

El ejemplo anterior muestra cuántos y de qué mensajeros (canales) llegaron los clientes durante el período de tiempo seleccionado.

* Hay datos sobre boletines y mensajes, donde puede ver el número de mensajes enviados y recibidos por mensajeros y el número de envíos realizados:
* Datos del período seleccionado.

Si desea ver el resumen para otro período de tiempo (día actual o anterior; mes, año u otro período), haga clic en el icono del calendario y luego seleccione el período adecuado.

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

Al ver estadísticas en widgets, puede notar un círculo verde delante de los números resaltados en negro y que denotan el número total de mensajes/correos electrónicos para todo el período; estos son los datos del período de tiempo seleccionado.

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

#### Widget de clientes

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

Este widget también se puede dividir condicionalmente en dos componentes:

a) Número total de clientes por año y por mes mostrado en la parte superior del gráfico.

b) Un gráfico de barras que muestra el período de enero a diciembre.

El mes contable actual en el gráfico, para el cual se calcula y muestra en la parte superior del widget el número de nuevos clientes, se resalta en azul; los demás meses de subcontabilidad, en azul claro.

En este widget también puede cambiar los colores de las columnas para una mejor visibilidad.

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

Aquí, en la configuración del widget, también puede aplicar otros filtros para mostrar estadísticas:

* Por listas y etiquetas.

Para seleccionar las listas y etiquetas deseadas, haga clic en la marca de verificación junto a cada elemento deseado.

* Por canal.
* Por bloque del embudo.
* Por clientes.
* Por etiqueta.

La etiqueta es una variable del sistema. Puede encontrarla en el diálogo con un cliente.

### Widget de clientes por canales

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

Este widget se presenta como un gráfico circular que muestra la relación entre la cantidad de clientes en diferentes canales (mensajeros) entre sí.

En el widget presentado como ejemplo, puede ver:

a) el número total de nuevos clientes para el período de informe;

b) un diagrama que muestra las proporciones de la cantidad de clientes por diferentes mensajeros;

c) mensajeros para los que se toman las estadísticas y el número de clientes frente al nombre del canal (mensajero);

d) período de informe (haciendo clic en el icono del calendario, puede seleccionar el día actual o anterior, mes, año u otro período de tiempo).

### Creación de widgets

Para crear su widget, debe hacer clic en el botón "Agregar widget", donde puede aplicar la funcionalidad deseada y mostrar todo de la manera deseada.

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

En este caso, se abrirá una ventana adicional del constructor de widgets donde.

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

1. Usted elige el período que se mostrará en las estadísticas: puede ser un día (actual o anterior); mes, año o cualquier otro período que prefiera.
2. También puede personalizar la apariencia del widget a su discreción:

* Elección del tipo de icono para el widget: por ejemplo, para contabilizar el número de mensajes puede elegir el icono de diálogo; si es para capacitación, el icono con confederado, etc.
* Tipo de diagrama para mostrar estadísticas: circular, de barras, de líneas y simplificado.

En el constructor de widgets, puede personalizar la visualización por variable y también usar la conversión por separado.

#### Variables

En la pestaña "Variables", debe especificar los valores de la variable para contabilizar las estadísticas.

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

En el ejemplo anterior, especificamos la variable de edad, que se utiliza para registrar la edad del cliente en el bot. Como especificamos "Por variables del cliente", el sistema leerá los valores de los clientes según esta variable y solo tendrá en cuenta a aquellos que tengan 18 años o más.

En su proyecto puede usar una variedad de variables que existan en su proyecto: puede ser el monto de los pagos, por ejemplo, si desea calcular estadísticas para una determinada tarifa; la ciudad de residencia, etc.

{% hint style="warning" %}
Cada línea en el widget mostrado corresponde al valor de la variable que especificó al configurarlo.

**El número máximo de líneas (valores de variable) es 6**
{% endhint %}

#### Operadores AND y OR

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

Si pasa un único valor para análisis, puede elegir cualquiera de los operadores. Sin embargo, si pasa varios valores para análisis, conviene entender la diferencia entre estos filtros:

1. El filtrado mediante el operador "AND" denota la inclusión de los valores de todas las variables.

Es decir, si selecciona "Y", el sistema buscará e incluirá en las estadísticas solo a aquellos que tengan varios valores de variables seleccionadas a la vez.

Por ejemplo, si selecciona la variable edad (valor 18) y selecciona la variable género (valor masculino), y aplica el filtro "AND", el sistema solo tomará clientes que sean hombres mayores de 18.

Condicionalmente, el sistema entiende que necesita un cliente que sea mayor de 18 años y además masculino. El sistema no incluirá a otros clientes en las estadísticas.

#### **Cómo funciona AND**

También puede hacer una búsqueda solo por una variable.

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

Si escribe var1 = 1, var2 = 2, el sistema devolverá 0. Esto se hace para que pueda establecer algunas condiciones como var1 != 1 AND var1 > 0; en este caso, el sistema devolverá aquellos clientes cuyas variables no sean iguales a uno o sean mayores que cero (con valores 2, 3, 4, etc.).

{% hint style="warning" %}
¡Tenga en cuenta!

El nombre de la variable para la instrucción AND debe ser el mismo en todas las líneas.

Por ejemplo:

* per1 = 1 AND pre2 = 2 - ¡está MAL!
* per1 < 400 AND per1 > 4 es la escritura correcta de las variables.
  {% endhint %}

{% hint style="warning" %}
Si necesita usar variables de la siguiente manera:

per1 = 1 AND pre2 = 2, entonces use el operador OR.
{% endhint %}

2. El filtrado mediante el operador OR implica uno de varios valores (o más).

Este filtro se usa si necesita una muestra de clientes con diferentes valores de variables: por ejemplo, necesita clientes que tengan más de 18 años o que vivan en Nueva York.

Entonces el operador OR incluirá en la muestra a todos aquellos que tengan una de las dos variables: edad o ciudad.

Así, el sistema entiende condicionalmente que necesitamos aquellos que sean mayores de 18 años O que vivan en Nueva York.

**Cómo funciona OR**

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

Variables: var1 = 1, var2 = 2, donde el sistema busca cualquier cliente que tenga al menos una de ellas que coincida con el valor seleccionado (puede pasarlo sin valor; entonces el sistema solo busca su presencia).

{% hint style="info" %}
Lea qué son las variables y cómo trabajar con ellas en el [Variables](/doc/es/chatbot/functions/variables.md) artículo.&#x20;
{% endhint %}

Luego puede seleccionar los canales cuyas estadísticas se tendrán en cuenta en este widget.

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

Puede hacer un seguimiento de las estadísticas por listas y etiquetas específicas asignadas a los clientes.

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

Por supuesto, también puede usar el constructor de esquemas para contabilizar a los clientes que se encuentran en un determinado estado del embudo.

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

Por ejemplo, con base en la imagen anterior, podemos contabilizar a los clientes que han eliminado una cita y luego ver el porcentaje de transacciones exitosas, lo que le ayudará a entender exactamente cómo mejorar la calidad de su negocio y tomar medidas.

Luego, puede aplicar un filtro para mostrar clientes dados de baja o, por el contrario, excluirlos de la vista.

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

El siguiente criterio con el que puede implementar la visualización de estadísticas es la etiqueta.

Una etiqueta es una variable del sistema que se puede encontrar en el diálogo con el cliente (no se puede cambiar).

La etiqueta debe ingresarse en el campo correspondiente.

#### Etiquetas UTM

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

{% hint style="info" %}
Para aprender qué son las etiquetas UTM y cómo utilizarlas, recomendamos leer el artículo “[Cómo pasar parámetros y etiquetas UTM](/doc/es/faq/questions/...transferir-etiquetas-utm.md)”.
{% endhint %}

En el primer campo “Nombre del valor” escriba el nombre que necesita para mostrar los resultados en el diagrama.

A continuación, en el campo de selección de etiquetas UTM se le presentarán las ya existentes en el proyecto.

<div data-with-frame="true"><figure><img src="/files/2c744b138b0dda2345c196695c2763b4b8642dcb" alt="" width="299"><figcaption></figcaption></figure></div>

Luego introduzca el valor de etiqueta deseado; este puede ser cualquier valor asignado para estas etiquetas.

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

De forma similar a la creación de un widget basado en variables, existe una opción de filtrado entre "todos los valores" y "uno de los valores"

{% hint style="success" %}
Si está creando un widget basado en varias etiquetas UTM y necesita que el resultado final incluya TODOS los valores, utilice el operador "Todos los valores".

Si necesita mostrar los resultados por uno de los valores, use el operador "Uno de los valores".
{% endhint %}

Cuando introduce un valor para una etiqueta, puede establecer una coincidencia:

1. igual a;
2. distinto de;
3. mayor;
4. mayor o igual que;
5. menor;
6. menor o igual que.

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

{% hint style="warning" %}
En total, se pueden pasar 6 valores en un widget y no más.
{% endhint %}

A continuación, elija qué canales usar para las etiquetas UTM en las estadísticas.

Puede seleccionar varios canales a la vez o solo uno, según su criterio.

También puede usar solo aquellos clientes que estén incluidos en una lista o que tengan asignada una etiqueta (NO UTM) para mostrarlos en el widget.

#### Conversión

Para calcular la conversión, use la pestaña del mismo nombre en el constructor de widgets.

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

El campo “Qué contar” ayudará a mostrar la tasa de conversión según 4 criterios:

1. Cantidad: conteo del número de clientes para un período de tiempo específico y para un evento/categoría o sitio específicos.

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

Al contar la cantidad, puede elegir cómo contar los valores de los clientes:

a) Todos los pases de clientes

b) pase único: conteo de usuarios únicos que pasaron por el embudo por primera vez (este bloque donde se configura Analytics).

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

1. **Suma de valores** - el sistema suma las cantidades de los valores que se tomarán en cuenta para las estadísticas;
2. **Valor promedio** - la suma de todos los valores numéricos dividida por su cantidad. Por ejemplo, hubo tres pagos: el primer pago - 1999, el segundo pago - 2455 y el tercer pago - 3455. El valor mediano sería 2.636 (sume los tres pagos y divídalos por su cantidad: tres).&#x20;
3. **El valor mediano** es el número que constituye el valor central de un conjunto de números. Tomemos el ejemplo de los pagos con los valores anteriores, donde el primer pago es 1999, el segundo pago es 2455 y el tercer pago es 3455. El valor mediano en tal caso será el número 2455, ubicado estrictamente entre el conjunto de números.

En el campo “Cómo contar”, elige contabilizar porcentajes ya sea desde el primer paso o desde el paso anterior.

No importa qué método de cálculo elija, a continuación aparecerán los ajustes del paso.

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

Aquí puede elegir contar datos por embudo o por sitio.

Para que la conversión funcione según el embudo, debe instalar bloques con “Analytics” con la configuración de categorías de eventos y eventos en el esquema del constructor.

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

{% hint style="success" %}
Lea más sobre esto en el artículo “Qué significa cada campo en el editor” en la sección '[pestaña Analytics](/doc/es/chatbot/builder/setting/analitica.md)' .
{% endhint %}

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

La casilla “Mostrar pasos para todos los valores” es necesaria para mostrar completamente los valores al calcular estadísticas en el gráfico, si necesita información más detallada en el widget.

Si desea mostrar la conversión por sitio, puede especificar el nombre necesario en el campo “Nombre del paso” (o dejarlo como predeterminado; entonces el nombre se generará automáticamente) y seleccionar el sitio necesario.

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

Para que se tengan en cuenta las estadísticas del sitio, debe marcar la casilla para guardar los datos en la configuración de la página del sitio en la sección “Analytics”.

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

En este caso, las estadísticas tendrán en cuenta el número de visitas al sitio (NO clientes únicos).

#### Filtros

El widget de filtros le ayudará a mostrar datos filtrados de una manera determinada por valores establecidos.

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

Por ejemplo, tiene varias listas que incluyen clientes. Este tipo de widget le ayudará a mostrar el número exacto de clientes presentes en cada una de las listas y a mostrarlos en el widget.

#### ¿Cómo personalizar el widget?

Primero, debe agregar el número requerido de valores para mostrar los datos en el widget.

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

{% hint style="success" %}
El widget puede aceptar un máximo total de 6 valores.
{% endhint %}

Después de eso, seleccione el filtro necesario para mostrar el número de clientes.

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

Si no establece un nombre de paso, por defecto será “Paso 1”, “Paso 2”, etc.

Luego seleccione los filtros necesarios para mostrar:

1. Canales: se mostrará el número de clientes de un determinado canal.

Por ejemplo, si tiene varios canales conectados en su proyecto, puede mostrar varios o todos en el filtro marcando los necesarios a su discreción.

2. Listas y etiquetas: el valor muestra el número de clientes, respectivamente, en las listas y etiquetas que haya definido.

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

Es similar a los canales. También puede seleccionar varias listas/etiquetas a la vez para mostrar al cliente mediante filtros.

3. Bloque del embudo: el paso expresará el número de clientes por el/los bloque(s) correspondiente(s) del embudo.

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

3. Por clientes: dados de baja, excluyéndolos o mostrándolos a todos.

Puede aplicarlo como filtro adicional en el valor para clientes: por ejemplo, para ver datos de clientes dados de baja en ciertos canales.

{% hint style="danger" %}
¡Tenga en cuenta!

Al usar el filtro "Mostrar solo dados de baja", los clientes añadidos durante el período de tiempo especificado se mostrarán con el estado "Dado de baja", independientemente de cuándo se dieron de baja.
{% endhint %}

5. Los clientes añadidos con el estado Dado de baja se mostrarán, independientemente de cuándo el usuario se dio de baja.
6. Por etiqueta, la variable del sistema asignada al cliente.

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

### Cómo eliminar un widget

Para eliminar o duplicar un widget, debe encontrar el icono correspondiente en el propio widget.

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

Al hacer clic en el botón, verá un menú con la eliminación o duplicación del widget:

{% hint style="success" %}
Ahora ya sabe cómo crear widgets y aplicarles las métricas necesarias.
{% endhint %}


---

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