Página Manutenção HTML

Página de manutenção bem feita: status, headers e comunicação

Uma página de manutenção é o que os visitantes veem enquanto uma indisponibilidade planejada está em curso — migração de banco, um deploy grande, troca de provider de pagamento. A página em si é HTML, mas o detalhe que quase todo mundo erra é o código de status HTTP. Devolver 200 OK sinaliza aos buscadores que o seu texto de manutenção é o novo conteúdo, e o Google vai começar a indexar "Voltaremos em breve" como o title da sua home. O correto é 503 Service Unavailable junto com o header Retry-After — o próprio Google documenta isso como o sinal para pausar o crawl sem perder ranking.

Uma boa página de manutenção tem uma explicação curta, um ETA honesto, um pedido de desculpas, dados de contato e, idealmente, um link para uma status page externa (Statuspage, Better Stack, ou o Cachet open-source) — assim ela permanece acessível mesmo se o app principal estiver fora. O header Retry-After aceita um número de segundos (Retry-After: 3600) ou uma HTTP-date — ambos válidos pela RFC 9110.

Exemplos reais e padrões

O "Fail Whale" do Twitter (2008-2013) transformou a queda em parte da identidade visual da marca. A página de erro do Cloudflare com a nuvem laranja é tão familiar que o usuário já sabe que o problema é upstream. A AWS publica um Health Dashboard independente dos serviços que monitora. A lição cultural, codificada no livro Site Reliability Engineering do Google, é que janela de manutenção precisa ser planejada, anunciada e seguida de post-mortem.

Deploys modernos: a página ainda é necessária?

Deploys blue-green, canary releases e ferramentas de online schema change (gh-ost, pt-online-schema-change) permitem entregar a maioria das mudanças com zero downtime. A página de manutenção deveria ficar reservada para indisponibilidades irredutíveis — troca de storage, migração de região, parada regulatória. Se você se pegar mostrando essa página toda terça às 02:00, o problema não é a manutenção; é o pipeline de deploy.

Comunicação e SLAs

Para SaaS B2B a janela de manutenção tem efeito contratual: a maioria dos SLAs desconta as horas de manutenção planejada da meta de 99,9%, mas só se o cliente tiver sido avisado com antecedência (em geral 72 horas). Combine o banner no site com email para os admins, notificação no Slack/Teams, um tweet de @SuaEmpresaStatus e um canal interno de incidente. Fazer post-mortem em até 48 horas após a resolução — mesmo para janela planejada — virou o padrão moderno.

Perguntas frequentes

Por que o status 503 é tão importante? Porque 200 em página de manutenção faz o Google reindexar o site com o texto de placeholder e detonar o ranking. 503 + Retry-After é interpretado como "fora temporariamente, volte depois" e preserva o índice.

Quanto tempo a manutenção pode durar? Menos de duas horas é ideal para produtos consumer; menos de quatro horas para B2B. Acima disso, fragmente em janelas menores ou invista em tooling de zero downtime — manutenção longa em janela única é cheiro, não estratégia.

Devo oferecer alternativa ao usuário? Sim sempre que possível. Link para um mirror read-only, status page, feed do Twitter ou até cortesia para o concorrente sinaliza respeito pelo tempo do usuário e diminui carga no suporte.

WordPress, Shopify e Webflow têm modo manutenção embutido — preciso de página própria? O built-in serve para sites pequenos. Para qualquer caso onde SEO ou branding importam, sirva uma página HTML própria a partir do CDN (Cloudflare Workers, Vercel) — assim ela continua no ar mesmo se a origem cair.