Не работает или не отображается предпросмотр ссылок в WhatsApp

Почему превью в WhatsApp отсутствует или отображается маленьким

• Изображение слишком «тяжелое». WhatsApp требует, чтобы размер изображения не превышал 600 КБ. Большинство других платформ допускают гораздо больший размер, поэтому обычно причина именно в этом.

• Блок head расположен слишком низко. Тег <head> с вашими метатегами должен находиться в пределах первых 300 КБ HTML-кода.

• Тег пуст или находится вне head. Теги og:title, og:description и og:url должны быть внутри head и не должны быть пустыми.

• Изображение слишком узкое или слишком широкое. Его ширина должна составлять не менее 300 px, а соотношение сторон (ширина к высоте) — не более 4:1.

• URL изображения является относительным. og:image должен содержать абсолютный URL.

Как это исправить

1. Откройте страницу в инструменте проверки метатегов и проверьте наличие четырех тегов og:.

2. Сожмите изображение до размера менее 600 КБ. Обычно подходит JPG размером 1200 x 630. Проверьте его с помощью инструмента проверки размера OG-изображений.

3. Переместите скрипты и объемный встроенный код ниже тегов, чтобы блок head оставался в пределах первых 300 КБ.

4. Укажите в og:url чистый канонический URL без параметров отслеживания или сессий.

5. Вставьте ссылку в новое сообщение и подождите. Если через 10 секунд превью не появится, значит, одно из указанных выше правил все еще нарушено.

Теги, которые считывает WhatsApp

• og:title отображается жирным шрифтом, до 2 строк, без брендинга

• og:description отображается более мелким шрифтом, 1–2 строки; достаточно 80 символов

• og:url канонический URL

• og:image миниатюра

Требования к размеру изображений

• Менее 600 КБ

• Ширина не менее 300 px

• Соотношение ширины к высоте 4:1 или меньше

• Абсолютный URL

Как принудительно обновить превью

У WhatsApp нет инструмента для принудительного обновления. Отправьте URL с параметром запроса, например ?v=2, чтобы страница загрузилась как новая ссылка. Уже отправленные сообщения сохранят прежнее превью. Наш инструмент обновления описывает этот шаг наряду с другими платформами.

Не подтверждено: WhatsApp не публикует информацию о том, как долго кэшируются превью. В некоторых руководствах утверждается, что Sharing Debugger от Facebook также обновляет кэш WhatsApp, однако в документации самого WhatsApp об этом не сказано, а его краулер использует собственный юзер-агент WhatsApp.

Источники

• Предварительный просмотр ссылок в WhatsApp (документация Meta для разработчиков)