Voltar para artigos
API PremifyIntermediarioAtualizado em 30 de out. de 2026

Idioma do participante e das mensagens

Como o idioma escolhido fica salvo no cadastro e o que a Premify traduz ou mantém em português

#api-premify#regras-de-negocio#campanha

O que e?

O hotsite e o painel funcionam em três idiomas: português do Brasil, espanhol latino-americano e inglês. O participante escolhe o idioma no seletor do hotsite, e o operador, no painel.

A regra que organiza o resto: o idioma fica salvo na pessoa, no cadastro. Quem escolheu espanhol não precisa escolher de novo na segunda campanha do mesmo cliente nem num aparelho novo. E a tradução muda só o texto: nenhuma regra de negócio muda com o idioma, e nenhuma operação falha por causa dele.

Como funciona?

Onde o idioma fica guardado

O idioma é do cadastro do participante, que é único no cliente e serve todas as campanhas dele. No painel, é de cada usuário, então dois operadores do mesmo cliente podem trabalhar em idiomas diferentes.

Quem nunca escolheu fica sem idioma salvo, e o sistema trata como português. Esse "nunca escolheu" é diferente de "escolheu português", e é ele que permite a regra do login abaixo.

Quando o idioma é gravado

  • no cadastro: o idioma da tela vai junto e é gravado. Se vier um valor que não é um dos três, o cadastro não é recusado — o idioma só fica sem valor;
  • no login: se o cadastro nunca teve idioma, o idioma escolhido na tela de login é adotado e gravado. Se o cadastro já tem idioma, vale o que está salvo, e a escolha da tela é ignorada. Isso evita que uma escolha casual, ou o aparelho de outra pessoa, troque a preferência de quem já escolheu. Login que deu errado não grava nada;
  • na inscrição de quem já tem cadastro: segue a mesma regra do login — preenche quem nunca escolheu e não troca o de quem escolheu;
  • pelo seletor de idioma, já logado: troca o idioma salvo. Essa troca não passa pela conferência do formulário, da idade nem do estado: trocar de idioma nunca falha porque a campanha passou a exigir um campo novo.

O que sai traduzido

  • os textos das telas do hotsite e do painel;
  • as mensagens de recusa que a API devolve, como "nota já cadastrada" ou "senha incorreta". Elas saem no idioma da tela que fez o pedido. Só o texto muda: a recusa é a mesma, pelo mesmo motivo;
  • os textos prontos que telas de consulta recebem, como nomes de segmentos, indicadores e nomes de relatórios;
  • os e-mails escritos pelo sistema para o participante, como o de redefinição de senha, o assunto e os textos padrão do e-mail de resultado da apuração e o assunto padrão do convite. Esses saem no idioma salvo no cadastro de quem vai receber, e não no idioma de quem disparou. Sem idioma salvo, saem em português.

Um detalhe de segurança: a resposta da tela de "esqueci a senha" sai no idioma da tela, e não no do cadastro. Assim ela não revela se existe cadastro com aqueles dados. O e-mail do link, quando existe cadastro, sai no idioma salvo.

O que continua em português, de propósito

  • o conteúdo escrito pelo cliente: regulamento, textos da campanha, corpo do e-mail da apuração, assunto e corpo do convite escritos pelo operador. O sistema não traduz conteúdo; cada campanha tem o idioma em que o cliente escreveu;
  • as exportações em CSV: cabeçalhos e valores ficam sempre em português, mesmo com o painel em outro idioma;
  • a frase "Quero participar" que o membro manda no WhatsApp numa ação de comunidade: ela é um comando reconhecido pelo sistema, e traduzi-la faria a mensagem não ser entendida;
  • o formato de datas, números e valores, que não muda com o idioma.

Como explicar ao cliente?

A plataforma atende participantes em português, espanhol e inglês. Cada participante escolhe o idioma no próprio hotsite, e a escolha fica salva no cadastro dele — vale para as próximas campanhas e para outros aparelhos.

O ponto mais importante para alinhar: a Premify traduz o que ela escreve, não o que o cliente escreve. Telas, mensagens de erro e e-mails padrão do sistema saem no idioma do participante. Já o regulamento, os textos da campanha e os e-mails personalizados ficam no idioma em que o cliente os cadastrou. Uma campanha para público de outro país precisa ter esse conteúdo escrito no idioma desse público.

E as exportações do painel continuam em português, para não mudar o formato dos arquivos que o cliente já usa.

Possiveis falhas, causas e solucoes

  • Falha: o participante escolheu outro idioma na tela de login e o hotsite voltou para o idioma anterior depois de entrar.
  • Possivel causa: o cadastro dele já tinha um idioma salvo. No login, o idioma salvo prevalece sobre a escolha da tela.
  • Como orientar: oriente a trocar o idioma pelo seletor depois de entrar. Essa troca grava o idioma novo no cadastro.
  • Quando escalar: se a troca pelo seletor, já logado, não for mantida, abrir issue no Jira (projeto DEV) com as evidências.
  • Falha: o participante usa o hotsite em espanhol e o regulamento aparece em português.
  • Possivel causa: o regulamento é conteúdo do cliente, e o sistema não traduz conteúdo.
  • Como orientar: explique ao cliente que textos, regulamento e e-mails personalizados ficam no idioma em que foram escritos.
  • Quando escalar: não é falha.
  • Falha: o participante recebeu um e-mail do sistema em um idioma diferente do que ele está usando na tela.
  • Possivel causa: os e-mails do sistema seguem o idioma salvo no cadastro, e não o da tela aberta no momento. O participante pode ter navegado em outro idioma sem trocar a preferência salva.
  • Como orientar: oriente a escolher o idioma desejado pelo seletor, já logado. Os próximos e-mails seguem o idioma salvo.
  • Quando escalar: se o idioma salvo estiver correto e o e-mail continuar em outro idioma, abrir issue no Jira (projeto DEV) com as evidências.
  • Falha: o cliente exportou um relatório e as colunas vieram em português com o painel em inglês.
  • Possivel causa: as exportações em CSV ficam sempre em português, por decisão de produto.
  • Como orientar: explique que o formato do arquivo é fixo para não quebrar quem já o processa.
  • Quando escalar: não é falha.
  • Falha: uma mensagem de erro aparece em português com a tela em outro idioma.
  • Possivel causa: a mensagem ainda não tem tradução e caiu no português, que é o padrão.
  • Como orientar: registre o texto exato, a tela e o idioma selecionado.
  • Quando escalar: abrir issue no Jira (projeto DEV) com o print e o texto da mensagem.

Exemplo de resposta pronta

Olá! Você pode usar o site da promoção em português, espanhol ou inglês: basta escolher o idioma no seletor do site. Depois de entrar, a sua escolha fica salva no seu cadastro e vale também para as próximas promoções e para outros aparelhos, inclusive nos e-mails automáticos que enviamos. O regulamento e os textos da promoção são escritos pela marca e aparecem no idioma em que ela os publicou.

Quando escalar?

Abra issue no Jira (projeto DEV) com as evidências quando a troca de idioma pelo seletor, já logado, não for mantida, quando um e-mail do sistema sair em idioma diferente do salvo no cadastro, ou quando uma mensagem de tela ou de recusa aparecer sem tradução. Acione o time de desenvolvimento urgentemente se a escolha de idioma impedir um cadastro, um login ou o envio de nota, porque o idioma nunca deve recusar uma operação. Anexe o nome da campanha, o documento do participante, o idioma selecionado e prints da tela.

Artigos relacionados

API PremifyIntermediario
Regras do cadastro do participante

Idade razão social estado CEP aceite do regulamento e o que acontece quando o mesmo CPF se inscreve numa segunda campanha

#api-premify#regras-de-negocio#campanha
Atualizado em 30 de out. de 2026
Painel AdminBasico
Meu perfil com senha e idioma do painel

Como o usuário do painel edita o próprio nome e troca a senha e o idioma e como resolver o primeiro acesso

#painel-admin#campanhas#operacao
Atualizado em 30 de out. de 2026