> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/painel.md).

# Painel

O **Painel de Atendimentos** é a visão de supervisão da operação: tickets agrupados por **usuário** ou por **fila**, com resumo em tempo real, transferência em lote, espionar conversa e (para admin) ações em massa.

Não confundir com o **Dashboard Executivo** (indicadores) nem com a tela **Atendimentos** (chat do dia a dia).

**Caminho:** menu lateral → **Painel** (Painel de Atendimentos)

Perfil típico: **admin** e **super** (menu de supervisão).

\[\[FOTO]]

***

### Resumo no topo

| Card          | O que mostra                                | Ao clicar                                |
| ------------- | ------------------------------------------- | ---------------------------------------- |
| Total Abertos | Tickets abertos (com atendente / não lidos) | Filtra as colunas só com os abertos      |
| Pendentes     | Aguardando na fila (inclui sem fila)        | Filtra as colunas só com os pendentes    |
| Total Tickets | Volume geral (inclui grupos)                | Filtra só os que têm mensagens não lidas |

Os três cards funcionam como **filtro rápido**: clique para aplicar, clique de novo no mesmo card para remover. Quando há algum filtro ativo, aparece uma etiqueta com a quantidade de tickets exibidos e um **x** para limpar tudo de uma vez.

Quando existem pendentes **sem fila**, o card Pendentes ganha uma marca laranja — é o indicador mais acionável da tela.

\[\[FOTO]]

***

### Barra de filtros do painel

Logo abaixo dos cards:

| Recurso                    | Função                                                                                                                                   |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Canal                      | Mostra só os tickets de um canal (WhatsApp, Telegram, SMS, Instagram…). A lista é montada com os canais que realmente aparecem no painel |
| Modo compacto              | Reduz a altura dos cards para caber mais tickets por coluna — útil em operação grande                                                    |
| Etiqueta de filtros ativos | Aparece quando há filtro aplicado; mostra quantos tickets restaram e limpa tudo ao ser removida                                          |

\[\[FOTO]]

***

### Ações do cabeçalho

| Ação                      | Quem usa         | Função                                                    |
| ------------------------- | ---------------- | --------------------------------------------------------- |
| Transferir entre usuários | Todos com acesso | Move atendimentos de um usuário para outro (mesmas filas) |
| Marcar todas como lidas   | Admin            | Zera não lidas em massa                                   |
| Fechar tickets em massa   | Admin            | Encerra vários tickets conforme filtros (irreversível)    |
| Filtros                   | Todos            | Período, filas, tipo de visão                             |

\[\[FOTO]]

***

### Filtros e tipos de visão

No painel de filtros:

| Campo                | Descrição                                              |
| -------------------- | ------------------------------------------------------ |
| Período              | Data inicial e final                                   |
| Visualizar todos     | Admin: todos do sistema / Super: todas as minhas filas |
| Filas                | Multiseleção (quando “ver todos” está desligado)       |
| Tipo de visualização | Como as colunas são montadas                           |

#### Tipos de visualização

| Visão                   | Organização                                  |
| ----------------------- | -------------------------------------------- |
| Por Usuário             | Uma coluna por atendente (+ coluna Pendente) |
| Por Usuário (Sintético) | Visão sintética por usuário                  |
| Por Filas               | Uma coluna por fila (+ Sem Fila)             |
| Por Filas (Sintético)   | Visão sintética por fila                     |

\[\[FOTO]]

***

### Colunas e tickets

Cada coluna lista os tickets do grupo (usuário ou fila), com contadores de abertos/pendentes/total.

Há scroll infinito por coluna e opção de **carregar todos** os restantes da coluna.

#### Conversar sem sair do painel

**Clique no card do ticket** para abrir a conversa numa janela sobre o painel:

* **Ticket em atendimento** — abre com o campo de mensagem: você lê, responde (texto, emoji, anexo, áudio) e fecha, sem perder a visão geral.
* **Ticket pendente** — abre em modo **espiar**, só leitura. Para responder, use **Assumir atendimento** dentro da própria janela; o campo de mensagem aparece na sequência.

A janela abre posicionada na **primeira mensagem não lida** (destacada por alguns segundos) e acompanha a conversa em tempo real: o que você envia e o que o cliente responde aparecem na hora.

> Quando o ticket está com o robô e o tenant exige senha para espiar, ela continua sendo pedida antes de abrir.

#### Botões do card

| Ícone                | Ação                                                   |
| -------------------- | ------------------------------------------------------ |
| Balão de conversa    | Abre a conversa em janela (o mesmo que clicar no card) |
| Transferir           | Transfere o ticket para outra fila                     |
| Resolver             | Encerra o atendimento direto do painel                 |
| Abrir no Atendimento | Sai do painel e abre o ticket na tela de Atendimento   |
| Fixar                | Fixa o ticket no topo da coluna                        |

O tempo decorrido no card muda de cor conforme o atendimento envelhece (verde → amarelo → vermelho), ajudando a achar o atrasado sem ler item por item.

#### Coluna Sem Fila

Na visão por filas, a coluna **Sem Fila** tem atalho para **transferir todos** esses tickets para uma fila e usuário destino.

\[\[FOTO]]

***

### Transferências pelo Painel

#### Entre usuários

1. Clique no ícone de transferência no cabeçalho.
2. Selecione **usuário de origem** e **usuário destino**.
3. Confirme.

Atenção: os usuários devem ter acesso às **mesmas filas**.

#### Tickets sem fila

1. Na coluna Sem Fila, clique em transferir.
2. Escolha **fila destino** e **usuário destino**.
3. Confirme.

\[\[FOTO]]

***

### Fechar tickets em massa (admin)

1. Clique em **Fechar Tickets em Massa**.
2. Defina filtros (status, filas, usuários, conexões — opcionais).
3. Confira o resumo da quantidade que será fechada.
4. Confirme.

Ação **irreversível**.

\[\[FOTO]]

***

### Regras importantes

* Tela de supervisão; nem todos os perfis veem o menu.
* Super respeita as filas às quais tem acesso.
* Transferência entre usuários exige filas compatíveis.
* Fechamento e “marcar todas como lidas” são privilegiados (admin).
* Espiar permite acompanhar sem sair do painel.
* Responder pela janela do painel equivale a responder pela tela de Atendimento: a mensagem sai pela mesma conexão e entra no histórico do ticket.
* Filtros de canal, filtro rápido dos cards e modo compacto valem só para a sua visualização — não alteram nada para os outros usuários.

***

### Mensagens e erros comuns

| Situação                | Mensagem / comportamento                      |
| ----------------------- | --------------------------------------------- |
| Transferência ok        | Atendimentos transferidos com sucesso!        |
| Transferência falhou    | Problema ao realizar transferência            |
| Origem/destino vazios   | Selecione os usuários de origem e destino!    |
| Pendentes sem destino   | Selecione o usuário e a fila destino…         |
| Fechamento em massa     | tickets fechados com sucesso / erro ao fechar |
| Marcar lidas            | Todas as mensagens foram marcadas como lidas  |
| Carregar filas/usuários | Problema ao carregar filas / usuários         |

***

### Dicas de uso

* Use **Por Usuário** para equilibrar carga da equipe.
* Use **Por Filas** para ver gargalos de setor.
* Espie antes de intervir em um ticket crítico.
* Clique no card **Pendentes** para focar só na fila de espera e ir assumindo pela própria janela.
* Ligue o **modo compacto** quando o volume subir: cabe quase o dobro de tickets por coluna.
* Use o filtro por **Canal** quando um canal específico estiver acumulando (ex.: só SMS).
* Reserve fechamento em massa para limpeza controlada (ex.: fila antiga).
