Textos e idiomas

O widget usa alemão, inglês e polonês. Cada um dos cerca de 200 textos pode ser substituído: na conta para todas as páginas ou por código para páginas individuais.

Como o widget escolhe o idioma

O widget fica dentro da sua página. Por isso, o que o visitante está lendo no momento pesa mais do que a configuração do navegador. A ordem:

1. Um idioma que sua página escolheu para esse visitante por ReactiveChat('setLocale', …) (veja abaixo).
2. Um idioma fixo no código de incorporação (data-rc-locale) ou na configuração.
3. Caso contrário, o idioma da página em <html lang="…">.
4. Caso contrário, o idioma padrão da conta.
5. Caso contrário, o idioma do navegador e, por fim, inglês.

Códigos regionais são encurtados: de-AT vira de. Um idioma desconhecido pelo widget vira inglês.

Por isso, o mais importante é um <html lang> correto nas páginas. Assim, o widget acompanha sozinho cada versão de idioma do seu site.

O idioma padrão na conta

Em /app/projects/{id}, na aba Instalação, seção Dados básicos, você escolhe o Idioma padrão: de, en ou pl. Ele tem duas funções:

• Aplica-se aos visitantes de páginas sem <html lang> se o código de incorporação não definir um idioma.
• É o idioma em que você escreve seus textos próprios, a tela inicial e o card promocional (veja abaixo).

Definir o idioma por código

Fixo para uma página, no código de incorporação:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="pl"
        async></script>

Durante a execução, por exemplo, pelo seu próprio seletor de idiomas:

ReactiveChat('setLocale', 'en');

setLocale altera os textos do widget imediatamente. O widget lembra a escolha por um ano no navegador do visitante, e ela passa a ter prioridade sobre data-rc-locale em outras páginas também. Não há seletor de idiomas no próprio widget. Se os visitantes devem escolher, chame setLocale pelo seu seletor.

Textos próprios na conta

Na aba Textos e formulários, seção Textos próprios, cada texto do widget é listado com sua chave, agrupado por área e recolhido. Nosso texto aparece em cinza no campo. O que você informar o substitui. O título mostra quantos textos próprios você já tem.

• No máximo 400 caracteres por texto.
• Deixar vazio significa usar nosso texto.
• Um texto exatamente igual ao nosso não é salvo.
• O widget preenche marcadores entre chaves, como {n}, {name} ou {time}. Mantenha-os no texto se quiser exibir o valor.

Importante sobre o idioma: você digita os textos no idioma padrão do projeto, e é nele que entram em vigor. Visitantes cujo widget usa outro idioma continuam vendo nossos textos fornecidos. Para textos próprios em outros idiomas, use código (abaixo), de preferência nas páginas da respectiva versão de idioma.

As alterações chegam aos visitantes em até um minuto.

As chaves mais importantes

Um trecho da lista, por área:

• launcher.text, launcher.subtext – rótulo e segunda linha do botão do chat. Vazios por padrão; um valor tem prioridade sobre os campos em Aparência → Marca.
• launcher.label – rótulo do botão do chat lido por leitores de tela (“Abrir chat”).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time – título e segundas linhas do cabeçalho.
• home.greeting, home.sub, home.start, home.start_sub – saudação e ponto de entrada da tela inicial (é mais fácil definir a saudação em Tela inicial).
• tabs.home, tabs.messages, tabs.help – as abas.
• input.placeholder e outros input.* – o campo de entrada.
• offline.* – o formulário “Deixar uma mensagem”.
• prechat.* – o formulário pré-chat.
• bh.* – avisos sobre horário de atendimento.
• ds.* e daten.* – consentimento e o card “Seus dados”.
• msg.ki_notice – o aviso antes da primeira resposta do assistente de IA.
• csat.* – a avaliação após a conversa.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – conversa por e-mail, anexos, transferência para a equipe, fila, bolha de tooltip e mensagens de erro.

Você vê a lista completa na conta.

O aviso “Powered by reactive.chat” (veja Janela do chat) e os textos de tours do produto (veja Tours do produto) não podem ser alterados pelos textos.

Substituir textos por código

No código de incorporação, com data-rc-strings como JSON, chaves em notação de ponto:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        data-rc-strings='{"input.placeholder":"Your question about your order …","header.title":"Customer service"}'
        async></script>

Ou na configuração:

ReactiveChat('boot', {
  strings: { 'input.placeholder': 'Your question about your order …' }
});

Uma segunda chamada boot na mesma página carrega novos strings. Assim, você pode alterar textos após o login, por exemplo.

Textos definidos por código se aplicam da mesma forma em todos os idiomas. Portanto, defina-os em páginas de idioma fixo e defina também o idioma ali.

Ordem de precedência, da mais forte para a mais fraca:

1. Textos por código (strings) – valem apenas para a página em que estão.
2. Textos próprios da conta, no idioma padrão.
3. Nossos textos fornecidos no idioma do visitante.
4. Inglês.

O código tem prioridade de propósito: se quiser dar textos diferentes a uma página, faça isso nela, sem alterar a configuração de todas as outras.

Outros textos em outros lugares

Alguns textos têm um campo próprio, muitas vezes por idioma:

• Saudação, blocos e tela inicial: A tela inicial do chat
• Frase acima do formulário pré-chat (por idioma): Disponibilidade, formulários e atendimento
• Frase de consentimento e link da política de privacidade (por idioma): Privacidade e consentimento
• Textos de tooltips e mensagens proativas: Mensagens proativas
• Nome e tom do assistente de IA: Assistente de IA
• Card promocional, também por idioma no código: O card promocional no chat