# 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.

> 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.

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

---

## 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: `contato@dominiodocliente.com.br`. 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.

```bash
# 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:

```bash
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:

```bash
# 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:

> **** "Preciso de um endereço de e-mail de contato que **não** seja do domínio hospedado conosco (Gmail, Outlook ou o e-mail corporativo de vocês serve). É esse endereço que recebe avisos de manutenção e alertas do servidor, e ele precisa funcionar justamente quando o servidor estiver em manutenção."

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](https://docs.cpanel.net/whm/account-functions/email-all-users/) 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.

```text
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:

```bash
# 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:

```bash
exim -Mvl <ID_DA_MENSAGEM>
```

E para olhar o registro de entregas recentes de forma geral:

```bash
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 `grep` de 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**.

