blog
Revenda

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.

JR · · 7 min de leitura · 1 tabela · 3 blocos de código

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
  1. O que acontece com as contas quando o pacote some
  2. O que separar antes de tocar no pacote
  3. Como listar as contas que ainda usam o pacote
  4. Como migrar cada conta conferindo disco e transferência
  5. Como verificar numa amostra que nenhum limite ficou indefinido
  6. Quando apagar o pacote e o que conferir depois
  7. Checklist para reaproveitar em toda reorganização de planos
  8. 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.

Quatro etapas para retirar um pacote antigoListar contasBusca pelo pacote antigoMigrar contasDisco e transferência conferidos antesVerificar amostraPacote, cota e transferência corretosApagar pacoteSó com a busca vazia
Sequência de quatro etapas para tirar um pacote de circulação sem deixar conta órfã.

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:

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:

  1. O campo de pacote mostra o nome novo.
  2. A cota de disco mostra um valor definido, e não unlimited, a menos que o pacote novo seja de fato ilimitado.
  3. 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.

O que confirmar antes de apagar o pacoteBusca pelo pacote antigo vaziaAmostra com cota definidaAjustes customizados reaplicadosProdutos de cobrança revisadosApagar o pacoteSó quando os quatro pontos acima estiverem fei…
Confirmações que precedem a exclusão do pacote no WHM.

Checklist para reaproveitar em toda reorganização de planos

Copie e use como padrão da agência:

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

  1. Documentação oficial (cpanel) — Delete a Package (WHM). Consultado em 2026-10-14.
Leia também