logo
QR Codes•

Criar um QR Code em vários idiomas

Faça um QR Code em vários idiomas que abre a página no idioma do celular de cada pessoa. Configure regras de Idioma na CodeQR e veja os limites antes.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Um QR Code em vários idiomas é um único código impresso que abre a página no idioma de quem lê. O navegador do celular informa qual idioma prefere, em geral o do próprio celular. A CodeQR lê esse dado na hora da leitura e segue a regra que você escreveu para ele, usando regras de Idioma nas Regras inteligentes. Um hotel, um grupo de restaurantes ou um museu imprime um código só e mantém um conjunto de páginas por trás.

Disponibilidade

  • Plano: as Regras inteligentes ficam no Business ou superior (preços). Para testar, escolha Business em PLANO PARA TESTAR, na etapa de plano do onboarding, e clique em Iniciar Teste Grátis. O seletor começa em Pro, e cada workspace tem um teste.
  • Antes de imprimir: os códigos criados durante um teste sem cartão ficam nos domínios curtos gratuitos. Crie o código que vai para a impressão depois do checkout.
  • Códigos: QR Codes dinâmicos do tipo URL. Os links curtos têm a mesma seção. Um código estático não usa regras.

Como configurar

O exemplo é um cardápio. Quem tem o celular em inglês, espanhol ou francês recebe esse cardápio, e todos os outros recebem o cardápio em português. Se o seu código abre um cardápio, veja também QR Code para cardápio digital.

  1. Abra QR Codes e clique em Criar QR Code.
  2. Em Selecione o formato do QR Code, escolha Dinâmico e clique em Continuar.
  3. Em Selecione o tipo do QR, deixe URL.
  4. Em URL de destino, cole a página dos demais idiomas, por exemplo https://example.com/cardapio.
  5. Ative Regras inteligentes.
  6. Na primeira regra, escolha Idioma, é, English, e cole a página em inglês em URL de destino.
  7. Clique em Adicionar regra e repita para Español e Français.
  8. Clique em Criar QR Code.

Regras inteligentes com três regras: Idioma é English, Idioma é Español e Idioma é Français, cada uma apontando para a própria página de cardápio

A URL de destino é a página de todo mundo que não se encaixa em nenhuma regra, então coloque nela o idioma que a maioria dos seus visitantes lê.

Os dez idiomas

Uma regra de Idioma pode usar estes dez, com os nomes que aparecem na tela: Português, English, Español, Français, Deutsch, 中文, Русский, Italiano, 日本語 e 한국어. Os nomes são os mesmos em todos os idiomas da interface.

Quem usa o celular em qualquer outro idioma vai para a URL de destino.

O que observar

  • Portugal e Brasil contam como um idioma só: pt-BR e pt-PT valem como Português. Para mandar Brasil e Portugal para páginas diferentes, use uma regra de País.
  • O idioma do celular não é a localização da pessoa. Um turista alemão no saguão do seu hotel no Rio, com o celular em alemão, recebe a página em alemão do mesmo jeito. Para escolher pelo lugar onde a pessoa está, use País. Veja Redirecione visitantes por país, região, cidade ou idioma.
  • Crie uma regra para cada idioma que seus visitantes usam. O celular pode listar vários idiomas por ordem de preferência, e a CodeQR confere só o primeiro que ela aceita. Se o celular lista alemão em primeiro e francês em segundo, e você só tem regra para francês, a pessoa vai para a URL de destino. O francês nunca é tentado.
  • O código não traduz nada. Você precisa de um cardápio, um folheto ou uma página em cada idioma, e a regra aponta para ele.
  • As regras rodam de cima para baixo e vale a primeira que combinar. Um código aceita até 20 regras.

Faça o mesmo pela API

curl -X POST https://api.codeqr.io/qrcodes \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "static": false,
    "domain": "go.example.com",
    "key": "menu",
    "url": "https://example.com/cardapio",
    "rules": [
      { "attribute": "language", "operator": "equals", "value": "en", "url": "https://example.com/menu-en" },
      { "attribute": "language", "operator": "equals", "value": "es", "url": "https://example.com/menu-es" },
      { "attribute": "language", "operator": "equals", "value": "fr", "url": "https://example.com/menu-fr" }
    ]
  }'

No MCP, create_link e update_link aceitam rules. As ferramentas de QR Code não aceitam, então use a API ou o editor para um código.

Confira se funciona

Leia o código com um celular configurado em cada idioma. Para testar do computador, envie o cabeçalho que o celular envia e veja para onde o código redireciona:

curl -sI -H "Accept-Language: es-MX" https://go.example.com/menu | grep -i '^location'
# location: https://example.com/menu-es
curl -sI -H "Accept-Language: de-DE,fr;q=0.9" https://go.example.com/menu | grep -i '^location'
# location: https://example.com/cardapio

Na segunda chamada o alemão vem primeiro e não tem regra, então a pessoa vai para a URL de destino e o francês nunca é tentado. A aba URLs da Análise do código lista as leituras por página.

Perguntas frequentes

Ele lê o idioma que o navegador do celular pede, em geral o do próprio celular. A pessoa não escolhe nada. A CodeQR segue a regra daquele idioma e abre a página que você definiu para ele.

Artigos relacionados