Atualização instantânea da imagem do WhatsApp para WooCommerce

Uma atualização instantânea da imagem do WhatsApp para WooCommerce significa que o cartão correto está pronto no momento em que você salva um produto — não que o WhatsApp relê o link sob comando. Ninguém consegue fazer o WhatsApp reler um link: ele armazena em cache as prévias no app do destinatário e não expõe nenhuma API de atualização. O que você controla é tudo do lado da loja, e isso é suficiente para que a próxima pessoa que compartilhar o link veja o produto, o preço e a foto atuais.

A resposta curta

Existem dois relógios em uma prévia do WhatsApp, e apenas um deles é seu.

Toda alegação de "atualização instantânea" que ignora a segunda linha é mentira, e todo produto que só corrige a primeira linha ainda mostra a imagem certa assim que o WhatsApp olha de novo. É esse o jogo inteiro: deixar o lado da loja comprovadamente correto e então parar de torcer para que o WhatsApp colabore.

Por que sua atualização não aparece

Quatro caches separados ficam entre "eu mudei o preço" e "o preview mudou". Os lojistas quase sempre culpam o cache errado.

A linha 1 é a que as pessoas esquecem. Uma página HTML em cache ainda contém a URL og:image antiga, então mesmo um card perfeitamente reconstruído nunca é descoberto. Limpe o cache de página primeiro, depois olhe o resto.

As linhas 3 e 4 são o motivo pelo qual acrescentar uma versão à URL da imagem é o único cache-buster confiável — uma nova URL de imagem é um cache miss em todos os lugares ao mesmo tempo.

A parte do WooCommerce: sua tag nunca deve ficar desatualizada

No WooCommerce, o problema da tag geralmente é uma de duas coisas, e nenhuma delas é culpa do WhatsApp:

• Não existe nenhuma og:image. O WordPress e o WooCommerce não emitem nenhuma para product, product_cat ou a página da loja. Seu plugin de SEO fornece uma — e, para um produto, ele recorre à imagem destacada estática.
• A tag existe, mas aponta para um arquivo fixo. Uma URL de imagem estática não pode mudar quando o preço muda. Cada compartilhamento após a edição re-cacheia a mesma imagem desatualizada.

O FastOG segue o outro caminho. A capa é uma URL assinada cuja query contém os valores que a produziram, lidos do catálogo ao vivo a cada requisição: o nome do produto, o preço atual (get_price() — o preço promocional em um produto com desconto), o preço "de" de comparação, o selo de promoção, a avaliação, o estoque e a foto do produto.

Isso tem uma consequência que vale declarar claramente: uma mudança de preço é uma mudança de URL. A URL antiga não descreve mais o produto, então o CDN não tem nada desatualizado para servir, e a próxima busca renderiza novamente. Sem gambiarra de cache-busting, sem checklist de "será que eu limpei o cache".

O que acontece quando você clica em Salvar em um produto

Para o Facebook — a única plataforma que permite que qualquer pessoa solicite — o FastOG faz a solicitação por você:

1. O WooCommerce dispara seu webhook nativo product.updated / product.created (o permalink está no payload).
2. O FastOG atualiza o registro do catálogo da loja, para que a próxima capa seja gerada a partir dos dados atuais.
3. Um job RefreshMetaPreview é enfileirado para a URL da página desse produto. Ele é enfileirado em vez de executado inline — uma sincronização de catálogo completo não deve adicionar uma chamada bloqueante à Meta por item — e é deduplicado, para que salvar o mesmo produto repetidamente não consuma o limite de taxa da Meta.
4. O job chama o endpoint de scrape da Meta com um token de acesso de app, e a Meta substitui sua cópia em cache da prévia daquela página.

Isso é best-effort por design. Se a Meta estiver lenta, recusar ou limitar a taxa, a sincronização ainda terá sucesso: a tag na sua página já está correta, e o único custo é que a Meta atualiza no próprio cronograma dela em vez de imediatamente.

Isso não atualiza o WhatsApp, o LinkedIn nem o X, porque nenhum deles oferece uma API para atualizar qualquer coisa. Isso não é uma limitação do FastOG — é a ausência de um endpoint do outro lado.

Verifique na ordem correta

Quando uma prévia não atualiza, siga esta lista em vez de adivinhar:

# 1. Does the page still serve the OLD tag? (page cache — cache row 1)
curl -s https://your-store.com/product/example | grep -i 'og:image'

# 2. Is that image URL reachable without credentials? (cache row 3)
curl -I "https://...the-og-image-url-from-step-1..."

# 3. Did the image URL change after the edit? Compare with the URL from before.

Se o passo 1 ainda mostrar a URL anterior à edição, nada adiante vai ajudar — limpe o cache da página. Se o passo 1 mostrar uma nova URL e o passo 2 retornar 200 OK com um image/png, o lado da loja está correto e você está olhando para a linha 2 do cache, que é o relógio do WhatsApp.

Quer ver as quatro linhas de fora? Cole a URL do produto em See Your Links The Way Buyers Do — ele busca a página como um crawler faz, lê as tags ao vivo e renderiza o resultado como WhatsApp, X e Messenger mostram, ao lado de uma capa do FastOG criada a partir dos mesmos dados do produto. Sem cadastro.

Um plugin de cache-busting ou ?v=2 ajuda?

Eles ajudam de uma forma limitada, e o trade-off é real.

Um preview é armazenado em cache com base no link que as pessoas compartilharam. Uma URL que ninguém nunca compartilhou não tem preview em cache — é por isso que acrescentar uma query string que muda (?v=2) é um truque tão comum. Funciona, e tem um custo: o link compartilhado deixa de ser a URL canônica do seu produto, os mecanismos de busca veem um segundo endereço e o analytics divide o tráfego.

O FastOG aplica o mesmo mecanismo um nível abaixo, onde ele é gratuito. A URL da página permanece canônica; apenas a URL da imagem muda com o conteúdo. Assim, a capa antiga não pode ser servida de novo, e o link que você compartilha continua sendo a página do produto que você quer indexada.

O que ninguém consegue corrigir, e por que dizemos isso

• WhatsApp armazena o preview em cache no app do destinatário. Não existe API, debugger nem ferramenta — incluindo a nossa — capaz de acessá-lo.
• LinkedIn e X também não expõem nenhuma API documentada de invalidação programática. Os crawlers deles releem conforme os próprios cronogramas; não trate uma estimativa de tempo de terceiros como garantia da plataforma.
• Facebook é a exceção, e a única plataforma que o FastOG aciona para você. Consulte Force a Facebook Open Graph Cache Refresh para entender o funcionamento.

Um fornecedor que diz que atualiza o WhatsApp está descrevendo o comportamento do Facebook e torcendo para você não verificar. Preferimos entregar o mapa preciso.

Perguntas frequentes

Posso forçar o WhatsApp a atualizar uma prévia de link imediatamente?

Não. O WhatsApp não expõe nenhum endpoint de atualização nem depurador, e a prévia em cache fica no app do destinatário. Você só pode garantir que a imagem correta esteja esperando pela próxima leitura.

Por quanto tempo o WhatsApp mantém uma prévia de link?

Não há número publicado nem forma de consultar — é por destinatário, por dispositivo. Trate como "até o WhatsApp decidir o contrário" e otimize o lado da loja em vez disso.

Por que atualizou para mim, mas não para meu cliente?

Porque você testou compartilhando um link que nunca tinha sido compartilhado a partir do seu dispositivo, ou enviou para uma conversa nova. Seu cliente está lendo uma prévia em cache. A prévia dele e a sua são independentes.

Alterar a URL do produto força uma atualização?

Uma URL que ninguém compartilhou não tem prévia em cache, então sim — ao custo de um segundo endereço para o mesmo produto. Alterar a URL da imagem produz o mesmo efeito sem mexer no seu permalink, que é o que o FastOG faz.

Preciso de um plugin, ou posso editar meu tema sozinho?

Um og:image estático no seu tema é muito melhor do que nada, e é gratuito. O que ele não consegue fazer é variar por produto sem criar manualmente uma imagem por produto — nem acompanhar uma mudança de preço. É nesse ponto que uma capa dinâmica se paga.

Meu site não está no FastOG. Algo disso ainda ajuda?

Sim. Os quatro caches, a ordem de verificação e os limites das plataformas são como as plataformas se comportam, não como o FastOG se comporta. Percorra a lista com curl e os depuradores.

Existe um plano gratuito?

Sim. O nível Community gratuito cobre até 100 itens entre páginas de produto, categoria, loja e post de blog, com cinco templates base mais os templates de produto Black Friday e Oferta Sazonal. As capas são limpas — nenhum plano carrega marca d'água, incluindo o Community. O Community renderiza no servidor Community compartilhado e é limitado por limites de taxa por loja/IP, não por branding. Os planos pagos usam um servidor dedicado separado do Community, aumentam a cota de itens e desbloqueiam templates e recursos adicionais (selos de avaliação a partir do Starter, mapeamento de metafields a partir do Pro, regras com escopo e renderização prioritária a partir do Scale). Os planos pagos também incluem um teste de 14 dias sem necessidade de cartão de crédito.

Relacionados

• Prévia de link do WhatsApp não aparece? Corrija a og:image
• Guia de cache de prévia social: Facebook, WhatsApp, LinkedIn, X, Slack e Discord
• Forçar a atualização do cache do Open Graph do Facebook
• Sincronização de preços do WooCommerce na prévia do WhatsApp
• Como fazer cache de imagens OG
• Tamanho da imagem OG: 1200×630 explicado
• Integração com WooCommerce: FastOG para WooCommerce