# Clientes

## Clientes

A seção Clientes é apresentada na forma de widgets padrão, além de um construtor de widgets onde você pode exibir quaisquer dados necessários. Esta seção consiste nas seguintes subseções:

Na seção Clientes, você pode ver um resumo de newsletters, mensagens enviadas e recebidas, e a proporção de clientes em um gráfico de pizza por canais conectados.

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

Por padrão, há três widgets na seção "Analytics" - "Clientes", que serão descritos em mais detalhes abaixo.

Os widgets podem ser trocados entre si: para isso, arraste o widget por este botão.

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

Em seguida, posicione o widget no local desejado.

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

### Widgets padrão

#### Widget de resumo

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

O widget padrão "Resumo" é um resumo das análises de clientes, subdividido em várias partes:

* Uma visão geral do número de novos clientes por canal ao longo de um determinado período.

O exemplo acima mostra quantos e de quais mensageiros (canais) os clientes vieram no período de tempo selecionado.

* Há dados sobre newsletters e mensagens, onde você pode ver o número de mensagens enviadas e recebidas por mensageiros e o número de disparos realizados:
* Dados para o período selecionado.

Se você quiser ver o resumo de um período diferente (dia atual ou anterior; mês, ano ou outro período), clique no ícone de calendário e selecione o período apropriado.

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

Ao visualizar estatísticas em widgets, você pode notar um círculo verde na frente dos números destacados em preto, que indica o número total de mensagens/e-mails para todo o período - esses são os dados para o período de tempo selecionado.

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

#### Widget de clientes

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

Este widget também pode ser dividido condicionalmente em dois componentes:

a) Número total de clientes por ano e por mês exibido na parte superior do gráfico.

b) Um gráfico de barras mostrando o período de janeiro a dezembro.

O mês contábil atual no gráfico, para o qual o número de novos clientes é calculado e exibido na parte superior do widget, está destacado em azul; os outros meses subcontábeis - em azul claro.

Neste widget, você também pode alterar as cores das colunas para melhor visibilidade.

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

Aqui, nas configurações do widget, você também pode aplicar outros filtros para exibição de estatísticas:

* Por listas e tags.

Para selecionar as listas e rótulos desejados, clique na marca de seleção ao lado de cada item desejado.

* Por canal.
* Por bloco do funil.
* Por clientes.
* Por tag.

Tag é uma variável do sistema. Você pode encontrá-la no diálogo com um cliente.

### Widget de clientes por canais

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

Este widget é apresentado como um gráfico de pizza que mostra a proporção do número de clientes em diferentes canais (mensageiros) entre si.

No widget apresentado como exemplo, você pode ver:

a) o número total de novos clientes no período de referência;

b) um gráfico mostrando as proporções do número de clientes por diferentes mensageiros;

c) mensageiros para os quais a estatística é coletada e o número de clientes em relação ao nome do canal (mensageiro);

d) período de referência (clicando no ícone de calendário, você pode selecionar o dia atual ou anterior, mês, ano ou outro período de tempo).

### Criação de widget

Para criar seu widget, você precisa clicar no botão "Adicionar Widget", onde você pode aplicar a funcionalidade desejada e exibir tudo da forma desejada.

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

Nesse caso, uma janela adicional do construtor de widgets será aberta, onde.

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

1. Você escolhe o período a ser exibido nas estatísticas: pode ser um dia (atual ou anterior); mês, ano ou qualquer outro período de sua preferência.
2. Você também pode personalizar a aparência do widget a seu critério:

* Escolha do tipo de ícone do widget: por exemplo, para contagem do número de mensagens, você pode escolher o ícone de diálogo; se for para treinamento, o ícone com confederado, etc.
* Tipo de gráfico para exibição de estatísticas: pizza, barras, linha e simplificado.

No construtor de widgets, você pode personalizar a exibição por variável e também usar conversão separadamente.

#### Variáveis

Na aba "Variáveis", você deve especificar os valores da variável para contabilizar as estatísticas.

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

No exemplo acima, especificamos a variável de idade, que é usada para registrar a idade do cliente no bot. Como especificamos "Por variáveis do cliente", o sistema lerá os valores dos clientes de acordo com essa variável e levará em conta apenas aqueles que têm 18 anos ou mais.

No seu projeto, você pode usar uma variedade de variáveis que existem no projeto: pode ser o valor dos pagamentos, por exemplo, se você quiser calcular estatísticas para uma determinada tarifa; a cidade de residência etc.

{% hint style="warning" %}
Cada linha no widget exibido corresponde ao valor da variável que você especificou ao configurá-lo.

**O número máximo de linhas (valores de variável) é 6**
{% endhint %}

#### Operadores AND e OR

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

Se você passar um único valor para análise, pode escolher qualquer um dos operadores. No entanto, se você passar vários valores para análise, vale a pena entender a diferença entre esses filtros:

1. A filtragem pelo operador "AND" denota a inclusão dos valores de todas as variáveis.

Ou seja, se você selecionar "And", o sistema buscará e incluirá nas estatísticas apenas aqueles que tiverem vários valores de variáveis selecionados ao mesmo tempo.

Por exemplo, se você selecionar a variável idade (valor 18) e a variável gênero (valor masculino), e aplicar o filtro "AND", o sistema amostrará apenas clientes do sexo masculino com mais de 18 anos.

De forma condicional, o sistema entende que você precisa de um cliente que tenha mais de 18 anos e seja do sexo masculino. O sistema não incluirá outros clientes nas estatísticas.

#### **Como o AND funciona**

Você também pode fazer uma busca apenas por uma variável.

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

Se você escrever var1 = 1, var2 = 2, o sistema retornará 0. Isso é feito para que você possa definir algumas condições como var1 != 1 AND var1 > 0 - nesse caso, o sistema retornará aqueles clientes cujas variáveis não sejam iguais a um ou maiores que zero (com valores 2, 3, 4 etc.).

{% hint style="warning" %}
Atenção!

O nome da variável para a instrução AND deve ser o mesmo em todas as linhas.

Por exemplo:

* per1 = 1 AND pre2 = 2 - está ERRADO!
* per1 < 400 AND per1 > 4 é a forma correta de escrever as variáveis.
  {% endhint %}

{% hint style="warning" %}
Se você precisar usar as variáveis da seguinte forma:

per1 = 1 AND pre2 = 2, então use o operador OR.
{% endhint %}

2. A filtragem pelo operador OR envolve um de vários valores (ou mais).

Esse filtro é usado se você precisar de uma amostra de clientes com diferentes valores de variáveis: por exemplo, você precisa de clientes com mais de 18 anos ou que morem em Nova York

Então o operador OR incluirá na amostra todos os que tiverem uma das duas variáveis, idade ou cidade.

Assim, o sistema entende condicionalmente que precisamos daqueles que têm mais de 18 anos OU que moram em Nova York.

**Como o OR funciona**

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

Variáveis: var1 = 1, var2 = 2, em que o sistema procura qualquer cliente que tenha pelo menos uma delas correspondendo ao valor selecionado (você pode passá-la sem valor - então o sistema apenas procura sua presença).

{% hint style="info" %}
Leia o que são variáveis e como trabalhar com elas no [Variáveis](/doc/pt/chatbot/functions/variaveis.md) artigo.&#x20;
{% endhint %}

Em seguida, você pode selecionar os canais cujas estatísticas serão levadas em conta neste widget.

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

Você pode acompanhar estatísticas por listas e tags específicas atribuídas aos clientes.

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

Claro, você também pode usar o construtor de esquema para contabilizar clientes que estejam em determinado estado do funil.

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

Por exemplo, com base na imagem acima, podemos contabilizar clientes que cancelaram um agendamento e, em seguida, visualizar a porcentagem de transações bem-sucedidas, o que ajudará você a entender exatamente como melhorar a qualidade do seu negócio e tomar medidas.

Depois, você pode aplicar um filtro para exibir clientes descadastrados ou, inversamente, excluí-los da visualização.

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

O próximo critério pelo qual você pode implementar a exibição de estatísticas é a tag.

Uma tag é uma variável do sistema que pode ser encontrada no diálogo do cliente (ela não pode ser alterada).

A tag deve ser inserida no campo apropriado.

#### Tags UTM

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

{% hint style="info" %}
Para saber o que são tags UTM e como usá-las, recomendamos a leitura do artigo “[Como passar parâmetros e tags UTM](/doc/pt/faq/questions/...transferir-etiquetas-utm.md)”.
{% endhint %}

No primeiro campo “Nome do valor” você escreve o nome que precisa exibir os resultados no gráfico.

Em seguida, no campo de seleção de tags UTM, serão apresentadas as já existentes no projeto.

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

Depois, insira o valor desejado do rótulo - esse pode ser qualquer valor atribuído a esses rótulos.

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

Da mesma forma que ao criar um widget com base em variáveis, há a escolha da filtragem "todos os valores" e "um dos valores"

{% hint style="success" %}
Se você estiver criando um widget com base em várias tags UTM e precisar que o resultado final inclua TODOS os valores, use o operador "Todos os valores".

Se você precisar exibir os resultados por um dos valores, use o operador "Um dos valores".
{% endhint %}

Quando você insere um valor para um rótulo, pode definir uma correspondência:

1. igual a;
2. diferente de;
3. maior;
4. maior ou igual a;
5. menor;
6. menor ou igual a.

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

{% hint style="warning" %}
No total, 6 valores podem ser passados em um único widget e não mais do que isso.
{% endhint %}

Em seguida, escolha quais canais usar para tags UTM nas estatísticas.

Você pode selecionar vários canais ao mesmo tempo ou apenas um, conforme sua preferência.

Você também pode usar apenas aqueles clientes que estão incluídos em uma lista ou que têm um rótulo (NÃO UTM) atribuído a eles para exibição no widget.

#### Conversão

Para calcular a conversão, use a aba de mesmo nome no construtor de widgets.

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

O campo “O que contar” ajudará a exibir a taxa de conversão por 4 critérios:

1. Quantidade — contagem do número de clientes para um período de tempo específico e para um evento/categoria ou site específico.

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

Ao contar o número, você pode escolher como contar os valores para os clientes:

a) Todas as passagens do cliente

b) passagem única - contagem de usuários únicos que passaram pelo funil pela primeira vez (este bloco onde o Analytics está configurado).

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

1. **Soma dos valores** - o sistema soma as quantidades dos valores a serem considerados para estatísticas;
2. **Valor médio** - a soma de todos os valores dos números dividida pela quantidade deles. Por exemplo, houve três pagamentos: o primeiro pagamento - 1999, o segundo pagamento - 2455, e o terceiro pagamento - 3455. O valor mediano seria 2.636 (some os três pagamentos e divida pela quantidade deles - três).&#x20;
3. **O valor mediano** é o número que representa o valor central de um conjunto de números. Tome o exemplo dos pagamentos com os valores anteriores, em que o primeiro pagamento é 1999, o segundo pagamento é 2455 e o terceiro pagamento é 3455. O valor mediano nesse caso será o número 2455, ficando estritamente no meio do conjunto de números.

No campo “Como contar”, você escolhe contar percentuais a partir da primeira etapa ou da etapa anterior.

Não importa qual método de cálculo você escolher, as configurações da etapa aparecerão em seguida.

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

Aqui você pode escolher contar os dados por funil ou por site.

Para que a conversão funcione de acordo com o funil, você precisa instalar blocos com “Analytics” com as configurações de categorias de eventos e eventos no esquema do construtor.

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

{% hint style="success" %}
Leia mais sobre isso no artigo “O que cada campo significa no editor” na seção '[Aba Analytics](/doc/pt/chatbot/builder/setting/analises.md)' .
{% endhint %}

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

A caixa de seleção “Exibir etapas para todos os valores” é necessária para exibir completamente os valores ao calcular estatísticas no gráfico, caso você precise de informações mais detalhadas no widget.

Se você quiser exibir a conversão por site, pode especificar o nome necessário no campo “Nome da etapa” (ou deixá-lo como padrão - então o nome será gerado automaticamente) e selecionar o site necessário.

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

Para que as estatísticas do site sejam levadas em conta, você precisa marcar a caixa para salvar os dados nas configurações da página do site na seção “Analytics”.

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

Nesse caso, as estatísticas levarão em conta o número de visitas ao site (NÃO clientes únicos).

#### Filtros

O widget de filtro ajudará você a exibir dados filtrados de uma determinada forma por valores definidos.

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

Por exemplo, você tem várias listas que incluem clientes. Esse tipo de widget ajudará você a exibir o número exato de clientes presentes em cada uma das listas e mostrá-los no widget.

#### Como personalizar o widget?

Primeiro, você precisa adicionar a quantidade necessária de valores para exibir os dados no widget.

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

{% hint style="success" %}
O widget pode aceitar no máximo 6 valores no total.
{% endhint %}

Depois disso, selecione o filtro necessário para exibir o número de clientes.

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

Se você não definir um nome de etapa, o padrão será “Etapa 1”, “Etapa 2” etc.

Em seguida, selecione os filtros necessários para exibir:

1. Canais - será exibido o número de clientes de um determinado canal.

Por exemplo, se você tiver vários canais conectados no seu projeto, poderá exibir vários ou todos eles no filtro, marcando os necessários conforme sua preferência.

2. Listas e Rótulos - O valor exibe o número de clientes respectivamente nas listas e rótulos que você definiu.

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

É semelhante aos canais. Você também pode selecionar várias listas/rótulos de uma vez para exibir o cliente por filtros.

3. Bloco do funil - a etapa expressará o número de clientes pelo(s) bloco(s) correspondente(s) do funil.

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

3. Por clientes: descadastrados, excluindo-os ou exibindo todos.

Você pode aplicá-lo como filtro adicional no valor para clientes: por exemplo, para visualizar dados de clientes descadastrados em determinados canais.

{% hint style="danger" %}
Atenção!

Ao usar o filtro "Mostrar apenas descadastrados", os clientes adicionados durante o período de tempo especificado serão exibidos com o статус "Descadastrado", independentemente de quando eles se descadastraram.
{% endhint %}

5. Os clientes adicionados com o статус Descadastrado serão exibidos, independentemente de quando o usuário se descadastrou.
6. Por tag, a variável do sistema atribuída ao cliente.

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

### Como excluir widget

Para excluir ou duplicar um widget, você precisa encontrar o ícone correspondente no próprio widget.

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

Ao clicar no botão, você verá um menu com a remoção ou duplicação do widget:

{% hint style="success" %}
Agora você sabe como criar widgets e aplicar a eles as métricas necessárias.
{% 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/pt/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.