Anteprima link WhatsApp non visibile? Correggi l'og:image

Un'anteprima link WhatsApp non visibile quasi sempre dipende da una di cinque cause: la pagina non ha un tag og:image, l'URL dell'immagine non è accessibile pubblicamente, l'immagine ha le proporzioni sbagliate e WhatsApp la ritaglia, il ritaglio è corretto ma l'anteprima è obsoleta, oppure il plugin SEO del negozio stampa un tag concorrente. Questa guida copre ciascuna causa, perché non puoi forzare WhatsApp ad aggiornare l'anteprima e cosa modificare su un negozio WooCommerce.

Risposta breve

WhatsApp genera un'anteprima del link a partire dai tag Open Graph della pagina. Se og:image manca, non è raggiungibile o non ha le proporzioni di una card 1200×630, la condivisione arriva come un semplice link, un riquadro grigio o una foto prodotto tagliata male. La maggior parte dei negozi WooCommerce non imposta mai un og:image per le pagine prodotto — il plugin SEO ripiega sull'immagine in evidenza statica, e una foto prodotto quadrata o verticale viene tagliata sui lati o nella parte superiore.

1. Non c'è alcun tag og:image nella pagina

Questa è la causa più comune in un negozio. WordPress e WooCommerce non emettono un og:image per le pagine prodotto, categoria o shop per impostazione predefinita, e un tema che non gestisce Open Graph lascia il tag completamente assente.

Correzione: visualizza il sorgente della pagina e conferma che sia presente un tag og:image, assoluto (un URL https://… completo, mai un percorso relativo) e renderizzato lato server — non iniettato da JavaScript dopo il caricamento. WhatsApp non esegue il tuo JavaScript.

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

Un risultato vuoto è la tua risposta: WhatsApp non ha alcuna immagine da mostrare.

2. L'URL dell'immagine non è accessibile pubblicamente

Il crawler di WhatsApp recupera l'immagine nello stesso modo in cui farebbe qualsiasi client anonimo. Un URL protetto da login, su localhost, su un indirizzo IP grezzo o su un percorso bloccato da robots.txt fallirà.

Correzione: verifica che l'URL restituisca un'immagine senza richiedere credenziali.

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

Ti servono 200 OK e un Content-Type di image/png o image/jpeg.

La trappola di robots.txt. I crawler sociali rispettano robots.txt, quindi una regola che blocca il percorso che contiene le tue immagini rompe l'anteprima — e la rompe in un modo facile da diagnosticare male. Il debugger di Meta riporta quindi "could not be processed as an image. It may be corrupted or may have an invalid format", che si legge esattamente come un rendering corrotto. curl non lo riproduce mai, perché curl ignora robots.txt. Se le tue immagini sono servite da un percorso coperto da una regola Disallow:, l'anteprima fallirà per quanto valido sia il file. Ci siamo imbattuti in questo problema noi stessi sul percorso di rendering di FastOG e l'abbiamo risolto con un override Allow: a corrispondenza più lunga.

3. WhatsApp ritaglia l'immagine del tuo prodotto — e modificare la foto non risolve il problema

Questo è il sintomo che i commercianti descrivono come "le immagini dei miei prodotti vengono ritagliate su WhatsApp", ed è quello che vale la pena capire a fondo.

La piattaforma ritaglia qualsiasi immagine le venga fornita in un riquadro 1200×630. Una foto di prodotto quadrata o verticale viene tagliata sui lati o in alto; un logo viene stirato. Ritagliare manualmente la foto sorgente in Photoshop è una battaglia persa, perché WhatsApp decide il ritaglio in base alle proporzioni della card, non alla composizione che hai scelto — e la foto del prodotto successivo ha di nuovo una forma diversa.

La soluzione è cambiare l'immagine che servi, non la foto che possiedi. Invia una card già composta a 1200×630, con la foto del prodotto inserita al suo interno. La piattaforma, a quel punto, non ha più nulla da ritagliare.

4. La dimensione corretta dell'immagine di anteprima dei link WhatsApp

La dimensione standard per le immagini Open Graph è 1200×630 pixel — un rapporto di 1.91:1 — ed è il formato che ogni piattaforma principale, inclusa WhatsApp, si aspetta. Se carichi un'immagine 1200×630, l'anteprima viene renderizzata come previsto; se invece carichi un quadrato 1000×1000, WhatsApp la ritaglierà per riempire il riquadro.

Mantieni il file sotto i 5 MB. Una card 1200×630 con testo e prodotto pesa di solito tra 200 KB e 500 KB in formato PNG.

Consulta Dimensioni immagine OG: spiegazione del formato 1200×630 per capire perché quel rapporto è diventato lo standard.

5. L'anteprima è obsoleta — e non puoi forzare WhatsApp ad aggiornarla

Se il tag, l'URL e la struttura sono tutti corretti e l'anteprima è ancora sbagliata, stai guardando una cache.

WhatsApp memorizza nella cache l'anteprima. Viene conservata nell'app del destinatario, il che significa che nessuno strumento può chiedere a WhatsApp di aggiornarla — non un debugger, non un'API, non noi. WhatsApp non espone alcun refresh programmatico di alcun tipo, quindi non c'è alcun pulsante da premere. Chiunque affermi il contrario sta descrivendo il comportamento di Facebook, non quello di WhatsApp.

Quello che puoi fare è assicurarti che l'immagine corretta sia pronta per la prossima volta che WhatsApp legge la pagina. È per questo che gli URL di copertina di FastOG sono content-addressed: modifica il titolo, il prezzo o l'immagine del prodotto e l'URL cambia di conseguenza, così la prossima lettura non potrà recuperare la vecchia card. Quando avverrà quella lettura dipende da WhatsApp.

Due piattaforme correlate si comportano allo stesso modo — LinkedIn e X non espongono alcuna API di invalidazione e in genere rileggono entro circa una settimana. I loro inspector possono dare una spinta se hai fretta:

Usare il debugger di Facebook per un problema di WhatsApp. Vale comunque la pena incollare l'URL nello Sharing Debugger anche se non può aggiornare WhatsApp, perché recupera la pagina nello stesso modo in cui farà WhatsApp e riporta ciò che ha effettivamente trovato — tag mancanti, immagini irraggiungibili, formati non validi. Trattalo come un validatore dei tag, non come una soluzione per la cache di WhatsApp.

6. Correggere questo problema su un negozio WooCommerce

Su WooCommerce il flusso di lavoro merita di essere descritto con precisione, perché la modalità di errore di solito è il plugin SEO, non il tema:

• Il tag non esiste di default. WooCommerce non include alcun og:image per product, product_cat o la pagina del negozio.
• Il tuo plugin SEO colma la lacuna in modo inadeguato. Yoast, Rank Math, All in One SEO e SEOPress stampano un og:image — ma per un prodotto usano l'immagine in evidenza statica. Si tratta di una foto quadrata o verticale, che è esattamente l'immagine che WhatsApp poi ritaglia.
• Attenzione ai tag duplicati. Se due plugin stampano entrambi og:image, la piattaforma ne sceglie uno, e potrebbe non essere quello che ti aspetti. Visualizza il sorgente e conta quanti tag og:image la pagina emette.

FastOG per WooCommerce segue una strada diversa: genera una card 1200×630 a partire dai dati live del catalogo (titolo, prezzo, badge di sconto, valutazione, foto del prodotto) sul proprio servizio di rendering, poi consegna quella copertina al plugin SEO che già utilizzi, invece di stampare un tag concorrente. In questo modo mantieni un solo og:image sulla pagina, ed è una card composta per il formato 1.91:1, non una foto prodotto grezza.

Poiché le copertine sono generate dai dati live del catalogo, il prezzo sulla card corrisponde al prezzo sulla pagina e un prodotto scontato riceve il badge di sconto. Quando salvi un prodotto, il plugin chiede inoltre a Facebook di rileggere la pagina — Facebook è l'unica piattaforma che offre un aggiornamento programmatico. WhatsApp, LinkedIn e X seguono i propri tempi, e il plugin lo dichiara chiaramente invece di promettere un aggiornamento che non può garantire.

• Installazione: FastOG per WooCommerce su WordPress.org
• Dettagli e FAQ: Pagina di integrazione WooCommerce

Controlla cosa vedrà realmente WhatsApp

Prima di modificare qualsiasi cosa, osserva la pagina come farebbe un crawler. Incolla l'URL di un prodotto in Vedi i tuoi link come li vedono gli acquirenti: recupera la pagina, legge i tag Open Graph correnti e mostra l'anteprima risultante così come la renderizzano WhatsApp, X e Messenger, accanto a una copertina FastOG creata dagli stessi dati del prodotto. Non è richiesta alcuna registrazione.

Preferisci ispezionare i tag grezzi? Usa il Generatore di Meta Tag Open Graph per vedere il markup, oppure consulta il riferimento in og:image non viene mostrata? Come risolvere.

FAQ

Perché la mia immagine prodotto viene ritagliata su WhatsApp?

WhatsApp ritaglia qualsiasi immagine riceva in un formato 1200×630. Una foto prodotto quadrata o verticale perde i lati o la parte superiore. Servire una card già composta a 1200×630 — con la foto prodotto inserita all'interno della card — non lascia nulla da ritagliare alla piattaforma.

Posso forzare WhatsApp ad aggiornare un'anteprima del link?

No. WhatsApp non espone alcuna API di aggiornamento né un debugger, e l'anteprima in cache vive nell'app del destinatario. Puoi solo assicurarti che l'immagine corretta sia pronta per la sua prossima lettura. Facebook è l'eccezione e offre un re-scraping programmatico.

Perché il Facebook Sharing Debugger mostra la mia immagine, ma WhatsApp non mostra nulla?

Perché sono cache separate, e il debugger riporta i tag della pagina, che entrambe le piattaforme leggono. Se il debugger mostra un'immagine corretta ma WhatsApp non mostra nulla, i tag sono a posto e stai guardando una cache WhatsApp non aggiornata. Se anche il debugger non mostra nulla, il tag manca o l'immagine non è raggiungibile — verifica le cause 1 e 2.

WhatsApp usa og:image o twitter:image?

og:image. Imposta i tag Open Graph. twitter:image è per X.

Mi serve un plugin, o posso aggiungere il tag da solo?

Puoi aggiungere un tag og:image statico al tuo tema da solo — funziona, ed è molto meglio di niente. Quello che non può fare è generare una card distinta per ogni prodotto senza creare manualmente un'immagine per prodotto, e diventerà obsoleto ogni volta che un prezzo cambia. È in quel momento che una copertina dinamica vale la pena.

Il mio sito non è su FastOG. Questo aiuterà comunque?

Sì — le cinque cause sono comportamenti della piattaforma, non di FastOG. Verificale in ordine con curl, il sorgente della pagina e il debugger.

Correlati

• Immagine og:image non visibile? Come risolverla
• Aggiornamento istantaneo dell'immagine WhatsApp per WooCommerce
• Sincronizzazione del prezzo WooCommerce nell'anteprima WhatsApp
• Forza un aggiornamento della cache di Facebook Open Graph
• Dimensioni immagine OG: 1200×630 spiegate
• Come mettere in cache le immagini OG
• URL delle immagini OG firmati
• Generatore di meta tag Open Graph