Ajuda & Documentação

Guia completo para usar o Visualizador de Conversas

Como Usar o Sistema

1. Acessar o Visualizador

Abra o arquivo index.html no seu navegador. As conversas serão carregadas automaticamente do arquivo JSON.

2. Entender o Dashboard

No topo da página você verá 5 cards com estatísticas:

  • Total de Conversas: Número total de conversas no arquivo
  • Com Preços: Conversas que mencionam valores e preços
  • Orçamentos: Conversas com solicitações de orçamento
  • Pedidos Fechados: Conversas com vendas confirmadas
  • Com Endereços: Conversas onde endereços foram compartilhados

3. Usar os Filtros

Logo abaixo das estatísticas, há botões para filtrar as conversas:

  • Todas: Mostra todas as conversas
  • Preços: Apenas conversas com discussões de valores
  • Orçamentos: Apenas conversas com orçamentos
  • Fechados: Apenas vendas confirmadas
  • Endereços: Apenas conversas com endereços

4. Buscar Conversas

Use o campo de busca para encontrar conversas específicas. A busca funciona em:

  • Nome do contato
  • Número de telefone
  • Conteúdo das mensagens

5. Expandir Conversas

Clique no cabeçalho de qualquer conversa para expandir e ver todas as mensagens completas.

Recursos Principais

Sistema de Cores

As conversas importantes são destacadas com bordas coloridas:

Verde - Preços

Conversa contém discussões de valores e pagamentos

Amarelo - Orçamentos

Conversa contém solicitações de orçamento

Vermelho - Fechados

Conversa contém confirmação de pedido/venda

Azul - Endereços

Conversa contém informações de endereço

Destaque de Mensagens

Dentro de cada conversa, mensagens importantes recebem destaque visual:

  • Mensagens do cliente com informações importantes ficam com fundo amarelo
  • Mensagens do bot/agente com informações importantes ficam com fundo verde

Informações Exibidas

Para cada conversa você vê:

  • Nome do contato e avatar com inicial
  • Telefone do contato
  • Número de mensagens na conversa
  • Data da primeira mensagem
  • Badges indicando tipos de informação importante
  • Todas as mensagens com horários completos

Palavras-chave Detectadas

O sistema identifica conversas importantes procurando por estas palavras-chave:

Categoria Palavras-chave
💰 Preços preço, valor, custo, R$, reais, cobrar, pagar, quanto custa, quanto é, quanto fica, pagamento
📋 Orçamentos orçamento, cotação, proposta, orçar, estimativa, fazer um orçamento
✅ Fechados fechou, pedido, compra, venda, confirmado, aceito, ok pode fazer, vou comprar, quero comprar, fechar pedido, confirmo, pode fazer
📍 Endereços endereço, rua, avenida, av., CEP, bairro, cidade, número, n°, nº
Dica:

A busca é case-insensitive (não diferencia maiúsculas de minúsculas) e funciona com qualquer variação das palavras-chave.

Perguntas Frequentes

Como adicionar novas conversas?

Substitua o arquivo chatwoot_export.json por um novo export do Chatwoot e recarregue a página.

Posso modificar as palavras-chave detectadas?

Sim! Edite o arquivo js/app.js e localize o objeto keywords. Adicione ou remova palavras-chave conforme necessário.

O sistema funciona offline?

Sim, após carregar a página pela primeira vez. Os únicos recursos externos são as fontes do Google e os ícones do Font Awesome.

Quantas conversas o sistema suporta?

O sistema foi testado com arquivos de 8+ MB contendo centenas de conversas. O desempenho depende do seu navegador e hardware.

Como exportar conversas do Chatwoot?

No Chatwoot, vá em Relatórios → Exportar Conversas → Selecione o período → Download JSON.

Voltar ao Visualizador Página Inicial