Предварительный просмотр ссылок | Документация для разработчиков
Предварительный просмотр ссылок
Обновлено: 5 ноября 2025 г
WhatsApp поддерживает предварительный просмотр ссылок, когда они отправляются через чат или публикуются в статусе. WhatsApp попытается выполнить предварительный просмотр ссылки, если это возможно, для улучшения пользовательского опыта. Для обеспечения этой функции WhatsApp полагается на владельцев ссылок, которые определяют свойства, специально оптимизированные для WhatsApp. Несоблюдение этих требований может привести к тому, что ссылка не будет показана предварительно.
Начать
Для начала работы с предварительным просмотром ссылок веб-сайтам необходимо добавить HTML-разметку в раздел HEAD на странице.
<head><meta property="og:title" content="«WhatsApp»/"><meta property="og:description" content="Просто. Безопасно. Надежный обмен сообщениями."/><meta property="og:url" content="https://whatsapp.com"/><meta property="og:image"content="https://static.whatsapp.net/rsrc.php/ym/r/36B424nhiL4.svg"/></head>
Он
Он
Он
Он
WhatsApp постарается максимально точно отображать предварительный просмотр ссылок, например, смягчит требования, будет учитывать другую HTML-разметку и вернется к отображению небольших фрагментов ссылок. Однако на это не следует полагаться. Нет гарантии, что это будет работать (и продолжать работать).
WhatsApp индексирует веб-страницу с помощью HTTP GET-запроса.
В запросе будет установлен заголовок
User-Agent WhatsApp/2.xxx A|I|N , где x — основные/дополнительные числовые версии WhatsApp, а A|I|N — для Android, iOS и веб-версии соответственно. Примеры допустимых User-Agent : WhatsApp/2.22.20.72 A , WhatsApp/2.22.19.78 I , WhatsApp/2.2236.3 N. Владельцы веб-сайтов могут идентифицировать такие входящие запросы и соответствующим образом настраивать контент (разметку и изображения).В запросе также будет
Accept-Language, указывающий на язык, выбранный получателем, если таковой имеется. Примеры допустимых Accept-Language : en , fr , de . Аналогично, владельцы веб-сайтов могут соответствующим образом настроить язык контента. Обратите внимание, что язык, установленный получателем, также будет виден получателю.Как это проверить?
Для начала напишите сообщение со ссылкой для тестирования (пока не нажимайте для отправки). От имени отправителя WhatsApp просканирует этот URL-адрес и попытается сгенерировать предварительный просмотр ссылки.
Если предварительный просмотр не появляется над полем ввода текста через 10 секунд, пожалуйста, убедитесь, что все вышеперечисленные требования выполнены. В противном случае, продолжите отправку сообщения, нажав кнопку «Отправить».
Если предварительный просмотр не отображается в ожидаемом большом размере, пожалуйста, проверьте, выполнены ли указанные выше требования к изображению. В противном случае, предварительный просмотр ссылок работает должным образом. Поздравляем, всё готово!
Комментарии отсутствуют
Комментарии отсутствуют