Guia de Cache de Pré-visualização Social: Facebook, WhatsApp, LinkedIn, X, Slack e Discord
Uma pré-visualização social tem duas partes: os metadados e a imagem que seu site fornece, e a cópia que uma plataforma mantém após rastrear sua página. Corrigir a primeira não limpa automaticamente a segunda.
Este é o mapa compacto das plataformas para diagnosticar uma pré-visualização de produto antiga, ausente ou cortada.
Comparação de plataformas
| Plataforma | O que você controla | Realidade de atualização |
|---|---|---|
HTML público, og:image, URL da imagem e cache da página |
O Facebook oferece suporte a re-raspagem por meio do Sharing Debugger e de seu endpoint de raspagem documentado. O FastOG pode solicitar uma atualização do Facebook quando configurado. | |
| O próximo HTML público e a resposta da imagem | Não há API pública de atualização de pré-visualização. As pré-visualizações em cache são controladas pelo WhatsApp e podem variar conforme o destinatário. | |
| HTML público e resposta da imagem | Não há endpoint documentado de invalidação programática. O LinkedIn decide quando rastrear novamente. | |
| X | HTML público, twitter:image e tags Open Graph de fallback |
Não há endpoint documentado de invalidação programática. O X decide quando rastrear novamente. |
| Slack | HTML público e resposta da imagem | O Slack armazena em cache os unfurls de URLs compartilhadas; o aplicativo não pode forçar a reconstrução de todas as mensagens existentes. |
| Discord | HTML público e resposta da imagem | O Discord armazena em cache os embeds de URLs compartilhadas; o aplicativo não pode reescrever um embed existente em todos os lugares. |
O comportamento das plataformas e os endpoints mudam. Trate a tabela como um limite operacional, não como uma promessa sobre o tempo de atualização.
Diagnostique a origem primeiro
Antes de culpar uma plataforma, inspecione a página que um crawler recebe:
curl -s https://example.com/product/example | grep -Ei 'og:image|og:title|twitter:image'
Em seguida, busque a URL da imagem na resposta:
curl -I "https://cdn.example.com/cover.png"
A página deve expor metadados atuais, a URL da imagem deve ser pública e a resposta da imagem deve retornar um tipo de conteúdo de imagem suportado com 200 OK. Se o cache da página servir HTML antigo, nenhuma plataforma conseguirá descobrir a nova capa.
Por que alterar a URL da imagem ajuda
As plataformas sociais armazenam em cache a URL da página e também podem armazenar em cache a URL da imagem. Uma capa dinâmica deve, portanto, usar uma nova URL de imagem quando os dados do produto mudam. O permalink do produto permanece canônico enquanto a chave de cache da imagem muda.
Adicionar ?v=2 ao permalink do produto pode fazer um teste parecer novo, mas cria um segundo endereço para o mesmo produto e pode dividir as análises e o histórico de compartilhamento. Em vez disso, versione a URL da imagem sempre que possível.
O Facebook é a exceção
O Facebook é a única plataforma neste guia para a qual o FastOG oferece um caminho ativo de re-raspagem (re-scrape). Quando habilitado, uma atualização de produto pode enfileirar uma solicitação ao endpoint de raspagem do Meta para a URL desse produto. A solicitação é enfileirada e feita na melhor das hipóteses (best-effort), então uma limitação de taxa ou um erro temporário do Meta não impede a loja de servir os metadados corretos.
Isso não atualiza WhatsApp, LinkedIn, X, Slack ou Discord. Não descreva uma re-raspagem do Facebook como uma limpeza universal do cache social.
Uma ordem prática de operações
- Busque a página ao vivo e confirme as tags atuais.
- Limpe o cache de página do site ou o CDN se as tags estiverem antigas.
- Confirme se a URL da imagem é pública e retorna uma imagem.
- Altere a URL da imagem quando os bytes da imagem mudarem.
- Use o depurador do Facebook ou o caminho de re-rastreamento configurado para o Facebook.
- Para outras plataformas, aguarde um novo rastreamento ou compartilhe uma URL que ainda não tenha sido armazenada em cache. Não prometa um atraso exato.
O Testador Gratuito de Imagem OG pode buscar uma URL de produto e mostrar os metadados visíveis ao rastreador junto com uma capa gerada. Ele é útil para separar um problema do lado da loja de um problema de cache do lado da plataforma.
FAQ
Um plugin pode atualizar todas as pré-visualizações de redes sociais?
Não. Um plugin pode controlar o HTML e a URL da imagem servidos pelo site. Cada plataforma controla seu próprio rastreador e cache.
Por que a pré-visualização aparece correta no Facebook, mas desatualizada no WhatsApp?
As plataformas mantêm caches separados. Um novo rastreamento do Facebook altera apenas a cópia do Facebook; o WhatsApp mantém sua própria pré-visualização específica por destinatário.
Devo alterar a URL do produto após cada atualização de preço?
Geralmente não. Mantenha a URL canônica do produto estável e altere a URL da imagem gerada quando o conteúdo da capa mudar. Alterar a URL da página é uma solução bruta para quebrar o cache, com custos de SEO e analytics.
Uma nova URL de imagem garante uma atualização imediata no WhatsApp?
Não. Ela garante que a próxima busca dessa URL de imagem possa receber novos bytes. Ela não força o WhatsApp a buscar a página nem a substituir uma pré-visualização já armazenada no aplicativo de um destinatário.