O que é VTEX Intelligent Search?
VTEX Intelligent Search (ou VTEX IS) é o motor de busca nativo da VTEX IO baseado em machine learning, que substituiu o mecanismo de busca legado da plataforma. Ele é desenvolvido e mantido pela VTEX como parte do ecossistema VTEX IO.
O que diferencia o Intelligent Search da busca básica:
| Característica | Busca Básica | VTEX Intelligent Search |
|---|---|---|
| Matching | Somente palavras exatas | Semântico + variações |
| Erros de digitação | Sem tolerância | Tolerância automática (fuzzy matching) |
| Sinônimos | Manual no catálogo | Configurável no admin |
| Aprendizado | Nenhum | Aprende com cliques e conversões |
| Autocomplete | Não nativo | Nativo com sugestões inteligentes |
| Analytics de busca | Não | Dashboard completo |
| Zero results | Sem fallback | Termos alternativos e produtos similares |
Para um e-commerce, a busca interna é crítica: usuários que buscam convertem 3 a 5 vezes mais do que quem navega pelo catálogo. Uma busca ruim (com zero results ou resultados irrelevantes) desperdiça esse potencial.
Como funciona o VTEX Intelligent Search?
O motor opera em três camadas:
1. Indexação e enriquecimento de catálogo
O Intelligent Search indexa o catálogo da VTEX com todos os atributos de produto: nome, descrição, marca, categoria, especificações técnicas. Esse índice é atualizado automaticamente quando o catálogo muda.
O enriquecimento inclui:
- Stemming (reconhece variações morfológicas: "camiseta" e "camisetas")
- Normalização de acentuação ("café" e "cafe")
- Tokenização por idioma
2. Processamento de query
Quando um usuário digita na busca, o motor:
- Normaliza a query (remove acentos, converte para lowercase)
- Aplica fuzzy matching (corrige erros de digitação)
- Verifica sinônimos configurados
- Expande semanticamente a query
- Retorna resultados ranqueados por relevância
3. Ranqueamento e personalização
O ranqueamento combina:
- Relevância textual (match com atributos do produto)
- Dados de negócio (preço, disponibilidade, margem)
- Comportamento coletivo (produtos que geram mais cliques/conversões nessa query)
- Regras manuais configuradas pelo admin
Recursos do VTEX Intelligent Search
Autocomplete
Sugestões em tempo real enquanto o usuário digita — produtos, termos de busca populares e categorias. Configurável para priorizar determinados produtos ou excluir termos.
Impacto: autocomplete bem configurado reduz o tempo de busca e aumenta a taxa de clique. Usuários que clicam em sugestões de autocomplete convertem 20–30% mais.
Sinônimos
Permite mapear termos equivalentes para que a busca retorne resultados corretos mesmo com vocabulário diferente:
| Tipo | Exemplo |
|---|---|
| Unidirecional | "bermuda" → mostra resultados de "short" |
| Bidirecional | "notebook" ↔ "laptop" |
| Expansão | "tênis" → mostra "tênis", "calçado esportivo", "sneaker" |
Sinônimos são configurados no admin da VTEX em Intelligent Search > Sinônimos.
Redirects de busca
Quando um usuário busca um termo específico, redireciona para uma landing page em vez de exibir resultados de catálogo:
- "Black Friday" → página da campanha Black Friday
- "Frete grátis" → página de promoções com frete grátis
- "Lançamentos" → página de novidades
Regras de busca (Merchandising Rules)
Permitem influenciar os resultados para termos específicos:
- Boost: promove determinados produtos para o topo da busca
- Bury: empurra produtos para o final da lista
- Hide: oculta produtos específicos de determinada busca
- Fixed position: garante que um produto aparece em posição específica
Exemplo: para a busca "fone de ouvido", boostar o produto com maior margem que tem estoque.
Analytics de busca
O Intelligent Search tem um dashboard nativo com dados essenciais:
| Relatório | O que mostra |
|---|---|
| Termos mais buscados | Ranking das queries mais frequentes |
| Termos sem resultado | Queries que não retornam produtos |
| Termos com baixa conversão | Queries com resultados mas sem compra |
| Taxa de clique por query | CTR médio dos resultados |
O relatório de "termos sem resultado" é ouro: mostra exatamente o que seus clientes querem mas você não tem no catálogo — ou que você tem mas com nome diferente (oportunidade de sinônimo).
Como configurar o VTEX Intelligent Search
Passo 1: Instalar o app no VTEX IO
Se sua loja ainda usa a busca legada, instale o Intelligent Search via CLI:
vtex install vtex.search-resolver@1.x
vtex install vtex.search-result@3.x
Ou pelo painel em Apps > App Store > VTEX Intelligent Search.
Passo 2: Substituir os componentes de busca na vitrine
O Intelligent Search tem componentes próprios para o Store Framework:
search-bar: barra de busca com autocompletesearch-result-layout: página de resultadossearch-fetch-more/search-fetch-previous: paginação
Esses componentes precisam substituir os equivalentes da busca legada no store/blocks da sua loja.
Passo 3: Configurar sinônimos críticos
Identifique os principais termos de busca do seu segmento e mapeie sinônimos. Comece pelos:
- Termos com zero results no relatório de analytics
- Termos de gíria do seu público (ex.: "camiseta tumblr" = "camiseta estampada")
- Marca vs. categoria (ex.: "pampers" = "fralda")
- Estrangeirismos comuns (ex.: "legging" = "calça de academia")
Passo 4: Criar regras de merchandising para termos estratégicos
Para os 20-30 termos mais buscados da loja, configure regras de boost para:
- Produtos com maior margem
- Produtos em campanha ativa
- Produtos com melhor avaliação
- Novos lançamentos que precisam de visibilidade
Passo 5: Monitorar e ajustar
Analytics de busca deve ser revisado mensalmente. Os principais ajustes recorrentes:
- Novos sinônimos a partir de zero results
- Ajuste de regras de boost com base em conversão
- Identificação de oportunidades de catálogo (termos buscados sem produto correspondente)
VTEX Intelligent Search vs. Algolia: quando usar cada um?
| Critério | VTEX Intelligent Search | Algolia |
|---|---|---|
| Custo | Incluso no contrato VTEX | Pago por operação |
| Integração VTEX | Nativa | Via integração customizada |
| Personalização de UI | Limitada aos componentes VTEX | Total (headless) |
| Relevância | Boa para a maioria dos casos | Excelente, altamente configurável |
| Facetas/filtros | Nativas do catálogo VTEX | Configuráveis por campo |
| NLP avançado | Básico | Avançado (Query Suggestions, NeuralSearch) |
| Analytics | Dashboard VTEX | Analytics avançado separado |
Recomendação: para 80% das lojas VTEX, o Intelligent Search nativo é suficiente e bem mais simples de manter. Algolia faz sentido para lojas com necessidades muito específicas de UI de busca ou volume muito alto que justifique o custo adicional.
Erros comuns no VTEX Intelligent Search
Não configurar sinônimos nenhum
A maioria das instalações do Intelligent Search fica com a configuração padrão — sem sinônimos, sem regras, sem ajuste de relevância. O motor funciona, mas abaixo do potencial.
Ignorar o relatório de zero results
Esse relatório é revisto mensalmente em projetos bem geridos. Cada zero result é um cliente que foi embora sem encontrar o que queria.
Boost indiscriminado de produtos
Boostar produtos sem critério (ex.: boostar o produto mais barato independente de relevância) piora a experiência. O boost deve ser por relevância + negócio.
Autocomplete sem configuração
Autocomplete sem produtos em destaque ou com produtos errados (sem estoque, de baixa margem) desperdiça uma oportunidade de venda.
Perguntas frequentes sobre VTEX Intelligent Search
VTEX Intelligent Search é gratuito? Está incluso no contrato VTEX IO — não tem custo adicional além da plataforma.
Posso usar o Intelligent Search no VTEX Legacy? Não. O Intelligent Search é exclusivo para lojas em VTEX IO (Store Framework ou FastStore).
O Intelligent Search indexa atributos customizados? Sim. Especificações de produto cadastradas no catálogo VTEX são indexadas automaticamente e podem ser usadas como facetas (filtros) de busca.
Quanto tempo leva para os produtos aparecerem na busca após cadastro? A indexação é quase em tempo real — geralmente leva menos de 5 minutos para novos produtos ou atualizações aparecerem nos resultados de busca.
Como funciona a busca em lojas com múltiplos sellers (marketplace)? O Intelligent Search indexa produtos de todos os sellers ativos. É possível configurar filtros por seller e personalizar o ranqueamento para dar mais ou menos visibilidade a sellers específicos.
Próximos passos
- Veja como IA está transformando o e-commerce além da busca
- Entenda o impacto da busca interna na taxa de conversão do e-commerce
- Para implementar ou otimizar o VTEX Intelligent Search na sua loja, conheça os serviços de especialista VTEX e desenvolvedor VTEX