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

При создании кнопки связи через Telegram, которая передаёт текущий URL страницы в параметр ?text=, многие сталкиваются с проблемой: мессенджер автоматически генерирует предпросмотр (превью) этой ссылки. Это может выглядеть неопрятно и отвлекать пользователя. В этой статье мы объясним, почему это происходит и как легко отключить предпросмотр ссылки в Telegram.

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

Telegram по умолчанию пытается загрузить предпросмотр для всех ссылок, которые он обнаруживает в тексте сообщения. Если в вашей кнопке передаётся URL страницы (например, https://domain.com/foobar), Telegram парсит его и показывает миниатюру с заголовком и описанием. Это стандартное поведение мессенджера.

Способ убрать предпросмотр: параметр disable_web_page_preview

Чтобы отключить предпросмотр ссылки в Telegram, достаточно добавить в конец вашей ссылки специальный параметр. В Telegram есть встроенная возможность отключить превью с помощью конструкции ?disable_web_page_preview=true или ?dpwp=1. Однако этот метод работает только в том случае, если ссылка отправляется как часть текстового сообщения через бота или напрямую. Для кнопок с преднабранным текстом (когда вы используете tg://msg?text=...) этот параметр нужно вставлять непосредственно в URL, который вы передаёте.

Пример правильной ссылки для кнопки:

tg://msg?text=Привет! Интересная статья, хочу связаться с администратором! (Источник: https://domain.com/foobar?disable_web_page_preview=true)

Обратите внимание: параметр disable_web_page_preview добавляется к самому URL страницы, а не к внешнему тексту сообщения. Telegram, увидев этот параметр, не станет загружать предпросмотр для указанного адреса.

Альтернативный способ: экранирование ссылки

Если по каким-то причинам параметр не срабатывает, можно попробовать экранировать ссылку. Для этого разбейте её на две части или используйте HTML-сущности. Например, вместо прямой ссылки https://domain.com/foobar напишите https://domain.com/foobar с пробелом или точкой внутри, но это может сломать кликабельность. Лучший способ - использовать параметр отключения предпросмотра.

Проверка результата

После внесения изменений обязательно протестируйте кнопку на разных устройствах (iOS, Android, десктопная версия Telegram). На мобильных устройствах предпросмотр может отображаться иначе, но параметр disable_web_page_preview работает на всех платформах. Если превью всё ещё появляется, убедитесь, что вы правильно разместили параметр в URL.

Частые ошибки

• Добавление параметра не в тот URL (например, в текст сообщения, а не в ссылку).
• Использование неправильного синтаксиса (пропущен вопросительный знак или знак равенства).
• Кэширование предпросмотра Telegram - иногда нужно подождать несколько минут.

Следуя этим простым рекомендациям, вы сможете легко убрать предпросмотр ссылки в Telegram и сделать вашу кнопку более аккуратной и профессиональной.