O link de pré-visualização do WhatsApp não aparece? Corrija o og:image

Uma pré-visualização de link do WhatsApp que não aparece quase sempre se resume a uma de cinco causas: a página não tem a tag og:image, a URL da imagem não é publicamente acessível, a imagem tem o formato errado e o WhatsApp a corta, o corte está correto mas a pré-visualização está desatualizada, ou o plugin de SEO da loja está imprimindo uma tag concorrente. Este guia aborda cada causa, por que você não pode forçar o WhatsApp a atualizar e o que mudar em uma loja WooCommerce.

Resposta curta

O WhatsApp gera a prévia do link (link preview) a partir das tags Open Graph da página. Se og:image estiver ausente, inacessível ou não tiver o formato de um card de 1200×630, o compartilhamento chega como um link simples, um bloco cinza ou uma foto de produto mal cortada. A maioria das lojas WooCommerce nunca define um og:image para as páginas de produto — o plugin de SEO usa como fallback a imagem em destaque estática, e uma foto de produto quadrada ou alta tem as laterais ou o topo cortados.

1. Não há tag og:image na página

Esta é a causa mais comum em uma loja. WordPress e WooCommerce não emitem uma og:image para páginas de produto, categoria ou loja por padrão, e um tema que não lida com Open Graph deixará a tag completamente ausente.

Correção: visualize o código-fonte da página e confirme se uma tag og:image está presente, absoluta (uma URL https://… completa, nunca um caminho relativo) e renderizada no servidor — não injetada por JavaScript após o carregamento. O WhatsApp não executa seu JavaScript.

curl -s https://your-store.com/product/example | grep -i 'og:image'

Um resultado vazio é a sua resposta: o WhatsApp não tem imagem para exibir.

2. A URL da imagem não é publicamente acessível

O crawler do WhatsApp busca a imagem da mesma forma que qualquer cliente anônimo. Uma URL protegida por login, em localhost, em um endereço IP bruto ou em um caminho bloqueado por robots.txt falhará.

Correção: confirme que a URL retorna uma imagem sem exigir credenciais.

curl -I https://your-store.com/wp-content/uploads/product.jpg

Você quer 200 OK e um Content-Type de image/png ou image/jpeg.

A armadilha do robots.txt. Os crawlers de redes sociais respeitam robots.txt, então uma regra que bloqueia o caminho que contém suas imagens quebra a pré-visualização — e quebra de uma forma fácil de diagnosticar errado. O depurador da Meta então reporta "could not be processed as an image. It may be corrupted or may have an invalid format", o que parece exatamente um render quebrado. curl nunca reproduz isso, porque curl ignora robots.txt. Se suas imagens são servidas de um caminho coberto por uma regra de Disallow:, a pré-visualização falhará não importa o quão válido o arquivo seja. Nós mesmos enfrentamos isso no caminho de render do próprio FastOG e corrigimos com uma sobrescrita de Allow: por correspondência mais longa.

3. O WhatsApp corta a imagem do seu produto — e editar a foto não vai resolver

Este é o sintoma que os lojistas descrevem como "minhas imagens de produto são cortadas no WhatsApp", e é o que vale a pena entender direito.

A plataforma corta qualquer imagem que recebe para um quadro de 1200×630. Uma foto de produto quadrada ou alta tem as laterais ou o topo cortados; um bloco de logo é esticado. Cortar a foto original manualmente no Photoshop é uma batalha perdida, porque o WhatsApp decide o corte com base na proporção do card, não na composição que você escolheu — e a próxima foto de produto tem um formato diferente de novo.

A solução é mudar a imagem que você serve, não a foto que você possui. Envie um card que já esteja composto em 1200×630, com a foto do produto ajustada dentro dele. Assim, a plataforma não tem mais nada para cortar.

4. O tamanho certo da imagem de pré-visualização de link no WhatsApp

O tamanho padrão da imagem Open Graph é 1200×630 pixels — uma proporção de 1,91:1 — e é o formato que todas as principais plataformas, incluindo o WhatsApp, esperam. Use 1200×630 e a pré-visualização será renderizada como esperado; use um quadrado de 1000×1000 e o WhatsApp vai cortar a imagem para preencher o quadro.

Mantenha o arquivo abaixo de 5 MB. Um card de texto e produto de 1200×630 normalmente fica entre 200 KB e 500 KB em PNG.

Veja Tamanho da Imagem OG: 1200×630 Explicado para entender por que essa proporção se tornou o padrão.

5. A prévia está desatualizada — e você não consegue forçar o WhatsApp a atualizá-la

Se a tag, a URL e o formato estão todos corretos e a prévia ainda está errada, o problema é cache.

O WhatsApp armazena a prévia em cache. Ela fica no aplicativo do destinatário, o que significa que nenhuma ferramenta pode pedir ao WhatsApp para atualizá-la — nem um depurador, nem uma API, nem nós. O WhatsApp não expõe nenhuma atualização programática de qualquer tipo, então não há botão para pressionar. Quem afirmar o contrário está descrevendo o comportamento do Facebook, não o do WhatsApp.

O que você pode fazer é garantir que a imagem correta esteja aguardando na próxima vez que o WhatsApp ler a página. É por isso que as URLs de capa do FastOG são endereçadas por conteúdo: altere o título, o preço ou a imagem do produto e a URL muda junto, então a próxima leitura não pode pegar o card antigo. Quando essa leitura acontece, quem decide é o WhatsApp.

Duas plataformas relacionadas se comportam da mesma forma — LinkedIn e X também não expõem API de invalidação e normalmente relêem em cerca de uma semana. Os inspetores delas podem dar um empurrãozinho se você estiver com pressa:

Usando o depurador do Facebook para um problema do WhatsApp. Ainda vale a pena colar a URL no Sharing Debugger mesmo que ele não consiga atualizar o WhatsApp, porque ele busca a página da mesma forma que o WhatsApp fará e informa o que realmente encontrou — tags ausentes, imagens inacessíveis, formatos inválidos. Trate-o como um validador das tags, não como uma correção para o cache do WhatsApp.

6. Corrigindo isso em uma loja WooCommerce

No WooCommerce, o fluxo de trabalho merece ser descrito com precisão, porque o modo de falha geralmente é o plugin de SEO, não o tema:

• A tag não existe por padrão. O WooCommerce não inclui uma og:image para product, product_cat ou para a página da loja.
• Seu plugin de SEO preenche essa lacuna mal. Yoast, Rank Math, All in One SEO e SEOPress imprimem uma og:image — mas, para um produto, eles usam a imagem destacada estática. Essa é uma foto quadrada ou em retrato, exatamente a imagem que o WhatsApp depois corta.
• Cuidado com tags duplicadas. Se dois plugins imprimirem og:image, a plataforma escolhe uma, e pode não ser a que você espera. Veja o código-fonte e conte quantas tags og:image a página emite.

O FastOG para WooCommerce segue um caminho diferente: ele renderiza um card de 1200×630 a partir de dados ao vivo do catálogo (título, preço, selo de promoção, avaliação, fotos do produto) em seu próprio serviço de renderização e, em seguida, entrega essa capa ao plugin de SEO que você já usa, em vez de imprimir uma tag concorrente. Assim, você mantém apenas uma og:image na página, e ela é um card composto para o formato 1.91:1, em vez de uma foto crua do produto.

Como as capas são geradas a partir de dados ao vivo do catálogo, o preço no card corresponde ao preço na página, e um produto com desconto ganha um selo de promoção. Ao salvar um produto, o plugin também pede ao Facebook para reler a página — o Facebook é a única plataforma que oferece uma atualização programática. WhatsApp, LinkedIn e X seguem seus próprios cronogramas, e o plugin informa isso claramente, em vez de prometer uma atualização que não pode entregar.

• Instalação: FastOG para WooCommerce no WordPress.org
• Detalhes e FAQ: página de integração com WooCommerce

Veja o que o WhatsApp realmente verá

Antes de alterar qualquer coisa, observe a página da forma como um rastreador (crawler) faz. Cole qualquer URL de produto em Veja Seus Links do Jeito Que os Compradores Veem — a ferramenta busca a página, lê as tags Open Graph atuais e mostra a prévia resultante como WhatsApp, X e Messenger a renderizam, ao lado de uma capa FastOG criada a partir dos mesmos dados do produto. Não é necessário cadastro.

Prefere inspecionar as tags brutas? Use o Gerador de Meta Tags Open Graph para ver a marcação, ou consulte a referência em og:image Não Aparece? Como Corrigir.

FAQ

Por que minha imagem de produto aparece cortada no WhatsApp?

O WhatsApp corta qualquer imagem que recebe para um quadro de 1200×630. Uma foto de produto quadrada ou em retrato perde as laterais ou o topo. Servir um card já composto em 1200×630 — com a foto do produto ajustada dentro do card — não deixa nada para a plataforma cortar.

Posso forçar o WhatsApp a atualizar a pré-visualização de link?

Não. O WhatsApp não expõe uma API de atualização nem um depurador, e a pré-visualização em cache fica no aplicativo do destinatário. Você só pode garantir que a imagem correta esteja aguardando a próxima leitura. O Facebook é a exceção e oferece um re-rastreamento programático.

Por que o Facebook Sharing Debugger mostra minha imagem, mas o WhatsApp não mostra nada?

Porque são caches separados, e o depurador está reportando as tags da página, que ambas as plataformas leem. Se o depurador mostra uma imagem correta, mas o WhatsApp não mostra nada, as tags estão corretas e você está vendo um cache do WhatsApp não atualizado. Se o depurador também não mostra nada, a tag está ausente ou a imagem está inacessível — percorra as causas 1 e 2.

O WhatsApp usa og:image ou twitter:image?

og:image. Defina as tags Open Graph. twitter:image é para o X.

Preciso de um plugin ou posso adicionar a tag eu mesmo?

Você pode adicionar uma tag og:image estática ao seu tema por conta própria — ela funciona e é muito melhor do que nada. O que ela não consegue fazer é gerar um card distinto por produto sem criar manualmente uma imagem por produto, e ela ficará desatualizada sempre que um preço mudar. É nesse ponto que uma capa dinâmica vale a pena.

Meu site não está no FastOG. Isso ainda vai ajudar?

Sim — as cinco causas são comportamento da plataforma, não comportamento do FastOG. Percorra-as em ordem com curl, o código-fonte da página e o depurador.

Relacionados

• og:image não aparece? Como corrigir
• Atualização instantânea de imagem no WhatsApp para WooCommerce
• Sincronização de preços do WooCommerce na pré-visualização do WhatsApp
• Forçar a atualização do cache do Open Graph no Facebook
• Tamanho da imagem OG: 1200×630 explicado
• Como armazenar imagens OG em cache
• URLs de imagem OG assinadas
• Gerador de meta tags do Open Graph