Você arrumou as tags Open Graph, colou o link num chat do WhatsApp para conferir e a prévia continua errada: o título antigo, sem imagem ou sem card nenhum além da URL crua. É um jeito comum de perder meia hora, porque o WhatsApp quase não conta o que viu nem por que desistiu.
Este post cobre três coisas: como o WhatsApp monta aquele cardzinho de prévia, a lista curta de motivos que fazem ela sair errada e o truque de um caractere que faz o WhatsApp ler sua página de novo em vez de mostrar uma versão guardada e desatualizada. Se você prefere ir direto ao diagnóstico, o depurador de prévia de links do WhatsApp baixa sua página do mesmo jeito que o WhatsApp faz e diz o que encontrou.
Como o WhatsApp monta a prévia de um link
Quando você cola uma URL num chat, seu celular não lê a página. Quem baixa são os próprios servidores do WhatsApp, uma vez, e eles tiram algumas tags do HTML para montar o card: um título, uma descrição curta e uma imagem. Ele procura primeiro as tags Open Graph (as linhas `<meta property="og:...">` que uma página coloca no `<head>`), passa para as tags do Twitter Card se elas faltarem e, por fim, para o elemento `<title>` quando não há mais nada.
As três tags que mais importam são `og:title`, `og:description` e `og:image`. Com essas certas, você recebe o card que espera. É assim que fica um conjunto completo:
<meta property="og:title" content="O título da sua página"> <meta property="og:description" content="Um resumo de uma linha da página."> <meta property="og:image" content="https://exemplo.com/preview.jpg">
Um detalhe explica quase todos os problemas que aparecem: quem baixa é um bot, não um navegador. O WhatsApp manda um user agent de rastreador, baixa o HTML cru e para por aí. Ele não executa JavaScript, não rola a página e não espera nada carregar. O que estiver no HTML que seu servidor devolve na primeira resposta é tudo o que o WhatsApp vai ver.
Os motivos comuns que quebram uma prévia
A maioria das prévias quebradas cai em um dos motivos abaixo. Eles estão mais ou menos na ordem em que vale a pena checar.
As tags não estão no HTML
Se a página não tem `og:title` nem `og:image`, o WhatsApp fica com pouca coisa para trabalhar. Ele pode recorrer ao `<title>` e mostrar um card simples sem imagem, ou não mostrar nada além do link. Abra a página, veja o código-fonte e procure por `og:`. Se essas linhas não estão ali, o WhatsApp também não as viu.
As tags são adicionadas por JavaScript
Esse é o que pega os sites modernos. Se o seu framework insere as meta tags depois que a página carrega (um aplicativo de página única, ou renderização no cliente), elas existem no navegador, mas não no HTML cru. O WhatsApp não roda esse JavaScript, então lê a casca vazia e não encontra nada. As tags precisam estar no HTML que o servidor devolve, antes de qualquer script rodar. A solução é renderizar no servidor ou ter um passo de pré-renderização.
A imagem é pequena demais, pesada demais ou não é HTTPS
Para o card de imagem grande, `og:image` precisa ser uma imagem real, acessível e de tamanho razoável. Abaixo de uns 300×200 pixels, o WhatsApp tende a cair para uma miniatura pequena ou pular a imagem; um arquivo muito grande (acima de uns 5 MB) também pode ser descartado. A URL da imagem precisa ser https e tem que carregar sem login. Um erro comum: a imagem vem de uma URL assinada de um CDN ou do S3 com um token que expira, então a prévia funciona hoje e dá 404 na semana que vem, quando o token morre.
A página bloqueia o rastreador
Se a página fica atrás de um login, devolve um 401 ou 403, ou bloqueia user agents desconhecidos no CDN, o WhatsApp recebe uma parede em vez do seu HTML e não consegue montar o card. Alguns sites reservam as tags Open Graph para um bot de prévia reconhecido, e por isso a mesma URL pode gerar prévia em uma plataforma e não em outra.
O título ou a descrição é longo demais
Isso não impede a prévia, só corta. O WhatsApp corta o título em cerca de 65 caracteres e a descrição em cerca de 160, então um título longo fica cortado no meio da frase. Coloque as palavras importantes primeiro e mantenha o `og:title` curto.
A página é lenta ou redireciona demais
O rastreador só espera até certo ponto. Uma página que leva vários segundos para responder, ou uma enterrada sob uma corrente de redirecionamentos, pode estourar o tempo antes de o WhatsApp ler as tags. Aponte o link para a URL final e deixe a primeira resposta rápida.
O truque: faça a URL parecer nova
Aqui está a parte que confunde quase todo mundo, e o motivo de uma prévia continuar errada muito depois de você arrumar a página. O WhatsApp guarda a prévia em cache associada à URL exata. Depois de baixar sua página e montar o card, ele reutiliza esse card para o mesmo link e não baixa de novo por um bom tempo. Então você pode corrigir todas as tags e o link que já compartilhou vai continuar mostrando a prévia antiga e quebrada, porque o WhatsApp não está lendo sua página, está lendo o próprio cache.
O jeito de contornar isso é mudar a URL para o WhatsApp tratá-la como uma que nunca viu. Adicione um parâmetro de consulta que sua página ignore:
https://exemplo.com/sua-pagina → https://exemplo.com/sua-pagina?v=2
Qualquer parâmetro serve (`?v=2`, `?x=1`, `?refresh=1`), desde que o texto da URL seja diferente do que o WhatsApp já guardou em cache. Ele vê uma URL nova, baixa a página na hora e lê suas tags atuais. Se precisar conferir de novo depois de outra edição, aumente o número: `?v=3`, depois `?v=4`. A maioria das páginas ignora um parâmetro de consulta desconhecido, então isso não muda nada do que o visitante vê.
Uma ressalva honesta. Isso te dá uma prévia que funciona para testar e para compartilhar de agora em diante, mas não limpa o cache da sua URL limpa original. Aquela entrada expira no cronograma do próprio WhatsApp, que a Meta não publica e que pode chegar a semanas. Então use o parâmetro para confirmar o conserto e para distribuir um link que hoje gere uma prévia correta, em vez de esperar a URL crua se atualizar sozinha.
Veja o que o WhatsApp vê, sem adivinhar
Colar um link num chat de verdade várias vezes é um jeito lento de depurar, porque você só vê o resultado, nunca o motivo. O depurador de prévia de links do WhatsApp faz a busca por você: pede sua página como o rastreador do WhatsApp, mostra o título, a descrição e a imagem exatos que encontrou e dá uma leitura em linguagem clara do que falta ou do que está longo demais. Quando faltam tags Open Graph, ele escreve as linhas `<meta>` para você copiar, e tem um botão para furar o cache que aplica o truque do parâmetro acima. Confira a página ali primeiro, arrume o que ele apontar e depois compartilhe o link de verdade.
Perguntas frequentes
Por que o WhatsApp ainda mostra a prévia antiga depois que arrumei a página?
O WhatsApp guardou a prévia em cache associada àquela URL exata e serve o card guardado em vez de reler sua página. Adicione um parâmetro de consulta (por exemplo `?v=2`) para ele baixar a página de novo, ou espere o cache do WhatsApp expirar sozinho.
O WhatsApp executa JavaScript quando lê minha página?
Não. O rastreador do WhatsApp baixa o HTML cru e para. Se suas tags Open Graph são adicionadas por JavaScript no cliente, o WhatsApp nunca as vê. As tags precisam estar no HTML que o servidor devolve, o que normalmente significa renderizar no servidor ou um passo de pré-renderização.
Por que não tem imagem na minha prévia do WhatsApp?
As causas mais comuns são uma tag `og:image` faltando, uma imagem abaixo de uns 300×200 pixels, uma imagem servida por http em vez de https, uma imagem atrás de login ou com uma URL assinada que expira, ou uma tag de imagem adicionada por JavaScript. Confira a imagem escolhida com o depurador de prévia de links.
Por quanto tempo o WhatsApp guarda a prévia de um link em cache?
A Meta não publica a duração exata e, na prática, ela pode durar semanas. Por isso você não pode contar com o cache se limpando sozinho durante os testes, e por isso adicionar um parâmetro de consulta é o jeito confiável de ver uma prévia nova agora.