O CHAT - SPX agora permite que você pesquise mensagens específicas dentro da conversa aberta, facilitando a localização rápida de informações importantes sem precisar rolar manualmente por todo o histórico. Esta funcionalidade melhora significativamente a produtividade dos agentes ao permitir buscar termos, frases ou palavras-chave diretamente na conversa ativa.
Como Funciona
Pesquisa Contextual e Inteligente
A pesquisa interna funciona de forma inteligente e contextual:
• Busca Específica na Conversa: Pesquisa apenas nas mensagens da conversa atualmente aberta, não em todo o sistema
• Resultados em Tempo Real: Conforme você digita, os resultados são filtrados dinamicamente
• Busca Parcial: Não precisa digitar a palavra exata - a busca encontra termos parciais (ex: "baca" encontra "bacana")
• Case-Insensitive: Não diferencia maiúsculas de minúsculas (ex: "BOA TARDE" encontra "boa tarde")
Localização
O botão de pesquisa aparece no cabeçalho da conversa, ao lado das informações do contato, facilitando o acesso rápido sempre que necessário.
Exemplo Visual
Abaixo você pode ver como funciona a pesquisa:
Botão de pesquisa localizado no cabeçalho da conversa
Modal exibindo resultados da pesquisa com navegação
Funcionalidade
Interface de Pesquisa
Ao clicar no botão de pesquisa (ícone de lupa), um modal é aberto com:
-
Campo de Busca: Digite qualquer termo que deseja encontrar na conversa
-
Lista de Resultados: Exibe todas as mensagens que contêm o termo pesquisado
-
Informações de Contexto: Cada resultado mostra o remetente, timestamp e conteúdo da mensagem
-
Navegação Direta: Clique em qualquer resultado para navegar diretamente até aquela mensagem na conversa
Navegação Intuitiva
Ao usar a pesquisa, o sistema:
-
Filtra em Tempo Real: Conforme você digita, os resultados são atualizados instantaneamente
-
Destaca Resultados: Mostra claramente quais mensagens contêm o termo pesquisado
-
Navegação Direta: Ao clicar em um resultado, o modal fecha e a conversa rola automaticamente até a mensagem encontrada
-
Preserva Contexto: A conversa permanece aberta, permitindo ver o contexto completo da mensagem
Comportamento Inteligente
• Busca Parcial: Encontra termos parciais dentro das palavras (ex: "serv" encontra "servidores", "servidor", "servir")
• Múltiplos Resultados: Exibe todos os resultados ordenados por data (mais recentes primeiro)
• Timestamp em Português: Mostra "há cerca de 3 horas" ao invés de "about 3 hours ago"
• Sem Resultados: Exibe mensagem clara quando nenhuma mensagem contém o termo pesquisado
Acesso ao Recurso
Disponibilidade
A pesquisa interna está disponível em:
✅ Todas as Conversas: Funciona em qualquer conversa aberta
✅ Todos os Layouts: Disponível tanto no layout expandido quanto condensado
✅ Todos os Tipos de Inbox: WhatsApp, Email, Web Widget, etc.
✅ Mensagens de Entrada e Saída: Pesquisa em mensagens do contato e do agente
Como Acessar
-
Abra qualquer conversa
-
Localize o ícone de lupa 🔍 no cabeçalho da conversa
-
Clique no ícone para abrir o modal de pesquisa
-
Digite o termo que deseja buscar
-
Clique em qualquer resultado para navegar até a mensagem
Interface e Design
Modal de Pesquisa
• Campo de Busca: Input limpo e focado automaticamente ao abrir
• Placeholder: "Pesquisar mensagens nesta conversa..." para orientar o usuário
• Lista de Resultados: Cards organizados com informações claras
• Scroll Infinito: Suporta muitos resultados sem sobrecarregar a interface
Cartões de Resultado
Cada resultado exibe:
• Avatar do Remetente: Foto do contato ou agente que enviou a mensagem
• Nome do Remetente: Identificação clara de quem enviou
• Timestamp: "há cerca de 3 horas" em português brasileiro
• Conteúdo da Mensagem: Prévia do texto com o termo pesquisado destacado
• Efeito Hover: Destaque visual ao passar o mouse indicando que é clicável
Estilo Visual
• Cores: Interface consistente com o tema do CHAT - SPX
• Espaçamento: Margem adequada entre resultados para melhor legibilidade
• Responsivo: Funciona bem em diferentes tamanhos de tela
• Feedback Visual: Estado de carregamento enquanto busca os resultados
Casos de Uso
Cenário 1: Localizar Informação Específica
-
Cliente mencionou um número de protocolo há 3 dias atrás
-
Conversa tem centenas de mensagens
-
Agente abre a pesquisa interna
-
Digita "protocolo" ou parte do número
-
Encontra a mensagem imediatamente
-
Clica no resultado e é levado diretamente até a mensagem
Cenário 2: Recuperar Compromisso Agendado
-
Agente precisa confirmar data combinada com cliente
-
Não lembra quando foi mencionada
-
Abre pesquisa e digita "23/12" ou "dezembro"
-
Sistema encontra todas as mensagens com essas referências
-
Agente localiza rapidamente a data agendada
-
Confirma informação com o cliente
Cenário 3: Encontrar Termo Técnico
-
Cliente mencionou problema com "nobreak" várias vezes
-
Agente precisa revisar todas as menções
-
Pesquisa por "nobreak"
-
Vê todos os contextos onde o termo foi usado
-
Navega entre os resultados para entender o histórico completo
-
Fornece resposta baseada em todas as menções anteriores
Cenário 4: Auditoria de Conversa
-
Supervisor precisa revisar o que foi prometido ao cliente
-
Conversa tem meses de histórico
-
Pesquisa por "prometido", "garantir", "comprometo"
-
Encontra todas as promessas feitas
-
Verifica se foram cumpridas
-
Toma ações necessárias baseado no histórico
Benefícios
Produtividade
• ⚡ Localização Instantânea: Encontre qualquer mensagem em segundos ao invés de minutos rolando manualmente
• 🎯 Precisão: Busca exata pelo termo desejado, sem depender de memória
• ⏱️ Economia de Tempo: Reduz drasticamente o tempo gasto procurando informações específicas
Experiência do Usuário
• 🔍 Busca Inteligente: Entende buscas parciais e ignora diferenças de maiúsculas/minúsculas
• 🌐 Interface em Português: Timestamps e mensagens totalmente em português brasileiro
• 👁️ Visibilidade Clara: Resultados organizados com contexto completo (quem, quando, o quê)
Qualidade do Atendimento
• 📝 Respostas Precisas: Acesse informações exatas compartilhadas anteriormente
• 🔄 Contexto Completo: Veja o contexto da mensagem ao navegar até ela
• ✅ Menos Erros: Não dependa de memória, confirme informações diretamente no histórico
Versatilidade
• 🔎 Pesquisa Ampla: Funciona com qualquer tipo de conteúdo de mensagem
• 📱 Responsivo: Funciona bem em desktop e dispositivos móveis
• 🚀 Rápido: Resultados aparecem instantaneamente conforme você digita
Diferencial: Pesquisa Global vs. Pesquisa Interna
Pesquisa Global (ícone de lupa na barra superior)
• Pesquisa em todas as conversas da conta
• Útil para encontrar conversas que mencionam um termo
• Resultados mostram conversas diferentes
• Use quando não sabe em qual conversa está a informação
Pesquisa Interna (ícone de lupa no cabeçalho da conversa)
• Pesquisa apenas na conversa atualmente aberta
• Útil para encontrar mensagens específicas dentro do histórico da conversa
• Resultados mostram mensagens individuais
• Use quando sabe que a informação está na conversa aberta
Ambas as funcionalidades são independentes e complementares!
Compatibilidade
Esta funcionalidade está disponível em:
✅ Todas as conversas individuais
✅ Todos os tipos de inbox (WhatsApp, Email, Web Widget, SMS, etc.)
✅ Layout Expandido e Condensado
✅ Todos os navegadores modernos (Chrome, Firefox, Safari, Edge)
✅ Dispositivos desktop e mobile
✅ Interface totalmente em português brasileiro
Notas Técnicas
Para Usuários
• A pesquisa interna NÃO afeta a pesquisa global do sistema
• Os resultados são atualizados em tempo real conforme você digita
• Não há limite de resultados - todas as mensagens correspondentes são exibidas
• A pesquisa funciona apenas em mensagens com conteúdo de texto
Para Administradores
• Funcionalidade habilitada por padrão para todos os usuários
• Não requer configuração adicional no painel administrativo
• Compatível com todas as versões de inbox e integrações
• Performance otimizada mesmo em conversas com milhares de mensagens
Para Desenvolvedores
• Implementação em Vue.js (Composition API com <script setup>)
• Componente principal: ConversationSearchModal.vue
• Store Vuex: conversationSearch module
• API Backend: SearchService com suporte a conversation_id
• Estilos usando Tailwind CSS
• Timestamps formatados com date-fns e locale ptBR
Atalhos de Teclado
Abrir Pesquisa
• Clique no ícone de lupa no cabeçalho da conversa
Dentro do Modal de Pesquisa
• ESC: Fecha o modal de pesquisa
• Enter: Navega até o primeiro resultado (se houver)
• Setas ↑/↓: Navega entre os resultados
Perguntas Frequentes
P: A pesquisa interna substitui a pesquisa global?
R: Não! São funcionalidades complementares. A pesquisa global busca em todas as conversas, enquanto a pesquisa interna busca apenas na conversa aberta.
P: Posso pesquisar em anexos ou imagens?
R: Atualmente a pesquisa funciona apenas no conteúdo de texto das mensagens.
P: A pesquisa diferencia maiúsculas de minúsculas?
R: Não! A pesquisa é case-insensitive, ou seja, "BOA TARDE" encontra "boa tarde", "Boa Tarde", etc.
P: Preciso digitar a palavra completa?
R: Não! A pesquisa encontra termos parciais. Digite "serv" para encontrar "servidores", "servidor", "servir", etc.
P: Quantos resultados são exibidos?
R: Todos os resultados que correspondem à sua busca são exibidos, ordenados do mais recente para o mais antigo.
P: A pesquisa funciona em conversas arquivadas?
R: Sim! Funciona em qualquer conversa que você tenha aberto, incluindo arquivadas.
Suporte
Se você tiver dúvidas sobre esta funcionalidade ou encontrar algum problema:
• Entre em contato com nossa equipe de suporte através da Central de Ajuda
• Abra um ticket de suporte descrevendo o problema encontrado
• Verifique se está usando a versão mais recente do CHAT - SPX
• Certifique-se de que a conversa está totalmente carregada antes de pesquisar