# Chat do cliente

Clique em qualquer usuário na lista à esquerda na **Clientes** seção para abrir uma janela mostrando suas informações e histórico de chat.

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

O **Clientes** seção permite que você converse com usuários de vários mensageiros em uma interface unificada, eliminando a necessidade de alternar entre aplicativos.

## Dados e informações do cliente

O **card do cliente** na barra lateral direita exibe o perfil completo do cliente — desde detalhes padrão até variáveis personalizadas coletadas via bot, landing pages ou integrações de terceiros.

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

{% hint style="warning" %}

#### Observação

Todos os dados são fictícios; qualquer semelhança com pessoas reais é pura coincidência.
{% endhint %}

O cartão inclui várias subseções:

* **Sobre**
* **Comentários**
* **Negócios**
* **Tarefas**
* **Cursos**

### Sobre

Todo cartão de cliente contém campos de informação padrão e botões de ação para interação.

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

{% hint style="warning" %}

#### Observação

Todos os dados são fictícios; qualquer semelhança com pessoas reais é pura coincidência.
{% endhint %}

O cartão do cliente exibe a foto de perfil do mensageiro do cliente (se disponível) e o nome registrado no mensageiro (número de telefone, nome de usuário etc.).

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

Para alterar o nome do cliente, clique no ícone de lápis e digite o novo nome.

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

**ID do cliente** é o identificador exclusivo do cliente dentro do MaviBot. Este `client_id` é usado nas funções do MaviBot e muitas vezes é necessário para operações relacionadas ao cliente, como pesquisa, vinculação e outras ações.

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

Use a função **Transferir cliente** botão ou o **Proprietário** campo para atribuir um responsável ao cliente.

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

O cartão do cliente exibe a etapa atual do funil do cliente e permite movê-lo entre as etapas.

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

{% hint style="info" %}
Se o cliente não estiver vinculado a nenhum negócio ou funil, a etapa do negócio não será exibida.
{% endhint %}

Se você tiver vários funis, as etapas deles permanecerão ocultas até que você clique em um funil específico para alterar a etapa do cliente.

Você também pode adicionar tags ou atribuir o cliente a uma lista neste bloco. Tags e listas podem ser criadas diretamente no cartão do cliente:

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

<details>

<summary><strong>Como adicionar um cliente a uma lista ou atribuir uma tag</strong></summary>

Use a função **Sobre** aba para marcar o cliente ou adicioná-lo a listas existentes.

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

Para adicionar uma tag, clique na **"+ Tags"** botão. Na janela que se abre, digite o nome da tag no campo vazio e, se desejar, escolha uma cor para ela.

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

Adicione quantas tags forem necessárias e marque a caixa ao lado de cada uma para atribuí-la ao cliente.
\
Para editar ou excluir uma tag, clique no ícone de lápis e faça as alterações ou remova a tag na janela que se abre.

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

Mais tarde, você pode usar essas tags para filtrar clientes na pesquisa. Da mesma forma, você também pode criar listas de clientes:

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

Digite o nome da lista no campo obrigatório e, opcionalmente, selecione uma cor para ela. Em seguida, marque a lista desejada.

</details>

Há uma seção com variáveis e um editor de variáveis abaixo do cartão do cliente.\
Você pode adicionar uma variável a partir deste bloco selecionando o tipo de variável (variável do cliente ou variável do negócio) e especificando seu nome e valor.&#x20;

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

O cartão também contém variáveis do sistema. A documentação se concentrará exclusivamente nelas, pois o conjunto de variáveis que você pode definir no seu projeto será único.

{% hint style="info" %}
[Mais informações sobre variáveis são descritas aqui.](/doc/pt/chatbot/functions/variaveis.md#how-to-set-client-variables)
{% endhint %}

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

1. **Tag** — uma variável de rastreamento que mostra de onde o cliente veio. Saiba mais sobre tags [aqui](/doc/pt/websites/sites/builder.md).
2. **Data de criação** — a data e hora em que o cliente foi criado, mostradas no fuso horário do projeto.
3. **Última ação** — o carimbo de data/hora da atividade mais recente com este cliente.
4. **Origem** — o mensageiro que o cliente usou para entrar em contato com você.
5. **ID do mensageiro** — o identificador exclusivo do cliente dentro do mensageiro (`platform_id`). Usado para exportações, funções da API, pesquisa e outras operações.
6. **Vinculado a um bot** — o nome ou ID do bot ao qual o cliente está conectado.
7. **Posição no funil** — o número do bloco no diagrama de fluxo (Construtor de Funil) onde o cliente está localizado no momento.
8. **Proprietário** — o e-mail do funcionário atribuído ao cliente. Se estiver atribuído a você, mostra **"Seu cliente"**.

Se o cliente estiver em um bloco do funil com uma mensagem atrasada agendada, a variável **"Mensagens agendadas"** será exibida:

<details>

<summary>Mais sobre mensagens agendadas</summary>

Se você clicar no parâmetro, uma janela com a lista de mensagens agendadas será aberta.

A janela exibe:

* O número do bloco em que a mensagem está agendada
* O texto da mensagem ou o nome do bloco (se fornecido)
* A data e hora agendadas para envio

Você pode ajustar a data e a hora:

1. Selecionando uma nova data no calendário.
2. Inserindo um novo horário de envio.
3. Clicar em **"Confirmar"** .

{% hint style="info" %}
Se você não clicar **Confirmar** para salvar as alterações, a mensagem será enviada de acordo com o cronograma original.

Salve todas as alterações que você fizer para enviar mensagens corretamente.
{% endhint %}

Você pode:

* Enviar o bloco imediatamente (clique no **ícone de letra** botão).
* Cancelar o envio agendado (clique no **círculo riscado** botão).
* Deixá-lo inalterado (clique no **"X"** no canto superior direito).

</details>

10. **Links de proxy** — exibe o número de links de proxy associados ao cliente. Você pode abrir uma tabela desses links de proxy clicando nela.

### Comentários

A subseção "Comentário" permite que você deixe observações no chat do cliente, que ele não verá.

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

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

Isso é conveniente ao esclarecer a dúvida de um cliente ou quando vários operadores ou funcionários de diferentes departamentos colaboram no mesmo cliente.

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

Você também pode deixar um comentário clicando em **"Converter em comentário"** enquanto escreve uma mensagem.

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

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

O comentário exibirá seu criador e a data/hora. Você também pode excluir, editar ou fixar um comentário deixado no diálogo. Você pode selecionar uma ação no menu lateral.

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

### Negócios

A aba "Negócios" exibe todos os negócios do cliente, tanto os ativos quanto os já concluídos.

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

Um exemplo de negócio fechado com sucesso:

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

Se o negócio estiver encerrado, mas você precisar adicionar uma variável a ele, pode fazer isso clicando na linha ativa rotulada ***"+ Nova variável."***

Nesta aba, você pode criar um novo negócio para este cliente.\
Clique **"+ Criar um negócio"** e insira os detalhes no formulário de criação. Especifique o orçamento, defina todos os dados necessários e selecione o estado do funil para o negócio criado:

### Tarefas

A seção "Tarefas" ajudará você a atribuir uma tarefa a um funcionário responsável e não esquecer sua conclusão.

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

Você pode criar uma tarefa clicando no botão com o mesmo nome.&#x20;

Para criar uma tarefa, especifique o nome da tarefa, insira sua descrição e prioridade, e defina a data de conclusão:

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

Quando a tarefa for criada, ela será exibida na seção com sua descrição e datas de conclusão.

## Chat

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

A parte superior contém o nome do cliente, a hora da última atividade e o ID do mensageiro.

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

Botões e menu no bloco:

1. **Pausar o bot** — suspende o bot para este cliente por 24 horas ou reinicia o bot parado.
2. **Busca por palavras nas mensagens** — pesquisa no diálogo com base em palavras especificadas.
3. **Mostrar/ocultar o menu lateral** — oculta ou exibe o painel esquerdo da seção "Clientes".
4. **Marcar o diálogo como não lido** — marca a última mensagem do cliente como não lida.
5. **Desafixar diálogo / Fixar diálogo** — desafixa ou fixa o diálogo na lista de clientes. Diálogos fixados são sempre exibidos no topo da lista de clientes.
6. **Bloquear/desbloquear o cliente** — bloqueia ou desbloqueia o cliente.&#x20;
7. **Excluir um cliente** — remove um cliente do MaviBot.

A janela de diálogo exibe mensagens do cliente, mensagens dos gerentes e do bot, bem como notificações do sistema destacadas em amarelo (como callbacks e comentários que o cliente não pode ver)

Todas as mensagens contêm um menu de contexto. Mensagens normais podem ser fixadas ou excluídas

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

A mensagem fixada será exibida no topo, indicando o horário de envio. Você pode desafixar a mensagem clicando no botão "X".

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

Você pode reenviar uma mensagem ao cliente, com a opção de alterar o assunto da mensagem (para bots de e-mail) ao encaminhar, por exemplo, do Telegram para o e-mail.

Todos os funcionários, exceto operadores, podem excluir mensagens. Para limitar a capacidade de excluir mensagens, você pode configurar funções.

{% hint style="info" %}
Como trabalhar com funções é descrito no artigo "[Funcionários](/doc/pt/us/admin/funcionarios.md)."
{% endhint %}

## Formulário de envio de mensagens

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

***Campo principal*** — campo de entrada da mensagem para enviar ao cliente.\
Menu do formulário

1. ***Enviar emoji (carinha)*** abre um menu com a seleção de emoji; para adicionar um emoji à sua mensagem, basta clicar no ícone desejado.
2. ***Anexar arquivo*** - carregar um arquivo para enviar ao cliente. Abre um menu com a seleção do tipo de arquivo. Neste mesmo окно você também pode visualizar arquivos carregados anteriormente, seu tamanho, data de envio e nome. Arquivos desnecessários podem ser excluídos.

{% hint style="success" %}
Você pode carregar imagens da área de transferência simplesmente colando-as no campo principal de entrada da mensagem. Elas serão enviadas para o nosso serviço e ocuparão 1 dos 40 espaços
{% endhint %}

<mark style="color:laranja;">**No projeto pode haver**</mark><mark style="color:laranja;">**&#x20;**</mark>*<mark style="color:laranja;">**até 200 arquivos.**</mark>*<mark style="color:laranja;">**&#x20;**</mark><mark style="color:laranja;">**Depois de carregar 200 arquivos, para enviar um novo, você precisará excluir um dos arquivos antigos.**</mark>

3. ***Respostas rápidas*** - permite criar modelos de mensagens para enviar aos clientes. Também é possível criar pastas separadas para facilitar a busca e a categorização de mensagens prontas.

<div data-with-frame="true"><figure><img src="/files/0504bb4e1fe96bd979c8e9265852208433d23524" alt="" width="352"><figcaption></figcaption></figure></div>

Depois de clicar no botão (veja o exemplo acima), abrirá um pequeno formulário com o preenchimento do campo de nome da seção de respostas.

4. ***Enviar mensagem do funil***  - permite enviar uma mensagem ao cliente a partir de um bloco específico. Após o envio da mensagem, o cliente será redirecionado para o bloco selecionado, e suas ações futuras dependerão da cadeia subsequente na seção de funil. \
   Na janela que se abre para selecionar um bloco da seção de funil, é necessário escolher o bloco desejado. Os blocos podem ser filtrados por cor (tipo), encontrados por meio do formulário de pesquisa por descrição, ID ou resposta.
5. ***Converter em comentário*** - permite converter uma mensagem em comentário para preparar uma resposta mais completa ao cliente e comentar as ações do funcionário no diálogo.

{% hint style="info" %}
Falamos mais sobre como trabalhar com comentários acima na seção "[Comentários](#comments)"
{% endhint %}

6. **Ícone de temporizador** - ao clicar, abre-se um menu no qual você pode escolher o horário exato para enviar a mensagem. Para selecionar a data e a hora, clique no campo correspondente.
7. **Botão de envio de mensagem** — envia a mensagem digitada.&#x20;

Você pode enviar uma variável no formato #{nome\_da\_variavel}, e ela será entregue como o valor dessa variável. Há a possibilidade de alterar a altura do campo de entrada da mensagem; para isso, basta arrastar a parte superior do bloco em que o campo está localizado.

8. Gerar texto com IA — para gerar o texto da mensagem com ajuda da IA.

## Diferença entre o responsável pelo negócio e o responsável pelo cliente

No contexto de CRM e diálogos com clientes, o responsável pelo cliente e o responsável pelo negócio são duas funções diferentes, embora estejam intimamente relacionadas.&#x20;

1. **Responsável pelo cliente** normalmente é encarregado de estabelecer e manter o relacionamento com o cliente.&#x20;

No contexto dos diálogos com o cliente no MaviBot - **responsável pelo cliente** é o gerente (funcionário) do seu projeto que está atualmente conduzindo a conversa com o cliente na seção "Clientes".

Três maneiras de atribuir um responsável pelo cliente:

1. Clique em "Assumir cliente";
2. Clique em "Transferir cliente";
3. No campo "Responsável", selecione o funcionário.

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

2. **Responsável pelo negócio**, por sua vez, foca em uma etapa específica de vendas, por exemplo, no fechamento do contrato na etapa "Contato inicial" ou na execução do pedido.

Para ver os responsáveis pelos negócios dos clientes, vá para a aba "Negócios" no cartão do cliente.

Responsáveis pelo cliente e responsáveis pelo negócio podem ser funcionários diferentes do seu projeto.

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

Ou seja, um mesmo cliente pode ter diferentes gerentes e funcionários atribuídos, e em cada negócio individual — um funcionário responsável separado. Também é possível reatribuir o funcionário responsável pelo negócio quando o negócio é movido para diferentes estados do CRM.


---

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