# Limitar banda de um cliente na revenda: pacote e aviso em 80%

Onde deixar o padrão da revenda, o que o servidor faz quando a cota estoura, por que o site volta sozinho no dia 1 e o que fazer quando você não tem root. Com o e-mail pronto para o cliente final.

> a cota mensal de transferência pode ser definida em dois lugares no WHM, mas o padrão deve morar no pacote (banda mensal em MB) e a tela por conta serve para exceção e diagnóstico. O aviso mais próximo de 80% é outra configuração, em Tweak Settings.

João Rizzon · 2026-09-18 · Revenda

---

Quem administra uma revenda chega nesse ponto por um caminho previsível: cria as contas no WHM, migra o cliente, aprende a suspender manualmente. Depois um cliente publica um vídeo de 300 MB na home, o consumo do mês explode e ninguém foi avisado. A peça que fecha o ciclo é a cota mensal de transferência: onde ela se define, o que o servidor faz quando ela estoura e como o cliente é avisado antes do site sair do ar.

Este artigo é documental. Ele se apoia na documentação oficial do WHM/cPanel em [Limit Bandwidth Usage](https://docs.cpanel.net/whm/account-functions/limit-bandwidth-usage/) e em interfaces padrão do painel. Não há medição de laboratório aqui: onde o comportamento varia por versão do cPanel, eu digo que varia e mando você confirmar antes de prometer algo ao cliente final. Também aviso, em cada passo, quando o recurso exige root, porque boa parte das revendas não tem.

## O padrão mora no pacote, a exceção mora na conta

Existem dois lugares para definir quanto de transferência mensal uma conta pode consumir, e os dois são legítimos:

- **No pacote** (WHM » Packages » Add a Package / Edit a Package), no campo de banda mensal em MB. Vale para todas as contas criadas com aquele pacote.
- **Na conta** (WHM » Account Functions » Limit Bandwidth Usage), conta por conta, com o valor atual de uso à vista.

A diferença não é de esforço, é de manutenção. Se o padrão do plano vive no pacote, a cota é um atributo do produto que você vende: quando o plano muda, você mexe em um lugar. Se cada conta carrega o próprio número, cada edição é um caso particular que ninguém documenta e que você vai redescobrir seis meses depois, quando o cliente reclamar que o site do vizinho aguenta mais tráfego que o dele.

| Critério | Cota no pacote | Cota na conta |
|---|---|---||
| Alcance | Todas as contas do pacote | Uma conta |
| Quando usar | Padrão do plano que você vende | Exceção acordada e temporária |
| Risco | Quase nenhum, é o padrão | Drift: a conta deixa de refletir o plano |
| Onde fica registrado | No nome do pacote | Só na memória de quem editou |
| Ao trocar o cliente de plano | Segue o novo pacote | Pode continuar com o valor antigo |

Regra prática de operação: **o padrão é definido no pacote; a tela de Limit Bandwidth Usage serve para diagnóstico e para exceção com data de validade.**

Se você já mexeu conta por conta no passado e não sabe mais qual conta está fora do padrão, faça uma auditoria antes de qualquer mudança. Com acesso root por SSH, o inventário sai em um comando:

```bash
# exige root no servidor; despeja o inventário de contas em JSON legível
whmapi1 listaccts --output=jsonpretty > /root/auditoria-contas.json
```

Se a sua revenda não tem root (o caso normal), você tem dois caminhos sem pedir nada ao provedor. O primeiro é a própria tela Limit Bandwidth Usage do seu WHM de revendedor, que já mostra uso e limite lado a lado para as contas que você administra. O segundo é gerar um token em WHM » Development » Manage API Tokens e chamar a mesma API por HTTPS da sua máquina: o token do usuário revendedor devolve apenas as contas da sua revenda.

```bash
curl -sH "Authorization: whm USUARIO_REVENDA:TOKEN" \
  "https://servidor.exemplo.com:2087/json-api/listaccts?api.version=1" | jq .
```

Na saída, compare para cada conta o pacote (`plan`) com o limite de banda. O nome exato do campo de banda muda entre versões do cPanel: abra o arquivo, confirme o campo na sua saída e só então monte a planilha. Não confie em um nome de campo que você leu em um blog, inclusive este.

## O que o servidor faz de fato quando a cota estoura

Aqui mora a maior parte da confusão. Estourar a cota **não** é a mesma coisa que a suspensão administrativa que você aplica em WHM » Suspend/Unsuspend an Account.

Quando a conta passa do limite mensal, o servidor aplica uma **suspensão de banda**: o acesso do visitante ao site para. Os arquivos continuam no disco, a conta não entra no estado de suspensão administrativa e o registro de uso continua sendo contabilizado. Para o visitante, o efeito é site fora do ar; para você, é um limite atingido, não uma punição manual.

Duas coisas que você precisa confirmar na sua versão antes de escrever no contrato ou no e-mail do cliente:

- **O que acontece com e-mail e FTP.** O contador de banda do cPanel agrega tráfego de vários serviços (web, e-mail, FTP), e o comportamento da suspensão sobre serviços que não são o site varia com a configuração do servidor. Teste em uma conta de laboratório sua antes de prometer que "o e-mail continua funcionando".
- **O que o visitante vê.** A página de erro apresentada depende da configuração do servidor web. Vale abrir no navegador e guardar o print, porque essa é a imagem que o cliente vai te mandar no WhatsApp.

O ponto que interessa para o seu discurso comercial: a cota de banda, sozinha, não gera aviso. Ela gera corte. O aviso é uma configuração separada, e é a próxima seção.

## Como definir a cota mensal no pacote do WHM

### Calibre o número pelo pico de consumo, não pela média

Abra WHM » Account Functions » Limit Bandwidth Usage. A interface lista as contas com o uso corrente ao lado do limite, o que faz dela o melhor lugar para calibrar um plano novo sem chutar. Complementarmente, o histórico mês a mês aparece no cPanel do cliente, na área de banda.

Escolha a cota olhando o pico dos últimos meses, não a média. Site com uma campanha por trimestre tem média baixa e pico alto; quem dimensiona pela média corta o cliente exatamente no mês em que ele está vendendo.

### Edite o pacote, não as contas uma a uma

Em WHM » Packages » Edit a Package, selecione o pacote e ajuste o campo de banda mensal, em MB. Se o plano é de transferência ilimitada, use a opção explícita de ilimitado em vez de digitar `0`: em várias telas do WHM o zero é interpretado como ilimitado, e essa ambiguidade é fonte garantida de erro de leitura na auditoria.

### Verifique se as contas existentes herdaram o novo limite

Esse é o passo que quase todo mundo pula. Dependendo da versão, editar o pacote pode não reescrever o limite das contas que já existem, e contas que já foram editadas manualmente tendem a manter o valor individual. Depois de salvar o pacote, volte a Limit Bandwidth Usage e verifique duas ou três contas daquele plano. Se o valor antigo persistir, reaplique o pacote na conta por WHM » Upgrade/Downgrade an Account, selecionando o mesmo pacote.

### Anote a exceção com valor original e data de reversão

Cliente que pediu o dobro de banda por dois meses por causa de um lançamento é exceção legítima. Anote em algum lugar que você lê: conta, valor novo, valor original, data de reversão. Sem isso, a exceção vira padrão silencioso.

## Quando editar uma conta sozinha

Três casos justificam sair do pacote:

- **Emergência.** O site caiu por cota e o cliente precisa voltar agora. Aumentar o limite da conta em Limit Bandwidth Usage libera a suspensão de banda sem esperar a virada do mês. É o caminho mais rápido e é documentado.
- **Exceção contratada e datada.** Com data de reversão anotada.
- **Diagnóstico.** Você quer isolar uma conta específica enquanto investiga um consumo anômalo.

Fora desses três, editar conta por conta é dívida técnica. O sintoma aparece meses depois, quando duas contas do mesmo plano se comportam de forma diferente e ninguém sabe por quê.

## Ligar o aviso em 80% antes de o corte acontecer

A cota mensal e a notificação de aproximação da cota são configurações independentes. A cota fica no pacote ou na conta, e revendedor mexe nas duas. O aviso percentual fica nas configurações de notificação do servidor, em WHM » Server Configuration » Tweak Settings, na seção de notificações, onde existe a opção de enviar aviso quando o uso de banda atinge uma porcentagem do limite.

Tweak Settings é tela de root. Revenda não vê esse menu. Se é o seu caso, o pedido ao provedor do servidor cabe em duas linhas, e vale mandar por escrito com o valor que você quer:

> **** "Podem habilitar em Tweak Settings a notificação de uso de banda no percentual mais próximo de 80%, para as contas da minha revenda? Os endereços de contato das contas já estão preenchidos."

A lista de porcentagens disponíveis varia por versão do cPanel. Escolha o valor mais próximo de 80%. A razão é operacional, não teórica: 80% de uma cota mensal costuma acontecer com dias de sobra, o que dá tempo de o cliente responder, aprovar um upgrade ou tirar o vídeo de 300 MB da home. Aviso em 95% chega quando não há mais margem de negociação.

Dois cuidados que decidem se o aviso serve para alguma coisa, e esses dois estão na sua mão mesmo sem root:

- **Para quem o aviso vai.** A notificação vai para o endereço de contato da conta, definido no cPanel em Contact Information. Se lá está `admin@agencia.com.br` de todas as contas, você recebe tudo e o cliente não recebe nada. O campo de segundo endereço de contato existe justamente para esse arranjo: um endereço seu, um do cliente.
- **O endereço não pode estar no domínio hospedado naquela conta.** Se a conta tiver problema de entrega de e-mail, o aviso sobre o problema vai para dentro do problema. Use um endereço externo.

Padronize isso no momento da criação da conta, junto com a escolha do pacote. É um campo, leva dez segundos, e é a diferença entre "seu site caiu" e "avisamos há nove dias".

## Por que o site volta sozinho na virada do mês

O contador de banda do cPanel é mensal. Na virada do mês, o uso acumulado volta a zero, a conta deixa de estar acima do limite e a suspensão de banda é liberada.

Daí o chamado clássico de segunda-feira: o cliente reclama que o site ficou fora no sábado à noite, você abre o navegador na segunda e o site está no ar, ninguém tocou em nada. Não foi intermitência do servidor, não foi ataque, não foi plugin. Foi a cota, e a virada do calendário resolveu o sintoma sem resolver a causa.

| Sintoma | Causa provável | Onde confirmar |
|---|---|---||
| Site fora do ar no fim do mês, normal no dia 1 | Cota mensal estourada | Limit Bandwidth Usage: uso ao lado do limite |
| Cai todo mês na mesma semana | Cota dimensionada abaixo do consumo real | Histórico mensal de banda no cPanel da conta |
| Caiu um mês só, nunca mais | Pico isolado (campanha, arquivo grande, bot) | Estatísticas de acesso do site no período |
| Ninguém foi avisado antes | Aviso percentual desligado ou e-mail de contato errado | Contact Information da conta e, com root, Tweak Settings |

A liberação após a virada não é necessariamente instantânea à meia-noite do dia 1: ela depende da execução das tarefas agendadas do painel que revisam banda e suspensões. Se o cliente não pode esperar, aumente o limite da conta em Limit Bandwidth Usage, que é o caminho documentado para liberar na hora.

E feche o ciclo: se o site caiu por cota, o próximo mês vai cair também, a menos que a cota mude, o consumo mude ou o plano mude. Registre o evento no histórico do cliente com data, uso e limite. Esse registro é o que sustenta a conversa de upgrade sem parecer venda oportunista.

## O e-mail pronto para avisar o cliente em 80%

O aviso automático do servidor é técnico e vai assustar o cliente final. Vale mandar a sua própria versão, em português de gente, no mesmo dia em que o aviso de 80% chegar para você.

```text
Assunto: Aviso de consumo: seu site atingiu 80% da transferência do mês

Olá, [NOME],

O plano do seu site inclui uma cota mensal de transferência de dados,
que é o volume de páginas, imagens e arquivos entregues aos visitantes.
Neste mês, o consumo já chegou a 80% da cota.

O que isso significa na prática: se a cota for atingida antes do dia 1
do mês que vem, o site fica temporariamente indisponível para visitantes
até a virada do mês. Nenhum arquivo é perdido e nada é apagado.

Seu consumo atual: [USO] de [LIMITE] neste mês.

Temos dois caminhos e nós resolvemos qualquer um deles:

1. Reduzir o consumo: otimizar as imagens mais pesadas do site e mover
   arquivos grandes (vídeos, PDFs) para um serviço externo.
2. Ampliar a cota do plano, com efeito imediato.

Se você responder este e-mail até [DATA], conseguimos agir antes de
qualquer indisponibilidade.

Abraço,
[SEU NOME] | [AGÊNCIA]
```

Se o site já caiu, troque a frase central por esta, que explica sem jargão e sem culpa difusa: "o site atingiu a cota de transferência do mês e volta automaticamente na virada do mês; para colocá-lo no ar agora, ampliamos a cota em poucos minutos."

### Checklist para rodar em todas as contas da revenda

- **Cota no pacote.** Defina a banda mensal em MB em cada plano que você vende, com valor calibrado pelo pico e não pela média.
- **Auditoria.** Liste as contas e compare pacote com limite individual; reaplique o pacote via Upgrade/Downgrade an Account onde houver divergência.
- **Aviso.** Ligue o percentual mais próximo de 80% nas notificações do servidor, ou peça ao provedor se você não tem root.
- **Contatos.** Em cada conta, preencha o contato principal e o segundo contato, sempre com endereços fora do domínio hospedado naquela conta.
- **Teste em conta própria.** Baixe o limite para um valor pequeno, gere tráfego, confirme o que o visitante vê e se o aviso chega. Depois devolva o valor do pacote.
- **Snippet do e-mail.** Guarde o texto acima com os campos de uso, limite e data para preencher.
- **Registro de exceções.** Anote toda cota fora do padrão com data de reversão.

Os quatro primeiros itens (cota no pacote, auditoria, aviso e contatos) são de uma tarde e não voltam. O teste em conta própria é o único que dá trabalho, e é o que evita você descobrir o comportamento real do servidor na frente do cliente.

O que está na fonte oficial: a interface Limit Bandwidth Usage, o efeito de a conta atingir o limite mensal e a elevação do limite como forma de liberar o acesso sem esperar a virada do mês, tudo em [Limit Bandwidth Usage](https://docs.cpanel.net/whm/account-functions/limit-bandwidth-usage/). O que essa página não cobre e você precisa confirmar no seu próprio WHM: a lista de porcentagens disponíveis para o aviso em Tweak Settings, o alcance da suspensão de banda sobre e-mail e FTP na sua configuração e a página de erro que o visitante vê. Confirme os três antes de transformar qualquer um deles em promessa contratual.

