# Deixar cPanel e webmail em português em toda a revenda

Como aplicar pt_br em lote pelo WHM, deixar o Roundcube abrindo em português e responder ao cliente que reclama das mensagens que continuam em inglês.

> padronize pelo WHM em vez de ajustar conta por conta: defina `locale=pt_br` como padrão em Tweak Settings e na criação de contas, aplique em lote nas antigas com `whmapi1 modifyacct` sobre uma lista revisada, e saiba que bounces do Exim e erros de PHP seguem em inglês por virem de fora do painel.

João Rizzon · 2026-10-14 · Revenda

---

## O que o locale da conta cPanel traduz e o que fica fora do alcance dele

No cPanel, idioma é um atributo da **conta**, não do navegador. Cada conta cPanel carrega um `locale` (no caso do português do Brasil, `pt_br`), e é ele que decide em que língua a interface aparece quando o cliente faz login. Trocar o idioma no rodapé do cPanel muda uma conta. Quem administra uma revenda com dezenas de clientes não quer fazer isso uma por uma, e nem quer que a conta criada amanhã nasça em inglês de novo.

O locale alcança a interface do cPanel, os nomes dos ícones, os assistentes e boa parte das mensagens geradas pelo próprio cPanel. Ele não alcança o texto que vem de fora: retorno do Exim, do Dovecot, do MySQL, do PHP e de plugins de terceiros continuam no idioma em que foram escritos. Isso não é falha de configuração, é limite de escopo, e é a parte que mais gera reclamação de cliente. Volto nela no fim.

A documentação oficial do recurso de idiomas no WHM está em [Configure Application Locales](https://docs.cpanel.net/whm/locales/configure-application-locales/), que é também onde se editam e se criam traduções customizadas.

## As duas frentes que fazem a conta nova já nascer em pt_br

Duas frentes, e vale cuidar das duas porque elas cobrem caminhos diferentes de criação de conta. Aviso de método: a documentação que citei acima cobre a edição de locales, não os caminhos de Tweak Settings nem os parâmetros da API de contas. O que vem abaixo é prática de operação, conferida no WHM e na saída do `whmapi1`, e os nomes de menu e de parâmetro mudam entre versões. Confira o que aparece na sua tela antes de automatizar.

### Onde fica o locale padrão do servidor no Tweak Settings

No WHM, em **Server Configuration » Tweak Settings**, busque por `locale` no campo de pesquisa da própria página. A opção de locale padrão define o idioma atribuído a contas criadas sem que o idioma seja informado explicitamente. Se o seu WHM não expuser essa opção (o conjunto de tweaks varia conforme versão e perfil do servidor, e em revenda você depende do que o provedor habilitou), siga pela frente seguinte, que funciona em qualquer caso.

### Passar locale=pt_br no formulário de criação e na API de billing

Ao criar conta em **Account Functions » Create a New Account**, o formulário tem o campo de locale. Deixe `Portuguese (Brazil)` selecionado. Se você cria contas por API ou por integração com o sistema de billing, passe o parâmetro explicitamente, que é mais confiável que depender de padrão global:

```bash
whmapi1 createacct user=exemplo domain=exemplo.com.br \
  plan=revenda_basico locale=pt_br
```

O valor `exemplo` acima é fictício, troque pelos seus. O que importa é o par `locale=pt_br`: com ele na chamada, nenhuma mudança futura de padrão global quebra o seu fluxo.

## Trocar o locale das contas antigas em lote com whmapi1 modifyacct

Para as contas antigas, o caminho manual é **WHM » Account Functions » Modify an Account**, trocar o locale e salvar. Para dezenas de contas, use a API. Vale a mesma ressalva: `modifyacct` com `locale=` é uso de operação, não procedimento transcrito da documentação citada; valide o retorno da chamada em vez de confiar no silêncio.

Primeiro liste e confira. Nunca rode o loop antes de ver a saída da listagem:

```bash
# 1. listar usuário, dono e locale atual das contas que você enxerga
whmapi1 --output=json listaccts \
  | jq -r '.data.acct[] | [.user, .owner, .locale] | @tsv'

# 2. filtrar pelo seu usuário de revenda e guardar em arquivo para revisar
whmapi1 --output=json listaccts \
  | jq -r '.data.acct[] | select(.owner=="seurevendedor") | select(.locale!="pt_br") | .user' \
  > contas-pt-br.txt

# 3. conferir o locale atual de uma conta específica
whmapi1 --output=json accountsummary user=exemplo | jq '.data.acct[0].locale'
```

O filtro importa por dois motivos. `listaccts` sem filtro devolve tudo que o seu usuário enxerga, não só o que é seu, e o laço grava `pt_br` em cima de quem talvez tenha escolhido outro idioma de propósito (cliente que prefere inglês, ou espanhol). Abra o `contas-pt-br.txt`, tire quem não deve entrar e só então rode o lote.

Confirmada a lista, aplique:

```bash
while read -r u; do
  [ -z "$u" ] && continue
  echo "== $u"
  whmapi1 --output=json modifyacct user="$u" locale=pt_br \
    | jq -r '.metadata.result, .metadata.reason'
done < contas-pt-br.txt | tee lote-locale-$(date +%F).log
```

O `jq` no fim imprime `1` e `OK` por conta: se aparecer `0` com uma razão, você tem o erro na tela em vez de um loop silencioso. Causas comuns de falha: conta suspensa, usuário fora da sua revenda e permissão de reseller sem o privilégio de modificar contas. Nesse último caso, só o administrador do servidor resolve.

Se você não tem acesso a shell no WHM, faça por **Modify an Account** mesmo, e priorize os clientes que mais abrem chamado.

## Webmail em português, e por que a caixa antiga continua em inglês

O webmail herda o locale da conta cPanel, então a troca acima já faz o Roundcube abrir em português para quem nunca mexeu na preferência. A pegadinha é o endereço de e-mail que já entrou no Roundcube alguma vez: o Roundcube guarda preferência por caixa postal, e a preferência salva vence o padrão da conta.

Para essas caixas, o próprio usuário resolve em **Roundcube » Configurações » Preferências » Interface de usuário » Idioma**, selecionando Português (Brasil) e salvando. Vale avisar o cliente de que a mudança é por caixa postal, não por domínio: trocar em `contato@` não troca em `financeiro@`.

Na interface jupiter, o seletor de idioma do cPanel fica no rodapé da página e no menu de usuário. É o caminho para o cliente que você não quer tirar do autoatendimento.

## Bounce, erro de PHP e string sem tradução: de onde vem cada mensagem em inglês

| Origem da mensagem | Segue o locale pt_br | Observação |
|---|---|---||
| Interface e ícones do cPanel | Sim | Traduzido pelo cPanel |
| Interface do Roundcube | Sim, salvo preferência salva na caixa | Preferência por caixa postal vence |
| Retorno de entrega do Exim (bounce) | Não | Texto do servidor de e-mail, em inglês |
| Erro de login do Dovecot | Não | Texto do servidor IMAP/POP |
| Erro de PHP, MySQL, WordPress plugin | Não | Vem da aplicação, não do painel |
| String nova do cPanel ainda sem tradução | Não | Cai no inglês de origem |

Esse último caso tem conserto, mas não na sua mão se você é revendedor: **WHM » Locales » Configure Application Locales** é área de administrador do servidor, acessível com WHM root. Em uma conta de reseller o item não aparece. Lá dá para editar as frases de um locale e cadastrar tradução própria para strings específicas, conforme a [documentação do cPanel](https://docs.cpanel.net/whm/locales/configure-application-locales/). Se a frase incomoda de verdade, o caminho é pedir ao provedor, mesmo caminho do Tweak Settings. E pese o custo antes de pedir: tradução customizada é manutenção sua a cada atualização. Na prática, só compensa para uma frase que aparece em tela que o seu cliente usa toda semana.

## Checklist para padronizar o idioma de toda a revenda

- Definir o locale padrão em Tweak Settings, se a opção existir no seu WHM.
- Passar `locale=pt_br` na criação de conta, no WHM e na integração de billing.
- Gerar a lista filtrada, revisar o arquivo e rodar o laço de `modifyacct` guardando a saída em log.
- Reconferir uma amostra por `accountsummary` depois do lote.
- Abrir o webmail de uma caixa antiga e de uma caixa nova, para ver a diferença entre preferência salva e padrão herdado.
- Incluir no e-mail de boas-vindas ao cliente a instrução de trocar o idioma do Roundcube por caixa postal.
- Repetir o lote de `modifyacct` quando migrar contas de outro servidor, porque a migração traz o locale de origem.

Vale uma observação contra o meu próprio interesse: se o cliente reclama de "painel em inglês" mas o que ele vê em inglês é bounce de e-mail, nenhuma configuração de painel resolve. Leia a mensagem antes de mexer no locale.

## A resposta pronta para o cliente que reclama de mensagem em inglês

Use esta, ou uma variação dela, quando vier a reclamação de mensagem em inglês depois da troca:

> **** O painel e o webmail da sua conta já estão em português. Algumas mensagens continuam em inglês porque não são geradas pelo painel: elas vêm do servidor de e-mail ou do próprio site (WordPress, PHP, banco de dados), que respondem no idioma em que foram programados. Não é erro de configuração e não afeta o funcionamento. Se uma dessas mensagens aparecer com frequência, me mande o texto que eu traduzo e explico o que ela significa.

A última linha é a que fecha o assunto de verdade: o cliente não quer tradução, quer entender o que está acontecendo. Resolver o significado da mensagem encerra o chamado melhor do que traduzir a mensagem.

