A prévia do link do WhatsApp não está funcionando ou não aparece

O WhatsApp tem limites rígidos: a tag head precisa estar nos primeiros 300 KB do HTML e a imagem deve ter menos de 600 KB. Se desrespeitar algum deles, você terá uma miniatura pequena ou nenhuma prévia.

Última atualização

Verifique sua URL

Atualizar prévia

Verificar tamanho da imagem

Solução rápida


  1. Verifique a página com o verificador de meta tags.

  2. Defina og:image como uma URL absoluta para um arquivo com menos de 600 KB e pelo menos 300 px de largura.

  3. Mantenha og:title, og:description e og:url preenchidos e dentro da tag head.

  4. Cole a URL em um chat, aguarde 10 segundos e verifique a prévia antes de enviar.


Por que a pré-visualização do WhatsApp não aparece ou fica pequena

  • A imagem é muito pesada. O WhatsApp exige uma imagem com menos de 600 KB. A maioria das outras plataformas permite bem mais, portanto esta é a causa mais comum.

  • O head está muito abaixo. A tag <head> com as suas tags deve aparecer nos primeiros 300 KB do HTML.

  • Uma tag está vazia ou fora do head. og:title, og:description e og:url devem estar no head e não podem estar vazias.

  • A imagem é muito estreita ou muito larga. Ela deve ter 300 px de largura ou mais, com uma proporção de largura para altura de 4:1 ou menos.

  • A URL da imagem é relativa. A tag og:image precisa ser uma URL absoluta.

Como corrigir

  1. Abra a página no verificador de meta tags e confirme as quatro tags og:.

  2. Comprima a imagem para menos de 600 KB. Um JPG de 1200 x 630 geralmente atende. Verifique com o verificador de tamanho de imagem OG.

  3. Mova scripts e códigos inline grandes para baixo das tags para que o head permaneça nos primeiros 300 KB.

  4. Defina og:url com a URL canônica limpa, sem parâmetros de rastreamento ou de sessão.

  5. Cole o link em uma nova mensagem e aguarde. Se nenhuma pré-visualização aparecer após 10 segundos, uma das regras acima ainda não foi atendida.

Tags que o WhatsApp lê

  • og:title exibido em negrito, em até 2 linhas, sem nome da marca

  • og:description exibido menor, em 1 ou 2 linhas; 80 caracteres são suficientes

  • og:url a URL canônica

  • og:image a miniatura

Regras para o tamanho da imagem

  • Menos de 600 KB

  • Pelo menos 300 px de largura

  • Proporção de largura para altura de 4:1 ou menos

  • URL absoluta

Como forçar uma atualização

O WhatsApp não tem uma ferramenta de atualização (refresh). Envie a URL com uma query string, como ?v=2, para que ele busque a página como um novo link. As mensagens já enviadas mantêm a pré-visualização original. A ferramenta de atualização lista essa etapa ao lado das outras plataformas.

Não confirmado: o WhatsApp não divulga por quanto tempo mantém as pré-visualizações em cache. Alguns tutoriais dizem que o Depurador de Compartilhamento do Facebook também atualiza o WhatsApp; a documentação oficial do WhatsApp não afirma isso, e o rastreador dele usa seu próprio user agent do WhatsApp.

Fontes

Perguntas Frequentes

Qual tamanho de imagem o WhatsApp precisa para a prévia de um link?

Menos de 600 KB, com pelo menos 300 px de largura e proporção máxima de 4:1. A URL deve ser absoluta.

Por que o WhatsApp mostra uma prévia pequena em vez de uma grande?

A imagem não atende às regras de tamanho, por isso o WhatsApp usa uma prévia pequena. Comprima-a para menos de 600 KB primeiro.

Como atualizo a prévia de um link no WhatsApp?

Não existe uma ferramenta oficial. Compartilhe a URL com uma query string como ?v=2. Não verificado: o WhatsApp não documenta o tempo de cache.

Verifique sua página e atualize a prévia

Cole sua URL no verificador gratuito para ver as tags exatas que cada aplicativo lê. Assim que as tags estiverem corretas, use a ferramenta de atualização para limpar a pré-visualização antiga.

Verifique sua URL

Atualizar pré-visualização

Verificar tamanho da imagem

Guias relacionados

A prévia do link do Facebook não está aparecendo ou não está atualizando

O Facebook lê as tags Open Graph com seu próprio rastreador e armazena o resultado em cache por até 30 dias. Corrija as tags e a imagem e, em seguida, rastreie o URL novamente.

Pré-visualização de link do iMessage não funciona ou mostra um balão cinza

O Mensagens busca a própria página e não executa JavaScript. Sem a og:image e um bom ícone, você fica apenas com o balão cinza simples contendo apenas o título.

O embed do Discord não está aparecendo ou não está atualizando

O Discord busca a página uma vez, lê as tags no HTML do servidor e armazena a prévia em cache por cerca de 30 minutos. Ele nunca executa o seu JavaScript.