A /chats é o painel onde toda a equipe atende clientes em WhatsApp, Instagram e Site num lugar só. Em vez de cada vendedor ficar pulando de aba — WhatsApp Web num canto, Instagram noutro, chat do site no celular —, tudo cai numa caixa unificada com sidebar de conversas, thread de mensagens central e painel lateral com dados do lead.
Esse artigo apresenta a visão geral da tela. Os outros artigos detalham cada operação específica.
Pré-requisitos
- Estar logado.
- Pelo menos 1 canal conectado (WhatsApp, Instagram ou widget de site).
Layout
A página /chats tem 3 áreas verticais:
Sidebar (esquerda — lista de conversas)
Largura ~320px. De cima pra baixo:
- Busca — campo de pesquisa por nome / telefone / assunto da conversa
- Tabs de canal:
- Geral (default) — mostra todas
- WhatsApp (verde) — só WA
- Instagram (rosa) — só IG
- Filtros:
- Todas (default)
- Para mim — só conversas atribuídas a você
- Abertas — só com status
open - Fechadas — só com status
closed - Lista de conversas ordenada por última atividade (mais recente no topo). Cada item mostra:
- Foto / avatar do contato
- Nome do contato
- Preview da última mensagem (com emoji 🎵 áudio, 🖼️ imagem, 📎 doc)
- Horário relativo ("agora", "há 2h", "ontem")
- Badge de não lidas (número à direita)
- Badge de canal (ícone WhatsApp/Instagram/Site)
Painel central (thread de mensagens)
Quando você clica numa conversa, aparece o histórico no centro:
- Header com nome do contato, status (🟢 Aberta / ⚫ Fechada), botões de ações.
- Thread de mensagens (scroll bidirecional pra ver histórico antigo).
- Bolhas verdes à direita = você (outbound).
- Bolhas brancas à esquerda = contato (inbound).
- Status de envio: ✓ enviada, ✓✓ entregue, ✓✓ azul = lida.
- Mensagens citadas aparecem com bloco cinza acima da bolha.
- Composer no rodapé pra enviar mensagem nova.
Painel lateral (direita — detalhes)
À direita da thread, painel com informações:
- Foto + nome do contato
- Telefone / username (clicável pra editar)
- Tags (pra organizar conversas)
- Lead vinculado (se houver) com link pro perfil + pipeline atual
- Atribuição — qual usuário tá responsável
- Departamento — qual setor cuida
- Agente IA — IA configurada pra responder (se houver)
- Fluxo de chatbot — se há flow ativo
Tempo real (real-time)
A caixa atualiza em tempo real via WebSocket (WebSocket):
- Mensagem nova chega → aparece na hora no chat aberto.
- Sidebar atualiza posição da conversa pra topo automaticamente.
- Outro vendedor responde → você vê a mensagem dele aparecendo.
Sem necessidade de F5 — todo mundo vê a operação ao vivo.
Multi-canal — cada canal mantém suas particularidades
Apesar da unificação visual, cada canal tem características próprias:
| Canal | Tipo de mídia | Particularidades |
|---|---|---|
| WhatsApp via QR Code | Texto / áudio / imagem / vídeo / documento / sticker | Sem janela 24h, suporta listas/botões |
| WhatsApp Cloud API | Idem | Janela 24h — fora dela, só templates HSM |
| Texto / áudio / imagem / vídeo / story mention | Recipiente é IG Business | |
| Site | Texto / mídia | Visitor anônimo até preencher dados |
Veja artigos específicos: WhatsApp, Instagram, Chatbot site.
Filtros e busca
Busca textual
- Digite no campo de busca: nome, telefone, palavra-chave da mensagem.
- A lista filtra em tempo real.
Filtro de canal (tabs)
- Geral: tudo.
- WhatsApp: só conversas WhatsApp.
- Instagram: só Instagram.
- (Site geralmente cai em Geral, sem tab dedicada)
Filtro de status
- Todas: abertas + fechadas
- Para mim: atribuídas a você
- Abertas: status
open - Fechadas: status
closed
Combine pra recortes específicos: "Minhas conversas WhatsApp abertas" = WhatsApp + Para mim + Abertas.
Conversas não-lidas
Conversas com mensagem nova não lida ficam:
- Negrito no nome
- Badge numérico à direita (quantidade de mensagens não lidas)
- No topo da sidebar automaticamente
Quando você abre a conversa, o unread_count zera automaticamente após 1-2 segundos de visualização.
Indicadores visuais
| Ícone | Significado |
|---|---|
| 🟢 | Conversa aberta |
| ⚫ | Conversa fechada |
| 🔴 | Janela 24h fechada (Cloud API) |
| 🤖 | Agente IA atendendo |
| 💬 | Chatbot atendendo |
| 👤 | Atendente humano |
| ✓ | Mensagem enviada |
| ✓✓ | Mensagem entregue |
| ✓✓ azul | Mensagem lida |
Ações rápidas no painel
No painel lateral / header da conversa, você tem botões de ação:
- Atribuir — escolhe atendente humano. Veja Atribuir conversa.
- Transferir setor — muda departamento. Veja Transferir conversa.
- Vincular lead — conecta a um lead existente ou cria novo. Veja Vincular lead.
- Fechar — marca como
closed. Veja Fechar conversa. - Excluir — remove conversa (cuidado).
Notificações
Quando uma conversa nova é atribuída a você, ou mensagem nova chega numa conversa atribuída a você:
- Sino no canto superior direito mostra notificação.
- Notificação do navegador (se você autorizou).
- Som (se ativado nas preferências).
- Push no celular (se PWA instalado).
Veja Preferências de notificação.
Polling fallback
Caso o WebSocket falhe ou desconecte (ex: rede instável), o sistema faz polling a cada 5 segundos pra garantir que você não perca mensagens. Isso é transparente pro usuário.
Histórico antigo
Pra ver mensagens mais antigas na thread:
- Role a thread pra cima.
- Quando chegar no topo, o sistema carrega mais mensagens automaticamente (lazy loading).
- Continue rolando até onde precisar.
Pra buscar texto específico dentro da conversa, use o navegador (Ctrl+F) ou contate suporte pra busca avançada via API.
Múltiplas conversas em janelas separadas
Você pode abrir várias conversas simultaneamente em abas do navegador:
- Cmd+Click (Ctrl+Click) na conversa abre numa nova aba.
- Cada aba mostra a conversa específica.
- Útil pra atendimento paralelo (responder 2 clientes ao mesmo tempo).
Modo "Para mim"
Pra quem atende muitas conversas, ative o filtro Para mim como padrão:
- Você só vê suas conversas.
- Sem distrações de conversas alheias.
- Fica fácil priorizar ações.
Próximos passos
- Pra entender quem vê o quê (regras de visibilidade), veja Permissões.
- Pra atribuir uma conversa, veja Atribuir conversa.
- Pra usar mensagens rápidas, veja Mensagens rápidas.