QR-коды и короткие ссылки | Документация для разработчиков

QR-коды и короткие ссылки

Обновлено: 31 октября 2025 г

QR-коды и короткие ссылки WhatsApp создают для бизнеса цифровой «входной портал», позволяя поддерживать связь с существующими клиентами и привлекать новых. Таким образом, клиенты могут просто отсканировать QR-коды камерой своего мобильного устройства или ввести короткую ссылку, чтобы начать чат, без необходимости указывать номер телефона.

Вы можете просматривать, создавать, редактировать и удалять QR-коды и короткие ссылки в API управления бизнесом WhatsApp или в пользовательском интерфейсе менеджера бизнеса .

Ограничения

К одному номеру телефона WABA нельзя привязать более 2000 QR-кодов и коротких ссылок.

Сканирование QR-кода может запустить предварительно заполненное сообщение, содержащее до 140 символов текста.

Аналитические данные для QR-кодов и коротких ссылок недоступны, поскольку мы ограничиваем объем регистрируемых данных для защиты конфиденциальности пользователей.

Создать QR-код

Для создания QR-кода отправьте POST-запрос на WhatsApp Business Phone Number > Message Qrdls .

В теле вашего сообщения добавьте объект со prefilled_message , установленным на текст вашего сообщения, и generate_qr_image, установленным на предпочитаемый вами формат изображения, либо SVG , либо PNG .

Пример запроса

curl 'https://graph.facebook.com/ v25.0 /106540352242922/message_qrdls' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "prefilled_message": "Cyber Monday", "generate_qr_image": "SVG" }'

Пример ответа

{ "code": "4O4YGZEG3RIVE1", "prefilled_message": "Киберпонедельник 1", "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1", "qr_image_url": "https://scontent-iad3-2.xx.fbcdn.net/..." }

Получите список QR-кодов и коротких ссылок

Чтобы получить список всех QR-кодов для рабочего номера телефона, отправьте GET-запрос на WhatsApp Business Phone Number > Message Qrdls . Чтобы получить список существующих QR-кодов с помощью Business Manager, см . статью в Справочном центре .

Пример запроса

curl 'https://graph.facebook.com/ v25.0 /106540352242922/message_qrdls' \ - H 'Авторизация: Bearer EAAJB...'

Пример ответа

{ "data": [ { "code": "4O4YGZEG3RIVE1", "prefilled_message": "Киберпонедельник", "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1" }, { "code": "WOMVT6TJ2BP7A1", "prefilled_message": "Расскажите подробнее о вашем производственном семинаре", "deep_link_url": "https://wa.me/message/WOMVT6TJ2BP7A1" } ] }

Получите QR-код

Чтобы получить информацию о конкретном QR-коде, отправьте GET-запрос к WhatsApp Business Phone Number > Message Qrdls и добавьте идентификатор QR-кода в качестве параметра пути.

Пример запроса

curl 'https://graph.facebook.com/ v25.0 /106540352242922/message_qrdls/4O4YGZEG3RIVE1' \ - H 'Авторизация: Bearer EAAJB...'

Пример ответа

{ "data": [ { "code": "4O4YGZEG3RIVE1", "prefilled_message": "Киберпонедельник", "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1" } ] }

Обновить QR-код

Для обновления QR-кода отправьте POST-запрос на WhatsApp Business Phone Number > Message Qrdls .

В теле сообщения укажите `code` устанавливающее идентификатор QR-кода, который вы хотите обновить, и `prefilled_message`, устанавливающее текст нового QR-кода.

Пример запроса

curl 'https://graph.facebook.com/ v25.0 /106540352242922/message_qrdls' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "code": "4O4YGZEG3RIVE1", "prefilled_message": "Cyber Tuesday" }'

Пример ответа

{ "code": "4O4YGZEG3RIVE1", "prefilled_message": "Кибервторник", "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1" }

Удалить QR-код

QR-коды не удаляются автоматически. Чтобы удалить QR-код, отправьте запрос DELETE на WhatsApp Business Phone Number > Message Qrdls и добавьте идентификатор QR-кода, который вы хотите удалить, в качестве параметра пути. Инструкции по удалению QR-кодов с помощью Business Manager см. в статье Справочного центра .

Пример запроса

curl - X DELETE 'https://graph.facebook.com/ v25.0 /106540352242922/message_qrdls/4O4YGZEG3RIVE1' \ - H 'Авторизация: Bearer EAAJB...'

Пример ответа

{ "success": true }

Предварительно заполненные сообщения

QR-коды и короткие ссылки можно запрограммировать для заполнения предварительно заполненного сообщения. Предварительно заполненные сообщения могут содержать до 140 символов текста. Эти сообщения полностью настраиваемы и могут быть обновлены или удалены в любое время.

пользовательский опыт

Пользовательский сценарий	Ожидаемое поведение
Пользователь пытается получить доступ к коду или ссылке, которые были удалены.	Пользователь видит сообщение об ошибке: «Срок действия этого QR-кода [короткая ссылка] истек».
Пользователь сканирует QR-код или вводит короткую ссылку на компанию, которую он ранее заблокировал.	Пользователю предлагается разблокировать компанию, чтобы продолжить общение с ней.
Пользователь переходит по короткой ссылке в браузере на компьютере.	Настольный клиент запускается с сообщением, отображаемым в чате. Если клиент не установлен, пользователю предлагается его установить.

Передовые методы

Формат

Мы рекомендуем сохранять QR-код в виде масштабируемого векторного графического файла ( .svg ). Вы можете изменять размер QR-кода для разработки упаковки продукции, рекламных материалов и т.д.

Появление

Хотя мы не предоставляем возможность встроенной настройки QR-кодов, вы можете сделать это, загрузив и отредактировав QR-коды с помощью любого программного обеспечения по вашему выбору. Мы рекомендуем не изменять цвет или внешний вид самого кода, чтобы сохранить его читаемость.

Часто задаваемые вопросы

Как создать QR-код или короткую ссылку?

Сколько QR-кодов и коротких ссылок я могу создать?

К одному номеру телефона WABA нельзя привязать более 2000 QR-кодов и коротких ссылок.

Какой формат лучше всего использовать для оптимизации качества печати QR-кода?

Для обеспечения наилучшего качества печатной продукции мы рекомендуем использовать .svg

Как короткие ссылки могут улучшить существующие ссылки wa.me?

Новые короткие ссылки позволяют редактировать или удалять в любое время предварительно заполненные сообщения, связанные со ссылкой. Они также упрощают синтаксис URL-адреса до случайного кода, что устраняет необходимость встраивать сообщения в URL-адрес и скрывает номер телефона.

Что произойдет, если пользователь щелкнет по короткой ссылке на компьютере?

Если у пользователя установлен настольный клиент WhatsApp, он запустит чат с вашей компанией. В противном случае пользователю будет предложено установить настольный клиент WhatsApp.

Что происходит, когда пользователь сканирует QR-код или переходит по удаленной короткой ссылке?

Если пользователь попытается получить доступ к удаленному QR-коду или короткой ссылке, он увидит сообщение об ошибке, указывающее на то, что срок действия QR-кода/короткой ссылки истек.

Чем это отличается от QR-кодов, которые я уже генерирую в своей среде разработки?

Теперь QR-коды можно генерировать и управлять ими непосредственно в API управления бизнесом WhatsApp, а пользователи могут сканировать их с помощью камеры WhatsApp, iOS или Android.

Кроме того, с помощью QR-кодов WhatsApp

Предварительно заполненные сообщения полностью настраиваемы и могут быть изменены или удалены в любое времяПользователи всегда будут переходить непосредственно в приложение без каких-либо промежуточных страниц, иВстроенная в приложение информация об истекшем коде четко отображает сообщение для пользователя.

Как я могу гарантировать, что пользователи отсканируют код на нужном языке?

Вам предстоит использовать соответствующий QR-код в зависимости от предполагаемого местоположения и языка пользователей.

Будет ли доступна аналитика для отслеживания сканирования QR-кодов?