Procurar lead pelo nome no menu demora. Click em /contatos, espera carregar, filtra busca, clica no resultado. Pra resolver isso, Syncro tem Cmd+K (busca global) que abre em qualquer página e busca em leads, conversas e tarefas simultaneamente. Esse artigo cobre como usar.
Pré-requisitos
-Conta com dados (leads, conversas, ou tasks cadastrados). -Browser moderno.
Atalho
Em qualquer página:
-Mac: Cmd + K.
-Windows / Linux: Ctrl + K.
Modal abre instantaneamente com input no centro.
Como usar
1. Digite
Comece a digitar — busca executa a partir de 2 caracteres:
-Nome do lead. -E-mail do lead. -Telefone do lead. -Nome da empresa. -Subject de task. -Username Instagram.
2. Veja resultados
Resultados aparecem organizados em 3 categorias:
Leads (até 5)
Mostra: -Nome. -Telefone formatado. -E-mail. -Empresa. -Etapa do pipeline atual.
Conversas (até 5 WA + 3 IG)
Mostra: -Nome do contato (ou número/username). -Canal (badge: WhatsApp / Instagram). -Status (open/closed).
Tarefas (até 3)
Mostra: -Subject. -Tipo (call / email / task / etc). -Data de vencimento. -Status.
3. Navegue
-Setas ↑ ↓ percorrem resultados. -Enter abre o resultado focado. -Click abre direto. -Esc fecha o modal.
4. Resultado abre
Cada item tem URL específica:
| Tipo | URL |
|---|---|
| Lead | /contatos/{id}/perfil |
/chats?conversation={id} |
|
/chats?ig_conversation={id} |
|
| Task | /tarefas?task={id} |
Tempo de resposta
-Mínimo 2 caracteres. -Resposta em <500ms (cache + indexes otimizados). -Sem debouncing — cada keystroke dispara request.
Permissões e visibilidade
Resultados respeitam permissões do usuário logado:
-Admin: vê todos leads/conversas/tasks do tenant.
-Manager com can_see_all_conversations=true: vê tudo.
-Manager sem flag: vê do departamento + atribuídos.
-Viewer: vê apenas leads/tasks atribuídos.
Veja Permissões de visibilidade.
Limites por categoria
| Categoria | Limit |
|---|---|
| Leads | 5 |
| Conversas WhatsApp | 5 |
| Conversas Instagram | 3 |
| Tarefas | 3 |
| Total max | 16 resultados |
Se sua busca tem mais matches, sistema mostra os 5 mais relevantes. Pra ver todos, vá pra /contatos?search=X (lista completa).
Filtros aplicados automaticamente
Sistema NÃO mostra:
-Leads status='merged' (foram unificados).
-Conversas em departamento que você não acessa.
-Tarefas de outros tenants.
Casos práticos
Achar lead pelo telefone
Digito: "11999"
→ Lista todos leads com 11999 no telefone.
Buscar empresa específica
Digito: "acme"
→ Lista leads "Acme Corp", "Acme Industries", etc.
Encontrar task perdida
Digito: "ligação maria"
→ Mostra tasks "Ligação Maria Silva" + leads relacionados.
Ver conversa Instagram pelo @
Digito: "@joaosilva"
→ Achou conversa IG @joaosilva.
Diferença vs filtros das listagens
Busca global (Cmd+K)
- Multi-categoria (leads + conversas + tasks).
- Disponível em qualquer página.
- Limitado a 16 resultados totais.
- Sem filtros avançados.
Filtros das listagens
- Profundo (busca + filtros combinados).
- Paginação infinita.
- Filtros por status, etapa, data, tag, etc.
- Cada lista filtra só sua categoria.
Dica: Cmd+K pra achar rápido. Listas filtradas pra análise.
Atalhos úteis em conjunto
-Cmd+K → busca global.
-Cmd+K + digitar → resultados.
-Esc → fecha sem ação.
-Cmd+K em modal aberto → não funciona (Esc primeiro).
Personalizar (futuro)
Hoje sistema indexa leads, conversas, tasks. Não inclui:
- Produtos.
- Custom fields.
- Mensagens individuais (apenas conversas).
- Notas.
Roadmap: expandir cobertura de busca em versões futuras.
Performance
-Endpoint: GET /busca?q=termo.
-Cache: ~2-5min por tenant pra alta frequência.
-Indexes MySQL otimizados em name, email, phone, subject.
Volume de uso não derruba sistema. Use à vontade.
Acessibilidade
- Teclado completo (Cmd+K abre, ↑↓ navega, Enter confirma, Esc fecha).
- Screen readers com ARIA labels.
- Foco visível no resultado selecionado.
Erros comuns
"Cmd+K não funciona"
-Browser tem extensão capturando Cmd+K (ex: Vimium)? Desative. -Cursor está dentro de input? Saia (Esc) primeiro. -JS desabilitado? Habilite.
"Sem resultados mas tenho lead"
-Buscou termo menor que 2 chars.
-Sua role/departamento filtra esse lead.
-Lead foi mergeado (status='merged') — não aparece.
"Resultados antigos aparecem"
Cache. Aguarde alguns minutos ou faça Ctrl+F5.
"Resultado clicável mas não abre"
URL pode estar quebrada (lead/task deletado). Refresh a página atual.
Próximos passos
-Pra explorar a UI guiada, veja Tour interativo. -Pra dúvidas específicas, veja Como pedir ajuda.