Du hast die Open-Graph-Tags korrigiert, den Link zum Prüfen in einen WhatsApp-Chat gezogen, und die Vorschau stimmt immer noch nicht: der alte Titel, kein Bild oder gar keine Karte außer der nackten URL. Das ist eine bekannte Art, eine halbe Stunde zu verlieren, denn WhatsApp verrät dir fast nichts darüber, was es gesehen hat oder warum es aufgab.
Dieser Beitrag behandelt drei Dinge: wie WhatsApp diese kleine Vorschaukarte wirklich baut, die kurze Liste der Gründe, warum sie falsch herauskommt, und den Ein-Zeichen-Trick, der WhatsApp dazu bringt, deine Seite neu zu lesen, statt dir eine zwischengespeicherte, veraltete Version zu zeigen. Wenn du lieber direkt zur Diagnose springst: Der WhatsApp-Linkvorschau-Debugger ruft deine Seite so ab wie WhatsApp und sagt dir, was er gefunden hat.
Wie WhatsApp eine Linkvorschau baut
Wenn du eine URL in einen Chat einfügst, liest nicht dein Telefon die Seite. WhatsApps eigene Server rufen sie einmal ab und ziehen ein paar Tags aus dem HTML, um die Karte zusammenzusetzen: einen Titel, eine kurze Beschreibung und ein Bild. Zuerst sucht es nach Open-Graph-Tags (den <meta property="og:...">-Zeilen, die eine Seite in ihren <head> setzt), greift auf Twitter-Card-Tags zurück, falls diese fehlen, und schließlich auf das schlichte <title>-Element, wenn es nichts anderes gibt.
Die drei wichtigsten Tags sind og:title, og:description und og:image. Sind die richtig, bekommst du die Karte, die du erwartest. So sieht ein vollständiger Satz aus:
<meta property="og:title" content="Der Titel deiner Seite"> <meta property="og:description" content="Eine einzeilige Zusammenfassung der Seite."> <meta property="og:image" content="https://beispiel.com/preview.jpg">
Ein Detail erklärt die meisten Probleme: Den Abruf macht ein Bot, kein Browser. WhatsApp sendet einen Crawler-User-Agent, lädt das rohe HTML herunter und hört auf. Es führt kein JavaScript aus, es scrollt nicht und wartet auf nichts. Was auch immer im HTML steht, das dein Server in der ersten Antwort zurückgibt, ist alles, was WhatsApp je sehen wird.
Die üblichen Gründe, warum eine Vorschau kaputtgeht
Die meisten kaputten Vorschauen gehen auf einen der Gründe unten zurück. Sie stehen grob in der Reihenfolge, in der es sich lohnt, sie zu prüfen.
Die Tags stehen nicht im HTML
Hat die Seite kein og:title oder og:image, hat WhatsApp wenig, womit es arbeiten kann. Es greift vielleicht auf das <title> zurück und zeigt eine schlichte Karte ohne Bild, oder es zeigt nichts außer dem Link. Öffne die Seite, sieh dir den Quelltext an und suche nach og:. Stehen diese Zeilen nicht da, hat WhatsApp sie auch nie gesehen.
Die Tags werden von JavaScript hinzugefügt
Das ist der Fall, der moderne Seiten erwischt. Wenn dein Framework die Meta-Tags nach dem Laden der Seite einfügt (eine Single-Page-App oder clientseitiges Rendering), existieren sie im Browser, aber nicht im rohen HTML. WhatsApp führt dieses JavaScript nicht aus, liest also die leere Hülle und findet nichts. Die Tags müssen im HTML stehen, das der Server sendet, bevor irgendein Skript läuft. Serverseitiges Rendering oder ein Prerender-Schritt ist die Lösung.
Das Bild ist zu klein, zu schwer oder nicht HTTPS
Für die große Bildkarte muss og:image ein echtes, erreichbares Bild in vernünftiger Größe sein. Unter etwa 300×200 Pixeln wechselt WhatsApp meist zu einem kleinen Vorschaubild oder lässt das Bild weg; eine sehr große Datei (über etwa 5 MB) kann ebenfalls verworfen werden. Die Bild-URL muss https sein und ohne Login laden. Ein häufiger Fehler: Das Bild wird von einer signierten CDN- oder S3-URL mit einem Token ausgeliefert, das abläuft, die Vorschau funktioniert also heute und liefert nächste Woche einen 404, sobald das Token stirbt.
Die Seite blockiert den Crawler
Sitzt die Seite hinter einem Login, gibt einen 401 oder 403 zurück oder blockiert unbekannte User-Agents am CDN, bekommt WhatsApp eine Mauer statt deines HTML und kann keine Karte bauen. Manche Seiten sperren Open-Graph-Tags hinter einem erkannten Vorschau-Bot, deshalb kann dieselbe URL auf einer Plattform eine Vorschau zeigen und auf einer anderen nicht.
Der Titel oder die Beschreibung ist zu lang
Das stoppt die Vorschau nicht, es kürzt sie nur. WhatsApp schneidet einen Titel nach etwa 65 Zeichen ab und eine Beschreibung nach etwa 160, ein langer Titel wird also mitten im Satz abgeschnitten. Schreibe die wichtigen Wörter zuerst und halte og:title kurz.
Die Seite ist langsam oder leitet zu oft weiter
Der Crawler wartet nur begrenzt. Eine Seite, die mehrere Sekunden zum Antworten braucht, oder eine, die unter einer Kette von Weiterleitungen begraben ist, kann eine Zeitüberschreitung haben, bevor WhatsApp die Tags liest. Richte den Link auf die endgültige URL und halte die erste Antwort schnell.
Der Trick: Lass die URL neu aussehen
Hier ist der Teil, an dem fast jeder stolpert, und der Grund, warum eine Vorschau lange falsch bleibt, nachdem du die Seite behoben hast. WhatsApp speichert die Vorschau zur exakten URL zwischen. Sobald es deine Seite abgerufen und eine Karte gebaut hat, verwendet es diese Karte für denselben Link wieder und ruft eine ganze Weile nicht neu ab. Du kannst also jedes Tag korrigieren, und der Link, den du bereits geteilt hast, zeigt weiter die alte, kaputte Vorschau, weil WhatsApp nicht deine Seite liest, sondern seinen eigenen Cache.
Der Weg drumherum ist, die URL so zu ändern, dass WhatsApp sie als eine behandelt, die es noch nie gesehen hat. Füge einen Query-Parameter hinzu, den deine Seite ignoriert:
https://beispiel.com/deine-seite → https://beispiel.com/deine-seite?v=2
Jeder Parameter funktioniert (?v=2, ?x=1, ?refresh=1), solange sich die URL-Zeichenfolge von der unterscheidet, die WhatsApp bereits zwischengespeichert hat. Es sieht eine neue URL, ruft die Seite frisch ab und liest deine aktuellen Tags. Musst du nach einer weiteren Änderung erneut prüfen, zähl die Zahl hoch: ?v=3, dann ?v=4. Die meisten Seiten ignorieren einen unbekannten Query-Parameter, das ändert also nichts an dem, was der Besucher sieht.
Eine ehrliche Einschränkung. Das gibt dir eine funktionierende Vorschau zum Testen und zum künftigen Teilen, aber es leert nicht den Cache deiner ursprünglichen, sauberen URL. Dieser Eintrag altert nach WhatsApps eigenem Zeitplan aus, den Meta nicht veröffentlicht und der bis zu Wochen dauern kann. Nutze den Parameter also, um die Korrektur zu bestätigen und einen Link herauszugeben, der heute korrekt in der Vorschau erscheint, statt zu erwarten, dass sich die nackte URL von selbst aktualisiert.
Sieh, was WhatsApp sieht, ohne zu raten
Einen Link immer wieder in einen echten Chat einzufügen ist eine langsame Art zu debuggen, weil du nur das Ergebnis siehst, nie den Grund. Der WhatsApp-Linkvorschau-Debugger macht den Abruf für dich: Er ruft deine Seite als WhatsApps Crawler ab, zeigt den genauen Titel, die Beschreibung und das Bild, die er gefunden hat, und gibt eine Einschätzung in einfacher Sprache, was fehlt oder zu lang ist. Fehlen Open-Graph-Tags, schreibt er die <meta>-Zeilen zum Hineinkopieren, und er hat einen Cache-Bust-Button, der den Query-Parameter-Trick von oben anwendet. Prüfe die Seite dort zuerst, behebe, was er meldet, und teile den Link dann wirklich.
Häufige Fragen
Warum zeigt WhatsApp nach dem Beheben der Seite immer noch die alte Vorschau?
WhatsApp hat die Vorschau zu genau dieser URL zwischengespeichert und liefert die gespeicherte Karte, statt deine Seite neu zu lesen. Füge einen Query-Parameter hinzu (zum Beispiel ?v=2), damit es die Seite erneut abruft, oder warte, bis WhatsApps Cache von selbst abläuft.
Führt WhatsApp JavaScript aus, wenn es meine Seite liest?
Nein. WhatsApps Crawler lädt das rohe HTML herunter und hört auf. Werden deine Open-Graph-Tags von clientseitigem JavaScript hinzugefügt, sieht WhatsApp sie nie. Die Tags müssen im HTML stehen, das der Server zurückgibt, was meist serverseitiges Rendering oder einen Prerender-Schritt bedeutet.
Warum ist auf meiner WhatsApp-Vorschau kein Bild?
Die häufigsten Ursachen sind ein fehlendes og:image-Tag, ein Bild unter etwa 300×200 Pixeln, ein Bild über http statt https, ein Bild hinter einem Login oder einer ablaufenden signierten URL, oder ein Bild-Tag, das von JavaScript hinzugefügt wird. Prüfe das gewählte Bild mit dem Linkvorschau-Debugger.
Wie lange speichert WhatsApp eine Linkvorschau zwischen?
Meta veröffentlicht die genaue Dauer nicht, und in der Praxis kann sie Wochen anhalten. Deshalb kannst du dich beim Testen nicht darauf verlassen, dass der Cache von selbst leert, und deshalb ist der Query-Parameter-Trick der verlässliche Weg, jetzt eine frische Vorschau zu sehen.
