WhatsApp Link Preview nie działa? Napraw og:image

Brak podglądu linku w WhatsApp prawie zawsze wynika z jednej z pięciu przyczyn: strona nie ma tagu og:image, adres URL obrazu nie jest publicznie dostępny, obraz ma niewłaściwy kształt, przez co WhatsApp go przycina, przycięcie jest w porządku, ale podgląd jest nieaktualny, albo wtyczka SEO sklepu generuje konkurencyjny tag. Ten przewodnik omawia każdą z tych przyczyn, wyjaśnia, dlaczego nie można wymusić odświeżenia w WhatsApp, oraz co zmienić w sklepie WooCommerce.

Krótka odpowiedź

WhatsApp tworzy podgląd linku na podstawie tagów Open Graph strony. Jeśli og:image brakuje, jest nieosiągalny lub nie ma formatu karty 1200×630, udostępnienie pojawia się jako goły link, szara kafelek lub źle przycięte zdjęcie produktu. Większość sklepów WooCommerce w ogóle nie ustawia og:image dla stron produktów — wtyczka SEO korzysta z domyślnego wyróżnionego obrazka, a kwadratowe lub wysokie zdjęcie produktu zostaje przycięte z boków lub od góry.

1. Na stronie nie ma tagu og:image

To najczęstsza przyczyna problemu w sklepie. WordPress i WooCommerce domyślnie nie generują og:image dla stron produktów, kategorii ani sklepu, a motyw, który nie obsługuje Open Graph, w ogóle pomija ten tag.

Rozwiązanie: sprawdź źródło strony i potwierdź, że tag og:image jest obecny, absolutny (pełny adres https://… URL, nigdy ścieżka względna) i renderowany po stronie serwera — nie wstrzykiwany przez JavaScript po załadowaniu strony. WhatsApp nie uruchamia Twojego JavaScriptu.

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

Pusty wynik to Twoja odpowiedź: WhatsApp nie ma obrazu do wyświetlenia.

2. Adres URL obrazu nie jest publicznie dostępny

Crawler WhatsAppa pobiera obraz dokładnie tak samo, jak każdy anonimowy klient. Adres URL za logowaniem, na localhost, na surowym adresie IP lub na ścieżce zablokowanej przez robots.txt nie zadziała.

Rozwiązanie: potwierdź, że adres URL zwraca obraz bez poświadczeń.

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

Potrzebujesz 200 OK oraz Content-Type o wartości image/png lub image/jpeg.

Pułapka z robots.txt. Crawlery społecznościowe respektują robots.txt, więc reguła blokująca ścieżkę, na której znajdują się Twoje obrazy, psuje podgląd — i to w sposób, który łatwo źle zdiagnozować. Debugger Meta zgłasza wtedy „could not be processed as an image. It may be corrupted or may have an invalid format”, co wygląda dokładnie jak uszkodzony render. curl nigdy tego nie odtworzy, ponieważ curl ignoruje robots.txt. Jeśli Twoje obrazy są serwowane ze ścieżki objętej regułą Disallow:, podgląd nie zadziała, niezależnie od tego, jak poprawny jest plik. Sami trafiliśmy na to na ścieżce renderowania FastOG i naprawiliśmy to nadpisaniem Allow: z dopasowaniem najdłuższego prefiksu.

3. WhatsApp przycina obraz produktu — a edycja zdjęcia tego nie naprawi

To objaw, który sprzedawcy opisują jako „moje zdjęcia produktów są przycinane na WhatsAppie” i warto go właściwie zrozumieć.

Platforma przycina każde dostarczone jej zdjęcie do ramki 1200×630. Kwadratowe lub wysokie zdjęcie produktu traci boki lub górę; kafelek z logo zostaje rozciągnięty. Ręczne przycinanie źródłowego zdjęcia w Photoshopie to przegrana walka, ponieważ WhatsApp decyduje o kadrze na podstawie proporcji karty, a nie kompozycji, którą wybrałeś — a kolejne zdjęcie produktu znów ma inny kształt.

Rozwiązaniem jest zmiana obrazu, który serwujesz, a nie zdjęcia, które posiadasz. Wyślij kartę już skomponowaną w rozmiarze 1200×630, ze zdjęciem produktu dopasowanym w jej wnętrzu. Platforma nie będzie miała wtedy czego przycinać.

4. Właściwy rozmiar obrazu podglądu linku WhatsApp

Standardowy rozmiar obrazu Open Graph to 1200×630 pikseli — proporcje 1,91:1 — i jest to format, jakiego oczekuje każda większa platforma, w tym WhatsApp. Podaj obraz 1200×630, a podgląd wyrenderuje się zgodnie z przeznaczeniem; podaj kwadrat 1000×1000, a WhatsApp przytnie go, aby wypełnić ramkę.

Zachowaj rozmiar pliku poniżej 5 MB. Karta tekstowo-produktowa o wymiarach 1200×630 zwykle zajmuje od 200 KB do 500 KB w formacie PNG.

Zobacz Rozmiar obrazu OG: wyjaśnienie 1200×630, aby dowiedzieć się, dlaczego te proporcje stały się standardem.

5. Podgląd jest nieaktualny — a nie da się wymusić odświeżenia w WhatsApp

Jeśli tag, URL i format są poprawne, a podgląd nadal się nie zgadza, masz do czynienia z cache.

WhatsApp cache'uje podgląd. Jest on przechowywany w aplikacji odbiorcy, co oznacza, że żadne narzędzie nie może poprosić WhatsApp o odświeżenie — ani debugger, ani API, ani my. WhatsApp nie udostępnia żadnego programowego odświeżania, więc nie ma żadnego przycisku do naciśnięcia. Ktokolwiek twierdzi inaczej, opisuje zachowanie Facebooka, a nie WhatsApp.

Co możesz zrobić, to upewnić się, że poprawny obraz czeka na następny raz, gdy WhatsApp odczyta stronę. Dlatego adresy URL okładek w FastOG są adresowane treścią (content-addressed): zmień tytuł produktu, cenę lub obraz, a URL zmieni się razem z nimi, więc następny odczyt nie może pobrać starej karty. Kiedy ten odczyt nastąpi, zależy od WhatsApp.

Dwie powiązane platformy zachowują się tak samo — LinkedIn i X również nie udostępniają API do unieważniania i zwykle ponownie odczytują stronę w ciągu około tygodnia. Ich własne inspektory mogą to przyspieszyć, jeśli się spieszysz:

Użycie debuggera Facebooka do problemu z WhatsApp. Warto mimo wszystko wkleić URL do Sharing Debugger, nawet jeśli nie może on odświeżyć WhatsApp, ponieważ pobiera stronę w ten sam sposób, w jaki zrobi to WhatsApp, i raportuje, co faktycznie znalazł — brakujące tagi, nieosiągalne obrazy, złe formaty. Traktuj go jako walidator tagów, a nie jako naprawę cache WhatsApp.

6. Naprawa tego w sklepie WooCommerce

W przypadku WooCommerce warto dokładnie opisać przebieg działania, ponieważ źródłem problemu jest zwykle wtyczka SEO, a nie motyw:

• Tag nie istnieje domyślnie. WooCommerce nie dostarcza og:image dla product, product_cat ani strony sklepu.
• Twoja wtyczka SEO wypełnia tę lukę w złym stylu. Yoast, Rank Math, All in One SEO i SEOPress wygenerują og:image — ale w przypadku produktu sięgną po statyczny obraz wyróżniający. To kwadratowe lub pionowe zdjęcie, czyli dokładnie ten obraz, który WhatsApp później przycina.
• Uważaj na zduplikowane tagi. Jeśli dwie wtyczki wygenerują og:image, platforma wybierze jeden z nich i może to nie być ten, którego oczekujesz. Wyświetl źródło strony i policz, ile tagów og:image emituje strona.

FastOG dla WooCommerce działa inaczej: renderuje kartę 1200×630 z danych na żywo z katalogu (tytuł, cena, plakietka wyprzedaży, ocena, zdjęcia produktu) we własnej usłudze renderowania, a następnie przekazuje ten obraz okładki wybranej wtyczce SEO, której już używasz, zamiast generować konkurencyjny tag. Dzięki temu na stronie pozostaje jeden og:image, a jest to karta przygotowana pod proporcje 1.91:1, a nie surowe zdjęcie produktu.

Ponieważ okładki są generowane z danych na żywo z katalogu, cena na karcie zgadza się z ceną na stronie, a produkt z obniżką otrzymuje plakietkę wyprzedaży. Po zapisaniu produktu wtyczka prosi również Facebooka o ponowne odczytanie strony — Facebook to jedyna platforma oferująca programowe odświeżanie. WhatsApp, LinkedIn i X działają według własnego harmonogramu, a wtyczka informuje o tym wprost, zamiast obiecywać odświeżenie, którego nie może zapewnić.

• Instalacja: FastOG dla WooCommerce na WordPress.org
• Szczegóły i FAQ: Strona integracji z WooCommerce

Sprawdź, co faktycznie zobaczy WhatsApp

Zanim cokolwiek zmienisz, obejrzyj stronę tak, jak widzi ją crawler. Wklej dowolny URL produktu do narzędzia Zobacz swoje linki tak, jak widzą je kupujący — pobiera ono stronę, odczytuje jej aktualne tagi Open Graph i pokazuje wynikowy podgląd tak, jak renderują go WhatsApp, X i Messenger, obok okładki FastOG zbudowanej z tych samych danych produktu. Rejestracja nie jest wymagana.

Wolisz sprawdzić surowe tagi? Skorzystaj z Generatora tagów meta Open Graph, aby zobaczyć znaczniki, albo zajrzyj do referencji w artykule og:image nie działa? Jak to naprawić.

FAQ

Dlaczego moje zdjęcie produktu jest przycinane na WhatsApp?

WhatsApp przycina każde dostarczone zdjęcie do ramki 1200×630. Kwadratowe lub pionowe zdjęcie produktu traci boki lub górę. Serwowanie karty już skomponowanej w rozmiarze 1200×630 — ze zdjęciem produktu dopasowanym wewnątrz karty — nie pozostawia platformie nic do przycięcia.

Czy mogę wymusić odświeżenie podglądu linku na WhatsApp?

Nie. WhatsApp nie udostępnia żadnego API do odświeżania ani debuggera, a zapisany podgląd znajduje się w aplikacji odbiorcy. Możesz jedynie zadbać o to, aby poprawny obraz czekał na kolejne odczytanie. Wyjątkiem jest Facebook, który oferuje programowe ponowne przeszukiwanie.

Dlaczego Facebook Sharing Debugger pokazuje moje zdjęcie, a WhatsApp nic?

Ponieważ to osobne pamięci podręczne, a debugger raportuje stan tagów strony, które obie platformy odczytują. Jeśli debugger pokazuje poprawne zdjęcie, a WhatsApp nic — tagi są w porządku i patrzysz na nieodświeżoną pamięć podręczną WhatsApp. Jeśli debugger również nic nie pokazuje, tag brakuje lub obraz jest nieosiągalny — przeanalizuj przyczyny 1 i 2.

Czy WhatsApp używa og:image czy twitter:image?

og:image. Ustaw tagi Open Graph. twitter:image jest dla X.

Czy potrzebuję wtyczki, czy mogę po prostu dodać tag samodzielnie?

Możesz samodzielnie dodać statyczny tag og:image do swojego motywu — to działa i jest znacznie lepsze niż nic. Czego nie potrafi, to wygenerować odrębnej karty dla każdego produktu bez ręcznego tworzenia jednego obrazu na produkt, a także będzie nieaktualny za każdym razem, gdy zmieni się cena. W tym momencie dynamiczna okładka staje się warta zachodu.

Moja strona nie jest na FastOG. Czy to nadal pomoże?

Tak — pięć przyczyn to zachowanie platform, a nie FastOG. Przeanalizuj je po kolei za pomocą curl, źródła strony i debuggera.

Powiązane

• og:image się nie wyświetla? Jak to naprawić
• Natychmiastowa aktualizacja obrazu WhatsApp dla WooCommerce
• Synchronizacja cen WooCommerce w podglądzie WhatsApp
• Wymuś odświeżenie pamięci podręcznej Open Graph na Facebooku
• Rozmiar obrazu OG: 1200×630 wyjaśnione
• Jak buforować obrazy OG
• Podpisane adresy URL obrazów OG
• Generator tagów meta Open Graph