Como avisar todos os clientes da revenda sobre manutenção
O disparo em massa do WHM resolve o envio, mas não corrige o endereço errado. Auditoria, correção, texto pronto e conferência na fila do Exim.

Resposta curta: antes de usar o Email All Users do WHM, faça 1 auditoria dos endereços de contato de todas as contas. Se o contato for uma caixa hospedada no servidor que vai cair, o cliente não lê o aviso nem recebe atualização durante a janela (prorrogação, conclusão), justamente quando precisa.
Neste artigo
- Por que o aviso chega e mesmo assim o cliente fica sem informação
- Como listar o e-mail de contato de todas as contas em um comando
- Como trocar o contato no WHM e o que pedir ao cliente
- Por que disparar pelo Email All Users e não pela caixa da agência
- Modelo de aviso que responde quando, quanto tempo, o que cai e o que fazer
- Como ler a fila e o log do Exim para saber quem não recebeu
- Como não refazer a auditoria na próxima manutenção
Por que o aviso chega e mesmo assim o cliente fica sem informação
O endereço de contato de uma conta cPanel costuma ser preenchido na criação da conta, e muita gente preenche com a própria caixa do domínio hospedado ali: [email protected]. Enquanto o servidor está no ar, funciona. No dia em que você derruba o servidor para manutenção, essa caixa cai junto. O aviso enviado dias antes até chegou, mas o cliente não tem webmail para reler a mensagem, não recebe a confirmação de conclusão e não recebe o aviso de prorrogação se a janela estourar.
O caso da fila do Exim existe, mas é outro: quando a comunicação precisa sair com o servidor já fora (queda não programada, janela que passou do previsto), a mensagem endereçada a uma caixa local entra na fila, tenta entregar e só é lida quando tudo já voltou. O aviso vira relatório.
Por isso a ordem correta é: auditar os endereços de contato, corrigir os que apontam para dentro do servidor e só então disparar. Inverter essa ordem é o erro mais comum.
Como listar o e-mail de contato de todas as contas em um comando
No WHM você consegue ver o contato conta a conta, mas isso não escala em uma carteira de dezenas de sites. Com acesso root, o jeito mais rápido é ler o arquivo de configuração de cada usuário.
# lista usuário e endereço de contato de todas as contas
grep -H '^CONTACTEMAIL' /var/cpanel/users/* | sed 's|/var/cpanel/users/||'
A saída sai no formato usuario:CONTACTEMAIL=endereco. Guarde em arquivo para comparar depois da correção:
grep -H '^CONTACTEMAIL' /var/cpanel/users/* \
| sed 's|/var/cpanel/users/||' > /root/contatos-antes.txt
Algumas contas têm também CONTACTEMAIL2 (endereço secundário). Vale olhar, porque é exatamente ali que às vezes existe um endereço externo já cadastrado e esquecido.
Como descobrir se o contato é uma caixa do próprio servidor
O teste é simples: o domínio do endereço de contato é um domínio hospedado nesse mesmo servidor? Se sim, o aviso de queda depende do que vai cair.
Para cruzar, use a lista de domínios do próprio servidor:
# domínios atendidos pelo servidor (principais, addon, parked e subdomínios)
cut -d: -f1 /etc/userdomains | sort -u > /root/dominios-locais.txt
Com os dois arquivos na mão, qualquer grep -f ou uma planilha resolve o cruzamento. Não precisa de script elaborado: a lista de uma revenda cabe na tela.
Cinco situações de contato e o risco de cada uma na janela
| Situação do contato | Risco no dia da manutenção | Ação |
|---|---|---|
| Caixa no domínio hospedado neste servidor | Alto: cliente não lê nada durante a janela | Trocar por endereço externo |
| Caixa em outro servidor seu (outra revenda/VPS) | Médio: depende de o outro servidor estar fora da janela | Verificar e documentar |
| Gmail, Outlook, provedor do cliente | Baixo | Manter |
| Endereço antigo de ex-funcionário do cliente | Alto: ninguém lê | Pedir atualização ao cliente |
| Campo vazio | Total: não existe destinatário | Preencher antes do disparo |
Como trocar o contato no WHM e o que pedir ao cliente
A correção oficial é por conta, em WHM >> Account Functions >> Modify an Account, no campo de e-mail de contato. Para poucas contas, é o caminho mais seguro.
Se a lista for grande, o atalho honesto é pedir o endereço ao cliente antes, não inventar um. Um e-mail curto resolve:
Essa frase evita a pergunta "mas por que não posso usar meu e-mail do site?", porque já entrega o motivo junto com o pedido.
Depois de corrigir, rode de novo o grep do contato e compare com /root/contatos-antes.txt. Conferir a mudança leva segundos e evita descobrir no dia que a edição não salvou.
Por que disparar pelo Email All Users e não pela caixa da agência
O WHM tem a função Email All Users, em Account Functions, feita exatamente para isso: enviar uma mensagem para os endereços de contato das contas do servidor. A documentação oficial do cPanel descreve a interface e as opções de destinatários.
Duas coisas importam para quem é revendedor:
- A interface não obriga a mandar para o servidor inteiro, e isso importa quando a manutenção afeta só parte das contas. Verifique na documentação e na sua própria tela quais filtros de destinatário a sua versão do WHM expõe antes de contar com um recorte específico.
- O envio usa o endereço de contato cadastrado na conta. É o mesmo campo que você acabou de auditar. Se o campo estiver vazio ou errado, a ferramenta não corrige nada por você.
Use a função também para o aviso de "manutenção concluída". O segundo e-mail custa um minuto e corta a maior parte das mensagens de "já voltou?".
Modelo de aviso que responde quando, quanto tempo, o que cai e o que fazer
Aviso de manutenção bom responde quatro perguntas: quando, por quanto tempo, o que para de funcionar e o que o cliente precisa fazer. Nada além disso.
Assunto: Manutenção programada no servidor do seu site - 12/11, 02h às 04h
Olá,
Na noite de terça para quarta, dia 12/11, entre 02h e 04h (horário de
Brasília), o servidor que hospeda o seu site passará por manutenção
programada.
O que pode acontecer nesse período:
- site fora do ar por alguns minutos;
- envio e recebimento de e-mails com atraso (nada é perdido: as mensagens
ficam em fila e são entregues depois);
- painel de controle e webmail indisponíveis.
O que você precisa fazer: nada. Não é necessário alterar senha, DNS ou
qualquer configuração.
Se depois das 04h o site ou o e-mail não voltarem, responda este e-mail
que verificamos.
[Sua agência]
A data e o horário acima são exemplo. Troque pelos seus e, se a janela envolve mudança de IP, acrescente uma linha avisando que a propagação de DNS pode levar algumas horas para quem usa DNS de terceiros.
Três coisas que não devem entrar no aviso ao cliente final
- Jargão de infraestrutura ("migração do pool de storage"). O cliente não decide nada com essa informação.
- Janela otimista demais. Se a manutenção pode levar duas horas, anuncie duas horas e termine antes.
- Pedido de ação sem necessidade. "Faça backup do seu site" assusta e gera chamado.
Como ler a fila e o log do Exim para saber quem não recebeu
Disparar não é entregar. Depois do envio, olhe a fila do Exim no servidor:
# quantidade de mensagens na fila
exim -bpc
# últimas mensagens da fila, com idade, tamanho, remetente e destinatário
exim -bp | tail -n 20
Se a fila cresceu e não desce, há entrega travada. Para ver o caminho de uma mensagem específica, pegue o ID que aparece no exim -bp e consulte o log:
exim -Mvl <ID_DA_MENSAGEM>
E para olhar o registro de entregas recentes de forma geral:
tail -n 100 /var/log/exim_mainlog
No log, => é entrega feita, == é adiamento (defer) e é falha definitiva (bounce). Procure os : são os contatos que você precisa corrigir antes da próxima manutenção. Anote esses usuários e volte ao passo de correção.
Calendário de D-7 a D+0 para sobrar tempo de tratar bounce
Se o aviso sai 20 minutos antes da janela, não sobra tempo para tratar bounce. O calendário mínimo que funciona:
| Quando | O quê |
|---|---|
| D-7 | Auditoria dos contatos e pedido de endereço externo aos clientes |
| D-5 | Correção dos contatos no WHM e reconferência da lista |
| D-3 | Disparo do aviso pelo WHM e leitura dos bounces no log do Exim |
| D-1 | Reenvio só para quem falhou, por outro canal |
| D+0 | Aviso de conclusão após a janela |
Como não refazer a auditoria na próxima manutenção
O ganho real não é fazer isso uma vez, é não precisar refazer a auditoria toda vez.
- Na abertura de qualquer conta nova, preencha o e-mail de contato com um endereço externo ao servidor. Melhor ainda: um alias da sua agência que encaminhe para você e para o cliente.
- Mantenha a lista versionada. Salve o
grepde contatos em um arquivo com a data no nome e guarde fora do servidor. Em uma migração você vai querer essa lista. - Tenha um canal secundário por cliente (WhatsApp, celular do responsável) para os casos em que o e-mail falha. Não precisa de ferramenta: uma coluna a mais na planilha de clientes basta.
- Reaproveite o texto. O modelo acima com data variável serve para manutenção, troca de IP e atualização de versão de PHP. Mudar só as três primeiras linhas é mais rápido e mais seguro do que escrever de novo.
E a regra que resume tudo: o canal que avisa sobre a queda não pode depender do que vai cair.
Referências
- Documentação oficial (cpanel) — Email All Users. Consultado em 2026-10-17.