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

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

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

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

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

Ограничения

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

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

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

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

~~Для создания QR-кода отправьте POST-запрос на адрес~~ ~~Номер телефона WhatsApp для бизнеса > Сообщения Qrdls~~ ~~конечная точка.~~

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

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

локон 'https://graph.facebook.com/v25.0/106540352242922/message_qrdls' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "prefilled_message": "Киберпонедельник", "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 для бизнеса > Сообщения Qrdls~~ ~~Конечная точка. Чтобы получить список существующих QR-кодов с помощью Business Manager, см. раздел..~~ ~~Статья в Справочном центре~~⁠.

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

локон 'https://graph.facebook.com/v25.0/106540352242922/message_qrdls' \
-ЧАС «Авторизация: Предъявитель 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 для бизнеса > Сообщения Qrdls~~ ~~и добавить идентификатор QR-кода в качестве параметра пути.~~

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

локон 'https://graph.facebook.com/v25.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-ЧАС «Авторизация: Предъявитель EAAJB...»

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

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

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

~~Для обновления QR-кода отправьте POST-запрос на адрес..~~ ~~Номер телефона WhatsApp для бизнеса > Сообщения Qrdls~~ ~~конечная точка.~~

~~В текст сообщения включите следующее:~~ код ~~в качестве свойства задается идентификатор QR-кода, который вы хотите обновить, а также~~ предварительно заполненное сообщение ~~Свойства установлены на новый текст QR-кода.~~

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

локон 'https://graph.facebook.com/v25.0/106540352242922/message_qrdls' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "code": "4O4YGZEG3RIVE1", "prefilled_message": "Кибервторник" }'

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

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

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

~~QR-коды не истекают автоматически. Для удаления QR-кода отправьте запрос DELETE~~ ~~Номер телефона WhatsApp для бизнеса > Сообщения Qrdls~~ Укажите конечную точку и добавьте идентификатор QR-кода, который вы хотите удалить, в качестве параметра пути. Чтобы использовать Business Manager для удаления QR-кодов, см. раздел ~~Статья в Справочном центре~~⁠.

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

локон -X УДАЛИТЬ 'https://graph.facebook.com/v25.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-ЧАС «Авторизация: Предъявитель 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-кодов?