Como corrigir a pré-visualização de ligações no Facebook e no WhatsApp

Se, ao partilhar um URL no Facebook ou no WhatsApp, não aparecer a imagem, surgir um título incorreto ou se mantiver uma versão antiga, verifique primeiro que dados essa página publica e se podem ser descarregados sem iniciar sessão.

A pré-visualização costuma utilizar as etiquetas Open Graph do HTML. Alterar apenas a imagem que vê dentro da página pode não modificar a imagem que esta declara para partilhar.

Primeiro, distinga o problema

O WhatsApp permite desativar as pré-visualizações de ligações. Se tiver essa opção ativada, o facto de não ser gerada uma pré-visualização ao enviar não demonstra uma falha do site.

1. Verifique as etiquetas Open Graph

Abra o URL exato que está a partilhar e consulte o seu código-fonte. Em <head> deveria haver dados equivalentes a estes, adaptados a essa página:

<meta property="og:type" content="website">
<meta property="og:url" content="https://oseudominio.com/articulo">
<meta property="og:title" content="Título da página">
<meta property="og:description" content="Descrição da página partilhada.">
<meta property="og:image" content="https://oseudominio.com/imagenes/compartir.jpg">

O URL de og:image deve ser absoluto. Verifique que não aponta para uma imagem de outra página, para um ambiente de testes ou para um ficheiro que já não existe. Publique as etiquetas no HTML inicial: não dependa de que apareçam depois de executar JavaScript.

No WordPress, o seu plugin de SEO pode gerir o título, a descrição e a imagem social. Reveja o HTML final para excluir que o tema e outro plugin gerem etiquetas contraditórias. Se declarar várias imagens, coloque primeiro a que quer priorizar.

2. Verifique que a imagem pode ser descarregada

Abra o URL de og:image numa janela privada. Deve mostrar diretamente a imagem por HTTPS, sem login, cookies obrigatórios nem um desafio antibots.

Utilize uma imagem horizontal com texto legível; por exemplo, pode preparar uma de 1200 × 630 píxeis. Comprima o ficheiro e verifique como fica em ambas as aplicações: as dimensões, por si sós, não garantem uma pré-visualização. Evite servir uma imagem enorme quando uma versão leve oferece o mesmo resultado.

Se obtiver um 403, 404, erro de certificado ou uma página de acesso, corrija primeiro essa resposta. Reveja as regras da firewall, da CDN ou da proteção contra ligações externas que afetem o ficheiro.

3. Peça uma nova extração no Facebook

Abra o Depurador de partilhas do Facebook, introduza o URL exato e reveja a informação obtida. Depois de corrigir a origem, utilize a opção de voltar a extrair para pedir outra leitura.

Se ainda aparecerem dados antigos, limpe a cache da aplicação e da CDN e verifique de novo o código-fonte público. Quando alterar o ficheiro de uma imagem social, um nome novo permite distinguir a versão publicada de uma cópia antiga; atualize também og:image.

O depurador atua sobre o Facebook. Não limpa a cache do WhatsApp nem demonstra que imagem será mostrada aí.

4. Teste a ligação no WhatsApp

Cole o URL completo na caixa de uma conversa, sem o enviar, e espere que a pré-visualização se forme. Confirme antes que não a desativou nas definições. Uma pré-visualização já enviada não é um teste fiável do estado atual da página.

Se só falhar no WhatsApp, volte a verificar a imagem, a resposta pública e o HTML inicial. Anote que dispositivo e versão da aplicação utiliza para poder comparar o comportamento.

Verificação pelo terminal

Se precisar de inspecionar a resposta HTTP, estes comandos fazem um descarregamento com o identificador do rastreador do Facebook:

curl -L --compressed -A 'facebookexternalhit/1.1' https://oseudominio.com/articulo
curl -L --compressed -A 'facebookexternalhit/1.1' -o /dev/null -w '%{http_code} %{content_type} %{size_download}\n' https://oseudominio.com/imagenes/compartir.jpg

O primeiro deve conter as etiquetas corretas. O segundo permite ver o código HTTP, o tipo de conteúdo e o tamanho descarregado. Um 200 com text/html no URL da imagem pode indicar que recebeu uma página de erro ou um desafio.

Estes testes são feitos a partir da sua ligação: alterar o identificador não reproduz o IP, a cache nem todas as condições do rastreador real. Compare o resultado com o depurador e os registos do servidor.

O que enviar ao suporte se persistir

Se alojar o site na Hostsuar, indique-nos o URL partilhado, o URL de og:image, a hora do teste e onde falha. Podemos rever erros de acesso ou bloqueios do alojamento. Não é necessário mudar de servidor se a causa estiver nas etiquetas do seu tema ou nas definições da aplicação.