> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral de Conversas

A seção **Conversas** é o centro de comunicação do Evo CRM, onde você pode gerenciar todas as interações com seus clientes através dos diferentes canais de comunicação.

Nesta área, você pode visualizar, responder e gerenciar conversas de forma centralizada, independente do canal utilizado (WhatsApp, Email, Facebook, Instagram, Telegram, SMS, Website Widget ou API).

***

## Acessando Conversas

Para acessar a área de conversas:

1. No menu lateral esquerdo, clique em **Conversas**
2. A tela principal será exibida com a lista de todas as conversas ativas

***

## Interface Principal de Conversas

A tela de conversas é dividida em duas áreas principais: a lista de conversas à esquerda e a área de visualização da conversa selecionada à direita.

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/conversations/images/01-conversations-main.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=2c4a07c11dbc56698e4e67610c0d655a" alt="Tela inicial de conversas" width="1917" height="908" data-path="user-guides/conversations/images/01-conversations-main.png" />

### Estrutura da Interface

A interface principal apresenta:

#### Área de Lista de Conversas

A coluna da esquerda exibe todas as conversas disponíveis:

* **Barra de Pesquisa:** Campo no topo para buscar conversas específicas
* **Contador de Conversas:** Exibe o total de conversas encontradas (ex: "3 conversations")
* **Indicador de Filtros:** Mostra quantos filtros estão ativos (ex: "1 filter")
* **Botão Filters:** Permite aplicar e gerenciar filtros

Cada item da lista de conversas exibe:

* **Avatar do Contato:** Foto de perfil ou inicial do nome
* **Nome do Contato:** Nome completo do cliente
* **Canal de Comunicação:** Ícone indicando o canal (Telegram, WhatsApp, Email, etc.)
* **Timestamp:** Data e hora da última mensagem (ex: "Agora", "21 jan 1970")
* **Preview da Mensagem:** Última mensagem trocada na conversa
* **Indicadores de Status:** Ícones que indicam status da conversa ou canal

#### Área de Visualização da Conversa

A coluna da direita mostra a conversa selecionada:

* **Cabeçalho da Conversa:**
  * Nome do contato e canal (ex: "Davidson Gomes - Evolution API")
  * Identificador único (ex: "evoai-davidson")
  * Status da conversa (ex: "Status: Aberta" ou "Status: Pendente")
  * Botões de ação (menu de três pontos, fechar)

* **Histórico de Mensagens:**
  * Mensagens recebidas aparecem à esquerda
  * Mensagens enviadas aparecem à direita com nome do agente
  * Timestamps para cada mensagem
  * Indicadores de leitura/entrega

* **Área de Composição:**
  * Abas para **Reply** (Responder) e **Private Note** (Nota Privada)
  * Campo de texto para digitar mensagens
  * Ícones para anexos, emojis, menções e modelos de resposta rápida
  * Botão de envio

***

## Busca e Filtros

A barra de busca e os filtros são ferramentas essenciais para localizar conversas específicas rapidamente.

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/conversations/images/02-search-and-filters.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=33b2b85c56274925ed0da04c16c8b626" alt="Barra de pesquisa e filtros" width="767" height="405" data-path="user-guides/conversations/images/02-search-and-filters.png" />

### Barra de Pesquisa

No topo da lista de conversas, você encontra:

* **Campo de Busca:** Com placeholder "Search conversations..."
* **Ícone de Lupa:** Indica a funcionalidade de busca
* **Funcionalidade:** Permite buscar conversas por nome do contato, palavras-chave ou conteúdo das mensagens

**Como usar:**

1. Clique no campo de busca
2. Digite o nome do contato ou palavra-chave (ex: "Davidson Gomes")
3. A lista será filtrada automaticamente mostrando apenas conversas correspondentes
4. O contador será atualizado (ex: "1 conversation")

### Contador e Filtros

Abaixo da barra de busca:

* **Contador de Conversas:** Exibe o número total de conversas encontradas após aplicar busca e filtros
  * Exemplo: "1 conversation" ou "3 conversations"

* **Indicador de Filtros Ativos:** Mostra quantos filtros estão aplicados
  * Exemplo: "1 filter" indica que há um filtro ativo

* **Botão Filters:** Com ícone de funil, permite abrir o modal de configuração de filtros

### Lista de Conversas Filtrada

Quando busca ou filtros são aplicados, a lista exibe apenas as conversas correspondentes:

* **Avatar e Nome:** Foto de perfil e nome do contato
* **Ícone do Canal:** Pequeno ícone sobreposto ao avatar indicando o canal (ex: ícone azul de avião de papel para Telegram)
* **Timestamp:** "Agora" para conversas recentes ou data/hora específica
* **Preview da Mensagem:** Última mensagem trocada
* **Indicadores de Status:** Ícones que podem indicar:
  * Status da conversa (pendente, aberta, resolvida)
  * Horário comercial (ícone de relógio amarelo)
  * Prioridade ou outros estados

***

## Configurando Filtros de Conversas

O sistema permite aplicar múltiplos filtros para refinar a visualização das conversas.

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/conversations/images/04-filters-modal.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=e352c69adda57ae0bc45e5eed8452537" alt="Modal de filtros de conversas" width="732" height="722" data-path="user-guides/conversations/images/04-filters-modal.png" />

### Acessando o Modal de Filtros

Para abrir o modal de filtros:

1. Clique no botão **Filters** na parte superior da lista de conversas
2. O modal **Filter Conversations** será exibido

### Estrutura do Modal de Filtros

O modal apresenta:

#### Título e Descrição

* **Título:** "Filter Conversations"
* **Descrição:** "Configure filters to find the conversations you're looking for"
* **Botão de Fechar:** Ícone "X" no canto superior direito

#### Filtros Configurados

A área principal exibe os filtros já aplicados:

**Exemplo de Filtro Ativo:**

* **Campo 1 - Tipo de Filtro:** Dropdown com opções como "Status", "Agent", "Channel", "Labels", etc.
* **Campo 2 - Operador:** Dropdown com operadores como:
  * "Equal to" (Igual a)
  * "Not equal to" (Diferente de)
  * "Contains" (Contém)
  * "Does not contain" (Não contém)
* **Campo 3 - Valor:** Dropdown ou campo de texto com o valor específico (ex: "Pending")
* **Botão Remover:** Ícone "X" à direita para remover o filtro individual

**Exemplo prático:**

* **Filtro:** Status = Equal to = Pending
* **Resultado:** Mostra apenas conversas com status "Pendente"

#### Adicionar Novo Filtro

* **Botão "Add Filter":** Com ícone de "+" no centro do modal
* **Funcionalidade:** Permite adicionar múltiplos critérios de filtragem
* **Uso:** Clique para adicionar uma nova linha de filtro

#### Botões de Ação

Na parte inferior do modal:

* **Clear Filters:** Remove todos os filtros aplicados
* **Cancel:** Fecha o modal sem aplicar alterações
* **Apply Filters:** Botão verde que aplica os filtros configurados e atualiza a lista

### Tipos de Filtros Disponíveis

Os filtros podem ser aplicados por:

* **Status:** Pendente, Aberta, Resolvida, Fechada
* **Agente:** Filtrar por agente atribuído
* **Canal:** WhatsApp, Email, Telegram, Facebook, Instagram, SMS, API, Website Widget
* **Etiquetas (Labels):** Filtrar por etiquetas aplicadas
* **Data:** Período de criação ou última atualização
* **Prioridade:** Nível de prioridade da conversa

***

## Considerações Finais

* A interface de conversas foi projetada para navegação e interação intuitivas
* A busca permite localizar conversas rapidamente por nome ou conteúdo
* Os filtros ajudam a organizar e gerenciar grandes volumes de conversas
* A distinção entre respostas públicas e notas privadas é fundamental para comunicação interna da equipe
* Todas as mensagens são sincronizadas em tempo real entre todos os agentes
* O status da conversa pode ser alterado diretamente na interface
* Cada canal de comunicação possui ícones e indicadores específicos para fácil identificação


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.