Como apagar um pacote antigo no WHM sem travar as contas dos clientes
Um procedimento em quatro etapas para tirar um plano da tabela sem deixar conta apontando para um pacote que não existe, sem cota encolhida e sem limite ilimitado por engano.

Resposta curta: migre antes todas as contas que usam o pacote para o plano atual, conferindo disco e transferência de cada uma, confirme numa amostra que nenhuma ficou com limite indefinido e só então apague em WHM, Packages, Delete a Package, conforme a documentação do cPanel.
Neste artigo
- O que acontece com as contas quando o pacote some
- O que separar antes de tocar no pacote
- Como listar as contas que ainda usam o pacote
- Como migrar cada conta conferindo disco e transferência
- Como verificar numa amostra que nenhum limite ficou indefinido
- Quando apagar o pacote e o que conferir depois
- Checklist para reaproveitar em toda reorganização de planos
- Como explicar a mudança ao cliente
O que acontece com as contas quando o pacote some
Apagar um pacote no WHM é um clique: a documentação oficial do cPanel descreve a interface Delete a Package, em que você seleciona o pacote na lista e confirma a exclusão. O risco não está no clique. Está nas contas que ainda apontam para aquele pacote.
A documentação do cPanel cobre só a exclusão em si: a interface lista os pacotes e remove o selecionado. Ela não detalha o que acontece com as contas que ainda usam o pacote. O que segue é observação prática de operação, não comportamento documentado. Cada conta guarda os próprios limites (cota de disco, transferência, número de e-mails, bancos) no registro da conta, e o pacote serve de molde para criar ou alterar contas. Por isso a exclusão, por si, não costuma derrubar site. O problema aparece depois. A conta continua com a referência ao nome de um pacote que não existe mais, e o próximo upgrade, downgrade ou troca em lote fica sem molde para comparar. Além do risco de limite aplicado errado nessa hora, vem a pergunta do cliente: "por que meu plano aparece com um nome que vocês não vendem?".
A regra prática é simples: pacote só sai da lista quando nenhuma conta usa ele. O procedimento abaixo é fechado em quatro etapas e serve para qualquer reorganização de tabela de planos.
O que separar antes de tocar no pacote
Reserve uma janela curta, fora do horário comercial dos clientes mais sensíveis. Nenhuma etapa tira o site do ar por si, mas a troca de pacote pode reduzir limites. Cota de disco abaixo do uso real bloqueia gravação: upload no WordPress, atualização de plugin, geração de cache e recebimento de e-mail. Transferência do mês acima do novo limite pode suspender o site até a virada do ciclo ou até você ajustar o limite.
Tenha em mãos:
- O nome exato do pacote antigo, como aparece no WHM (revendedores costumam ter o prefixo do usuário, por exemplo
revenda_basico). - O nome do pacote de destino, já criado e revisado.
- Uma planilha simples com cinco colunas: conta, disco usado, transferência do mês, limite customizado atual, pacote novo. Ela vira o registro da mudança e a resposta pronta se algum cliente questionar.
Se você é revendedor sem acesso root, tudo se faz pela interface do WHM. Se tem root (servidor dedicado ou VPS), os comandos whmapi1 abaixo poupam tempo em lotes maiores.
Como listar as contas que ainda usam o pacote
Pela interface: WHM > Account Information > List Accounts, filtrando pelo pacote. Anote cada conta na planilha.
Com root, a mesma busca pela API:
whmapi1 listaccts searchtype=package search=revenda_basico
No resultado, cada conta traz os campos user, plan, disklimit e diskused. Se a lista voltar vazia, confira o nome do pacote antes de concluir que não há contas: um erro de grafia também devolve zero resultados.
Como migrar cada conta conferindo disco e transferência
Aqui mora o cuidado que a troca em lote às vezes pula. Antes de mover cada conta, compare o uso real com o limite do pacote de destino.
| Situação da conta | O que fazer |
|---|---|
| Disco usado abaixo da cota do pacote novo, com folga | Migrar direto |
| Disco usado próximo ou acima da cota nova | Escolher um pacote maior ou combinar limpeza com o cliente antes |
| Transferência do mês acima do limite novo | Migrar só depois de alinhar com o cliente, ou usar pacote com mais transferência |
| Conta com limite customizado (ajustado à mão) | Registrar o valor atual na planilha, porque a troca de pacote substitui o ajuste |
O uso de disco aparece em List Accounts. A transferência do mês fica em View Bandwidth Usage. Com root, o resumo de uma conta sai assim:
whmapi1 accountsummary user=cliente01
Confira diskused contra a cota do pacote novo. Depois, faça a troca em Account Functions > Upgrade/Downgrade an Account, ou pela API:
whmapi1 changepackage user=cliente01 pkg=revenda_profissional
Preencha a planilha conta a conta. Parece lento, mas é o que evita a ligação de segunda-feira com upload travado e e-mail parado porque a cota encolheu abaixo do que o cliente já ocupava, ou com o site suspenso porque a transferência nova ficou abaixo do consumo do mês.
Contas com limite ajustado à mão perdem o ajuste na troca
Se alguma conta tinha cota aumentada sem mexer no pacote, a troca aplica os limites do pacote novo e o ajuste anterior se perde. Por isso a última linha da tabela pede registro prévio. Depois da migração, reaplique o valor anotado, se ele ainda fizer sentido para aquele cliente.
Como verificar numa amostra que nenhum limite ficou indefinido
Terminada a migração, rode a busca da Etapa 1 de novo. Ela precisa voltar vazia. Em seguida, escolha algumas contas migradas, priorizando as maiores e as que tinham limite customizado, e confira três coisas em cada uma:
- O campo de pacote mostra o nome novo.
- A cota de disco mostra um valor definido, e não
unlimited, a menos que o pacote novo seja de fato ilimitado. - A transferência tem o limite que o pacote novo prevê.
Com root, o mesmo accountsummary da Etapa 2 mostra plan e disklimit de cada conta. Trate esta checagem como precaução, não como falha conhecida do changepackage. Os cenários em que unlimited costuma aparecer são previsíveis: o pacote de destino tem algum campo deixado em ilimitado (abra em Edit a Package e confira campo a campo antes da Etapa 2), ou alguém ajustou os limites da conta à mão depois da troca, sem passar pelo pacote. Se aparecer unlimited onde não deveria, corrija o pacote de destino se o problema estiver nele, aplique de novo o pacote na conta e confira outra vez. Limite indefinido é o tipo de erro que não reclama: o cliente cresce sem aviso até o disco do servidor ou da sua cota de revenda acabar.
Esta verificação é por amostragem e não substitui a busca vazia do início desta etapa. A busca garante que ninguém ficou no pacote antigo. A amostra confere se a troca aplicou o que você esperava.
Quando apagar o pacote e o que conferir depois
Só agora: WHM > Packages > Delete a Package, selecione o pacote e confirme, como descreve a documentação do cPanel. Depois, abra Edit a Package ou a lista de pacotes e confirme que ele não aparece mais.
Se você usa algum sistema de cobrança integrado ao WHM, revise os produtos que apontavam para o pacote apagado. Um produto ainda vinculado ao nome antigo vai falhar na próxima venda ou upgrade, e o erro só aparece quando um cliente tenta comprar.
Checklist para reaproveitar em toda reorganização de planos
Copie e use como padrão da agência:
- [ ] Nome exato do pacote antigo e do pacote de destino anotados
- [ ] Contas no pacote antigo listadas (interface ou
listaccts) - [ ] Disco usado e transferência do mês de cada conta registrados
- [ ] Contas com limite customizado identificadas e valores anotados na coluna "limite customizado atual"
- [ ] Cada conta migrada com destino compatível com o uso real
- [ ] Busca pelo pacote antigo retorna vazia
- [ ] Amostra conferida: pacote novo, cota definida, transferência correta
- [ ] Ajustes customizados reaplicados onde fazia sentido
- [ ] Pacote apagado e ausência confirmada na lista
- [ ] Produtos do sistema de cobrança revisados
Como explicar a mudança ao cliente
A maioria dos clientes não sabe o que é um pacote no WHM, e não precisa saber. O que ele quer é a garantia de que o site continua no ar e de que não vai pagar mais por isso. Uma frase que costuma resolver:
Se a migração reduziu algum limite (por exemplo, porque o plano antigo era generoso demais para o preço), avise antes, com o número na mão: quanto ele usa hoje e qual é o novo teto. A planilha da Etapa 2 já tem esses dados. Cliente avisado com número aceita a mudança. Cliente surpreendido por um erro de cota abre chamado irritado e pede desconto.
Referências
- Documentação oficial (cpanel) — Delete a Package (WHM). Consultado em 2026-10-14.