Idiomas do widget para a web — 50 out of the box.

Visão geral — o que significa "compatível"

Um idioma é lançado no Widget Web quando todas as strings visíveis ao usuário na interface do chat têm uma tradução revisada por um falante nativo. Isso inclui o texto de espaço reservado do campo de mensagem, a dica de ferramenta do botão de envio, os banners de status da conexão, os botões de resposta rápida e todas as notificações de erro. Se uma string não puder ser traduzida por um equivalente direto (expressões idiomáticas ou formulações específicas de uma cultura), a etapa de revisão produz uma reformulação adequada à localidade em vez de recorrer ao inglês.

A lista desta página é a tabela real usada em tempo de execução — o carregador do widget inclui esses códigos e busca o pacote correspondente na primeira renderização.

Visão geral da cobertura

Como o idioma do visitante é detectado

A detecção é executada uma vez, quando o widget é montado, e seleciona a primeira correspondência nesta ordem:

1. Substituição explícita. Se a sua página definir window.Knocket.locale = 'ja' antes de o widget ser carregado, essa configuração prevalece. Consulte Substituir no código.
2. Atributo HTML lang. Se <html lang="fr"> estiver presente, o widget o adotará. Esta é a opção mais simples para sites multilíngues — defina-o no servidor para cada página.
3. Localidade do navegador. Como alternativa, usa navigator.languages[0]. As variantes regionais são reduzidas ao idioma-base (por exemplo, pt-BR → pt).
4. Inglês. Se nenhuma das opções acima corresponder a um pacote disponibilizado, o widget permanecerá em inglês em vez de ficar parcialmente traduzido.

A lista completa — 50 languages

Classificado pelo número global de falantes. Cada linha representa um pacote de idioma disponível; a coluna de código contém a string exata esperada pelo widget.

Substituir no código

Se você já souber o idioma preferido do visitante (pelo estado do seu aplicativo, por uma configuração da conta ou por um parâmetro da URL), informe-o explicitamente ao widget:

<script>
  window.Knocket = window.Knocket || {};
  window.Knocket.locale = 'ja'; // must be set before the loader script
</script>
<script src="https://cdn.knocket.ai/w.js" async></script>

Ou, depois que o widget for montado, altere-o em tempo real:

Knocket('setLocale', 'zh-Hans');

O widget renderiza novamente cada string, inverte a direção para idiomas RTL e mantém a conversa atual intacta.

Comportamento de contingência

Dois casos extremos que vale a pena destacar:

• Localidade não disponibilizada. Se você inserir um código desconhecido (por exemplo, xx ou uma variante regional pouco comum), o widget retorna silenciosamente ao inglês e registra a falha nas análises do console.
• Alternativa regional. Os códigos regionais são reduzidos ao respetivo idioma base quando não é disponibilizado um pacote regional. pt-BR → pt, en-GB → en. O chinês simplificado e o tradicional têm pacotes separados (zh-Hans e zh-Hant) — não os trate como equivalentes.