# Clientes de mensageiros

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

## Funções

### Escrever para WhatsApp / Escrever para E-mail

{% hint style="success" %}
Os botões ficam visíveis somente se o bot do WhatsApp e/ou E-mail estiver conectado ao projeto.
{% endhint %}

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

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

Clique para abrir uma janela e adicionar um novo contato do WhatsApp. Você também pode criar um cliente do bot de E-mail e enviar um e-mail daqui.

### Menu de ações adicionais

Para realizar ações na **Clientes** seção, clique no ícone de três pontos (⁝) no canto superior direito do menu.

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

#### Marcar todos como lidos

Esta função marca todas as mensagens não lidas como lidas:

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

#### Reenviar mensagens com erro

Esta função reenviará a última mensagem para **TODAS** clientes cuja última mensagem do bot mostra um status vermelho **ERRO** .

{% hint style="danger" %}

#### Atenção

Esta ação reenvia a última mensagem do bot para todos os destinatários com falha — incluindo mensagens enviadas muito antes.
{% endhint %}

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

Clique no botão para abrir as configurações, onde você pode definir a data de reenvio, escolher um mensageiro e ajustar o intervalo de envio.

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

{% hint style="danger" %}

#### Atenção

Uma mensagem com um erro como **"Muitas solicitações por segundo..."** estiver **será automaticamente** reenviada após a quantidade de segundos especificada no texto do erro.
{% endhint %}

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

#### Configurações de pré-visualização do cliente

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

O menu de configurações permite escolher os dados exibidos no painel de pré-visualização do cliente.

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

#### Configurações de exibição de mensagens

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

Aqui você pode escolher quais mensagens serão exibidas no chat:

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

#### Excluir descadastrados

Esta ação removerá permanentemente do seu banco de dados todos os usuários que bloquearam o bot e quaisquer usuários que você bloqueou pessoalmente.

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

### Ações em massa no chat

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

**Ações em massa no chat** permite selecionar várias conversas de clientes para adicionar a listas, aplicar rótulos, marcar como lidas etc.

**Quais ações em massa estão disponíveis:**&#x20;

1. Marcar como não lido.

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

Se você clicar neste ícone, todos os diálogos serão marcados como "não lidos".

2. Marcar como lido.

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

Se você clicar neste ícone, todos os diálogos serão marcados como "lidos".

3. Bloquear (desbloquear) clientes.

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

Esta ação em massa ajudará a bloquear ou desbloquear todos os clientes marcados.

4. Excluir clientes.

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

Se você clicar neste botão, todos os clientes marcados serão <mark style="color:vermelho;">**PERMANENTEMENTE**</mark> excluídos!

{% hint style="warning" %}

#### Observe

Todas as ações em massa (excluir, bloquear/desbloquear, marcar lido/não lido) exigem uma confirmação extra em uma janela pop-up.

<img src="/files/21b1dbc9a492cd51df8dd01a0396b6dca9c725d9" alt="" data-size="original">

A janela modal informa que a ação é **IRREVERSÍVEL!** Se você digitar a palavra **"Confirmar"**, a ação em massa será aplicada aos clientes selecionados.
{% endhint %}

5. Ações com listas e tags.

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

Use ações em massa para adicionar vários clientes a uma lista (ou marcá-los com tags) ou removê-los de uma lista de uma só vez.

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

Gerencie listas e tags selecionando-as e clicando **Adicionar** ou **Excluir**.

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

#### **Como selecionar vários chats**

Marque a caixa no topo da coluna de ações para selecionar todos os clientes ao mesmo tempo.

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

Selecione chats individuais marcando suas caixas correspondentes.

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

{% hint style="success" %}
Agora você está pronto para gerenciar listas de clientes com ações em massa
{% endhint %}

## Filtros

A lista de clientes inclui uma **função de filtro** para organizar os clientes por diferentes critérios.

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

As abas no topo da lista de clientes oferecem filtragem rápida:

* **Todos** – exibe todas as conversas de clientes armazenadas no CRM.
* **Sem resposta** – mostra apenas clientes que têm mensagens não lidas.

{% hint style="info" %}

#### **Importante**

A marcação "Não lido" é removida assim que um membro da equipe abre a conversa com o cliente.
{% endhint %}

* **Meus** – exibe clientes atribuídos ao funcionário que está visualizando a lista no momento.
* **Outros** – exibe clientes atribuídos a outros funcionários do sistema.
* **Clientes livres** – exibe clientes não atribuídos a nenhum funcionário.

Vamos revisar as configurações de filtro disponíveis.

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

Os filtros permitem que você foque em um conjunto específico de clientes com base nas suas consultas.

{% hint style="info" %}
Salve suas configurações de filtro para reutilização fácil depois — basta selecioná-las na sua lista de filtros salvos.
{% endhint %}

#### **Filtros disponíveis**

**Busca** — pesquisa por nome ou por um identificador único de mensageiro. Por exemplo, ao inserir `1988` encontrará um cliente chamado `Vasya1988` e um com ID do Telegram `7771988777`.

**Por ID do cliente** — pesquisa um cliente pelo ID interno do serviço. Este campo funciona com correspondência parcial. Por exemplo, `10` corresponderá a IDs como 10, 110, 100, 210 etc.

**Blocos do funil** — exibe clientes que estão atualmente em um bloco específico, como o `Boas-vindas` .

**Listas de disparo** — exibe clientes que estão na(s) lista(s) de disparo selecionada(s).

**Excluir listas** — exclui clientes que estão na(s) lista(s) de disparo especificada(s).

**Excluir tags** — exclui clientes que têm as tags Mavibot especificadas.

**Tags** — exibe clientes que têm as tags Mavibot especificadas.

**Canais de comunicação** — exibe clientes pelo bot em que estão, por exemplo, dois bots diferentes do Telegram.

**Registrado antes de** — exibe clientes que se registraram antes de uma data específica.\
\&#xNAN;*Exemplo:* `Registrado antes de 23/05/2023` inclui clientes registrados até 22/05/2023 23:59, mas não aqueles registrados em 23/05/2023 às 00:00.

**Registrado depois de** — exibe clientes que se registraram depois de uma data específica.\
\&#xNAN;*Exemplo:* `Registrado depois de 20/05/2023` inclui clientes registrados a partir de 20/05/2023 00:01 em diante, mas não aqueles registrados antes.

**Ordenar chats pela data de criação do cliente** — ordena os clientes em ordem decrescente (mais novos primeiro).

**Não lido** — exibe clientes (com base em outros filtros) que têm mensagens não lidas.

**Exibir descadastrados** — exibe clientes que cancelaram a inscrição dos seus bots.

**Excluir descadastrados** — oculta clientes que cancelaram a inscrição dos seus bots.

**Exibir clientes bloqueados** — exibe clientes que foram bloqueados.

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

**Etapa do negócio com CRM** — exibe todos os clientes nas etapas selecionadas do CRM integrado.

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

**Proprietário** — quando a atribuição automática ou manual de clientes está ativada, o proprietário (funcionário atribuído) é mostrado no perfil do cliente. Você pode usar este filtro para visualizar clientes pelo proprietário atribuído.

**Busca por variável** — consiste em dois campos: **"Nome da variável"** e **"Valor da variável."** Este filtro funciona apenas com correspondência exata do nome da variável e do seu valor.

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

**Exemplo:** Se você inserir o campo **"Preço"** no campo *Variável* , clientes com uma **"Preço"** variável vinculada serão exibidos. No entanto, ao inserir **"preços"** não irão **não** encontre o **"Preço"** variável.

O **Valor da variável** campo funciona da mesma forma — ele exige uma correspondência exata.

Você pode preencher os dois campos ao mesmo tempo. Por exemplo, se você definir o campo **"Tamanho"** no campo *Variável* e o campo **"M"** no campo *Valor da variável* , você verá apenas clientes em que `tamanho = M`.

**Redefinir filte**r**s** — redefine todos os filtros.&#x20;

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

Você também pode combinar todos os filtros acima para criar exatamente o segmento de clientes de que precisa.

### Como baixar o banco de dados de clientes

Para baixar o banco de dados de clientes como arquivo, vá para:\
**Clientes → Filtro → Baixar**

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

{% hint style="danger" %}

#### **Atenção**

* A exportação suporta até **100.000 clientes** por arquivo CSV ao incluir todas as variáveis.
* Para bancos de dados **que excedem 100.000 clientes**, divida a exportação em várias partes se você precisar de todas as variáveis do cliente.
* Na **.xls** formato de arquivo, apenas as **11 colunas principais** serão incluídas.
  {% endhint %}

O botão permite exportar sua lista de clientes em um formato padrão — **CSV** ou **XLS** — que pode ser aberto no Excel. O arquivo conterá as seguintes colunas:

1. **ID do cliente** (`client_id`)
2. **Nome do cliente**
3. **Mensageiro** usado pelo cliente
4. **Bot** o cliente contatou
5. **ID único do mensageiro** (por exemplo, número de telefone no WhatsApp)
6. **Dados da última ação**
7. **Data da última ação**
8. **URL do avatar do cliente**
9. **ID do bloco atual**
10. **Histórico de cliques** (blocos visitados)
11. **Tag**

{% hint style="info" %}
**Após essas 11 colunas, variáveis personalizadas serão incluídas — mas somente no formato de arquivo .CSV.**
{% endhint %}

Você também pode exportar clientes de uma lista específica. Para fazer isso, clique no botão **Exportar clientes** no **Listas** seção.

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

## cartão do cliente

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

O cartão do cliente mostra detalhes principais do cliente:

* **Avatar**
* **Ícone do mensageiro** o cliente usou
* **Nome do cliente**
* **Status do cliente** (por exemplo, *bloqueado* / *pausado*)
* **Funcionário atribuído**

– Vinculado a você → mostra **"Seu cliente"**\
– Vinculado a outro funcionário → mostra o e-mail ou nome dele\
– Não atribuído → nenhum rótulo mostrado

* **Horário da última atividade**
* **Indicador da última mensagem** (um dos seguintes):

— **Cliente** — última mensagem enviada pelo cliente\
– **Você** — última mensagem enviada por você\
– **E-mail do funcionário** — última mensagem enviada por outro funcionário\
– **Comentário** — a última mensagem é um comentário\
– **Anexo** — a última mensagem contém um anexo

* **Ícone de cliente fixado**, se o cliente estiver fixado

{% hint style="info" %}
Para abrir um chat, clique no cartão do cliente.
{% endhint %}

### Menu de contexto

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

O menu de contexto do cartão do cliente inclui:

* **Marcar como não lido** – marca a conversa como não lida e move o cliente para **"Sem resposta"** .
* **Fixar/Desafixar conversa** – fixa o chat no topo da lista (acima de todos os outros) ou o desafixa.
* **Bloquear/Desbloquear** – bloqueia ou desbloqueia o cliente.
* **Excluir cliente** – remove permanentemente o cliente do banco de dados. **Esta ação não pode ser desfeita.**

Você pode personalizar a pré-visualização do cliente para mostrar as informações mais importantes para você.

Clicar em um cartão de cliente na lista principal abre o chat com esse cliente. No painel direito, você verá o perfil completo do cliente. Cada seção do cartão do cliente no painel direito é descrita em detalhes em [nosso guia](/doc/pt/crm/customers/helpdesk.md).&#x20;

Observe que o menu esquerdo exibe o **número de mensagens não lidas**.

Isso permite que você veja quantas mensagens estão aguardando sua atenção sem abrir o **Clientes** seção.

O que é mostrado depende da sua função no projeto:

* **Administradores** veem o número total de todas as mensagens não lidas no projeto.
* **Operadores** veem apenas mensagens não lidas de clientes atribuídos a eles.


---

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