{"section":"tutorials","requestedLocale":"pt","requestedSlug":"vtex-intelligent-search-configuracoes-multi-idioma","locale":"pt","slug":"vtex-intelligent-search-configuracoes-multi-idioma","path":"docs/pt/tutorials/intelligent-search/vtex-intelligent-search-configuracoes-multi-idioma.md","branch":"main","content":"O [VTEX Intelligent Search](/pt/docs/tracks/visao-geral-intelligent-search) é um aplicativo de busca inteligente para ecommerce que está disponível para lojas desenvolvidas usando o [VTEX IO](https://developers.vtex.com/docs/guides/store-framework). Para instalar e configurar o VTEX Intelligent Search na sua loja, leia o nosso guia [Search](https://developers.vtex.com/docs/guides/search-overview). A ferramenta exibe sugestões de busca e de produtos que possam interessar o usuário, além de corrigir erros ortográficos e entender palavras que não estão no cadastro do produto.\n\nO VTEX Intelligent Search Multi-idioma expande as funcionalidades do [Intelligent Search](/pt/docs/tracks/visao-geral-intelligent-search) e oferece uma experiência de pesquisa multi-idioma, ideal para lojas que realizam operações em diversos países. Esse recurso facilita a adaptação da loja para vários idiomas e garante a busca em todos os idiomas cadastrados.\n\n> ℹ️  Caso você deseje expandir o seu ecommerce para outro idioma, entre em contato com o [nosso Suporte](https://support.vtex.com/hc/pt-br/requests) para que o time da VTEX realize as configurações necessárias.\n\nCom o VTEX Intelligent Search Multi-idioma instalado, as informações do Catálogo da loja precisam ser traduzidas para que possam ser exibidas em cada idioma configurado. A abordagem depende da versão da API do Intelligent Search utilizada pela loja:\n\n- **[Intelligent Search API v1](https://developers.vtex.com/docs/api-reference/intelligent-search-api-v1)**: as traduções são obtidas nativamente pela API do [Catalog multi-language](https://developers.vtex.com/docs/guides/catalog-multi-language-integration-guide), então não é necessário usar o Messages.\n- **[Intelligent Search API (Legacy)](https://developers.vtex.com/docs/api-reference/intelligent-search-api)**: o conteúdo do catálogo ainda precisa ser traduzido pelo **[Messages](https://developers.vtex.com/vtex-developer-docs/docs/catalog-internationalization)**, uma abordagem baseada em GraphQL que utiliza o aplicativo `catalog-graphql`.\n\n> ⚠️ Essas duas abordagens não podem ser usadas ao mesmo tempo. Depois que o Catalog multi-language for ativado na sua conta, não será mais possível gerenciar as traduções do Catálogo pelo Messages (GraphQL).\n\nOs campos disponíveis para tradução são diferentes entre as duas abordagens:\n\n| Entidade | Campos no Catalog multi-language | Campos no Messages (legado) |\n| --- | --- | --- |\n| Produtos | Name, Title, Description, MetaTagDescription, DescriptionShort, Keywords, LinkId | Nome, palavras-chave, título da página, descrição, descrição curta, meta tag description, URL slug (somente lojas cross-border) |\n| Categorias | Name, Title, Description, Keywords, LinkId | Nome, palavras-chave, título da página, meta tag description, URL slug (somente lojas cross-border) |\n| Marcas | Name, Text, Keywords, SiteTitle, LinkId | Nome, palavras-chave, título da página, meta tag description, URL slug (somente lojas cross-border) |\n| SKUs | Name, MeasurementUnit | Nome |\n| Especificações | Name, Description | Nome, descrição e valores |\n| Valores de especificação | Name | Incluído em Especificações |\n| Grupos de especificação | Name | Não suportado |\n| Coleções | Name, Description, LinkId | Não suportado |\n| Serviços | Name, Text | Não suportado |\n\nLeia os guias para desenvolvedores [Catalog multi-language](https://developers.vtex.com/docs/guides/catalog-multi-language-integration-guide) e [Tradução do conteúdo do catálogo com o Messages](https://developers.vtex.com/vtex-developer-docs/docs/catalog-internationalization) para mais informações.\n\nO VTEX Intelligent Search Multi-idioma obtém todos os locais e respectivos idiomas (exemplos: `pt-br`, `en-uk`) configurados na loja. Cada local possui a sua própria URL.\n\nAo navegar na loja, quando o cliente escolhe um idioma, ele é redirecionado para a URL do local desejado. A partir disso, todas as funcionalidades do Intelligent Search passam a funcionar no idioma escolhido, de acordo com as configurações estabelecidas pelo lojista.\n\nO VTEX Intelligent Search Multi-idioma permite que você personalize a experiência de busca para cada região, atribuindo as seguintes configurações de pesquisa a locais específicos:\n\n- [Regras de merchandising](#regras-de-merchandising)\n- [Sinônimos](#sinonimos)\n- [Redirecionamentos](#redirecionamentos) \n- [Banners](#banners) \n\n### Regras de merchandising\nCom o VTEX Intelligent Search Multi-idioma instalado, a página de edição ou criação de Regras de merchandising — encontrada no Admin VTEX em __Storefront__ > __Intelligent Search__ > __Regras de merchandising__ — apresenta o campo adicional __Idiomas__, que possibilita escolher a quais idiomas a Regra de Merchandising será aplicada através da seleção dos idiomas desejados, conforme mostrado na figura abaixo.\n\n![img regrasmerch intelligentsearchmultilanguage PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/intelligent-search/vtex-intelligent-search-configuracoes-multi-idioma_1.png)\n\nPara saber mais sobre os campos, leia nosso artigo sobre [como configurar Regras de merchandising no VTEX Intelligent Search](/pt/docs/tutorials/criar-regra-de-merchandising-editor-manual).\n\n### Sinônimos\nExistem duas formas de configurar Sinônimos em uma loja multi-idioma no Admin: preencher um formulário ou importar um arquivo `.csv`.\n\n> ⚠️  Configurações criadas ou alteradas em **Sinônimos** podem levar até 2 horas para serem aplicadas na loja. \n\n#### Criar Sinônimos via formulário\nCom o VTEX Intelligent Search Multi-idioma instalado, a página de edição ou criação de Sinônimos — encontrada no Admin VTEX em __Storefront__ > __Intelligent Search__ > __Sinônimos__ — apresenta o campo adicional __Idiomas__, que possibilita escolher a quais idiomas os Sinônimos cadastrados serão aplicados, conforme a imagem abaixo. Clique nos idiomas desejados para selecioná-los.\n\n![img sinonimos intelligentsearchmultilanguage PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/intelligent-search/vtex-intelligent-search-configuracoes-multi-idioma_2.png)\n\nPara saber mais sobre os campos, leia nosso artigo sobre [como configurar Sinônimos no VTEX Intelligent Search](/pt/docs/tutorials/criar-sinonimos).\n\n#### Importar planilha de Sinônimos\n\nCaso prefira fazer a importação de Sinônimos para idiomas específicos por arquivo `.csv`, você deve criar um arquivo `.csv` no formato __Unidirecional__ ou __Bidirecional__, de acordo com o [efeito desejado para o sinônimo](/pt/docs/tutorials/criar-sinonimos), e inserir o novo campo `<locales separados por vírgula>`:\n\n- __Unidirecional__: `<Termos separados por vírgula>;<Termos expandidos separados por vírgula>;<status>;<locales separados por vírgula>`\n   - Exemplo: `smartphone;iphone;true;en-GB`: ao pesquisar por `smartphone` na loja no idioma inglês (`locale en-GB`), os resultados para `iphone` irão aparecer. Contudo, ao pesquisar por `iphone`, os resultados para `smartphone` não irão aparecer.\n\n- __Bidirecional__: `<Termos separados por vírgula>;<status>;<locales separados por vírgula>`\n    - Exemplo: `tv,smart tv;true;en-GB`: ao pesquisar por qualquer um dos termos na loja no idioma inglês (`locale en-GB`), qualquer produto que contenha um desses termos irá aparecer nos resultados da busca.\n\n> ⚠️  Se o arquivo .csv importado não apresentar a coluna `locale`, o sinônimo será válido para todos os idiomas disponíveis na loja.\n\nPara saber mais sobre a importação de planilha de Sinônimos, leia nosso artigo sobre [como configurar Sinônimos no VTEX Intelligent Search](/pt/docs/tutorials/criar-sinonimos).\n\n### Redirecionamentos\n\nCom o VTEX Intelligent Search Multi-idioma instalado, a página de edição ou criação de Redirecionamentos — encontrada no Admin VTEX em __Storefront__ > __Intelligent Search__ > __Redirecionamentos__ — apresenta o campo adicional __Idiomas__, que possibilita escolher a quais idiomas os Redirecionamentos cadastrados serão aplicados, conforme a imagem abaixo. Clique nos idiomas desejados para selecioná-los.\n\n![img redirecionamentos intelligentsearchmultilanguage PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/intelligent-search/vtex-intelligent-search-configuracoes-multi-idioma_3.png)\n\nPara saber mais sobre os campos, leia nosso artigo sobre [como configurar Redirecionamentos no VTEX Intelligent Search](/pt/docs/tutorials/configurar-redirecionamentos).\n\n### Banners\n\nCom o VTEX Intelligent Search Multi-idioma instalado, a página de edição ou criação de Banners — encontrada no Admin VTEX em __Storefront__ > __Banners__ — apresenta o campo adicional __Idiomas__, que possibilita escolher a quais idiomas os Banners cadastrados serão aplicados, conforme a imagem abaixo. Clique nos idiomas desejados para selecioná-los.\n\n![img banner intelligentsearchmultilanguage PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/intelligent-search/vtex-intelligent-search-configuracoes-multi-idioma_4.png)\n\nPara saber mais sobre os campos, leia nosso artigo sobre [como configurar Banners no VTEX Intelligent Search](/pt/docs/tutorials/configurar-banners)."}