Предпросмотр ссылок в Telegram не работает или не обновляется

Telegram создает предпросмотр на основе ваших тегов Open Graph и сохраняет кэшированную копию. Исправьте og:title, og:description и og:image, а затем отправьте ссылку боту @WebpageBot, чтобы Telegram обновил данные. В уже отправленных сообщениях предпросмотр останется прежним.

Последнее обновление

linkpreview.app
Meta Tag checker
framer.com
og:title
og:image
x.comRefresh
Launch week: everything new
From yoursite.com
index.html<head>
+<meta property="og:image"
+ content="/og/launch.png">
Быстрое решение


  1. Проверьте страницу с помощью инструмента проверки метатегов и убедитесь, что og:title, og:description и og:image присутствуют.

  2. Используйте абсолютный URL-адрес изображения https://, который загружается без входа в систему или файлов cookie.

  3. Откройте @WebpageBot в Telegram и отправьте ему этот URL.

  4. Поделитесь ссылкой снова. Уже отправленные сообщения сохраняют старый предварительный просмотр.


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

  • Telegram сохранил старую версию в кэше. Срок хранения превью не раскрывается, поэтому старая карточка может отображаться очень долго.

  • Отсутствует тег. Без og:title, og:description и og:image Telegram берет обычный title страницы или показывает только URL.

  • Теги добавляются через JavaScript. Краулеры превью ссылок читают исходный HTML от сервера, поэтому внедренные после загрузки теги часто не замечаются.

  • Защита от ботов блокирует краулер. Капча (challenge page), ошибка 403 или геоблокировка приводят к тому, что Telegram не получает теги.

  • URL изображения относительный или закрытый. Для Telegram нужен полный абсолютный URL с https://, доступный для скачивания.



LinkPreview meta tag checker result for example.com, showing missing Open Graph images as empty placeholders in Google, X, and Slack previews.


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

  1. Откройте страницу в инструменте проверки метатегов и посмотрите найденные теги.

  2. Добавьте недостающие og: теги в head страницы, указав абсолютные URL для og:image и og:url.

  3. Откройте URL изображения в режиме инкогнито, чтобы убедиться, что оно доступно всем.

  4. Разрешите доступ краулеру Telegram в вашем CDN или фаерволе. Обычно он представляется как TelegramBot (like TwitterBot).

  5. Отправьте URL боту @WebpageBot, а затем поделитесь ссылкой в новом сообщении.



Telegram blog post on link previews, showing three official iPhone screenshots of rich link previews in a chat.


Теги, которые читает Telegram

  • og:title и og:description

  • og:image для картинки

  • og:site_name — отображается над заголовком

  • Тег страницы <title> и meta description как запасной вариант



LinkPreview meta tag checker result for framer.com, showing a complete Open Graph image, title, and description in Google, X, and Slack previews.


Не подтверждено официально: Telegram не публикует список тегов или спецификацию краулера. Справочные центры конструкторов сайтов (например, Wix) указывают og:title, og:description и og:image как основные теги для Telegram.

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

Не подтверждено официально: Telegram не заявляет точный размер изображений. JPG или PNG размером 1200 x 630 px — надежный выбор, который подойдет и для всех остальных приложений. Проверьте изображение через инструмент проверки размера OG-изображений.

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

Для этого у Telegram есть официальный бот. Откройте @WebpageBot, нажмите «Запустить» (или отправьте /start), затем отправьте ему ссылку. В одном сообщении можно отправить до 10 ссылок. Если превью все еще не обновилось, отправьте ссылку с параметром запроса, например ?v=2. В нашем инструменте для сброса кэша есть инструкции для каждого сервиса.

Источники

Частые вопросы

Как обновить предпросмотр ссылки в Telegram?

Откройте @WebpageBot в Telegram и отправьте ему URL. Бот заново загрузит страницу и пришлет обновленный предпросмотр. После этого поделитесь ссылкой в новом сообщении.

Почему Telegram показывает только ссылку без предпросмотра?

Telegram не удалось прочитать ваши теги или изображение. Убедитесь, что og:title, og:description и og:image присутствуют в HTML-коде сервера, а защита от ботов не блокирует краулер.

Обновится ли предпросмотр в уже отправленных сообщениях после обновления?

Нет. Уже отправленные сообщения сохраняют прежний вид превью. Обновленная карточка появится только в новых сообщениях.

Проверьте свою страницу, затем обновите предпросмотр

Вставьте свой URL в бесплатный инструмент проверки, чтобы увидеть, какие именно теги считывает каждое приложение. Как только теги будут настроены правильно, воспользуйтесь инструментом обновления, чтобы очистить старый предпросмотр.