blog
Revenda

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.

JR · · 6 min de leitura · 2 tabelas · 7 blocos de código

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
  1. Por que o aviso chega e mesmo assim o cliente fica sem informação
  2. Como listar o e-mail de contato de todas as contas em um comando
  3. Como trocar o contato no WHM e o que pedir ao cliente
  4. Por que disparar pelo Email All Users e não pela caixa da agência
  5. Modelo de aviso que responde quando, quanto tempo, o que cai e o que fazer
  6. Como ler a fila e o log do Exim para saber quem não recebeu
  7. 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.

Ordem correta do aviso de manutenção na revendaAuditar contatosLer CONTACTEMAIL de todas as contasCruzar com domínios locaisContato hospedado aqui é riscoCorrigir para endereço externoGmail, Outlook ou e-mail corporativoDisparar o avisoEmail All Users no WHMLer bounces no EximProcurar as falhas definitivasAvisar conclusãoSegundo e-mail após a janela
Inverter a ordem é o erro mais comum: disparar antes de auditar manda aviso para caixa que vai cair junto com o servidor.

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:

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

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
Calendário mínimo de D-7 a D+0D-7Auditoria e pedido de endereço externoD-5Correção no WHM e reconferênciaD-3Disparo e leitura dos bouncesD-1Reenvio por outro canalD+0Aviso de conclusão após janela
Com aviso 20 minutos antes da janela não sobra tempo para tratar bounce.

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.

E a regra que resume tudo: o canal que avisa sobre a queda não pode depender do que vai cair.

Referências

  1. Documentação oficial (cpanel) — Email All Users. Consultado em 2026-10-17.
Leia também