Прямые ссылки | Документация для разработчиков
Прямые ссылки
Обновлено: 10 февраля 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
Вы можете сопоставить глубокую ссылку Android с кнопкой URL-адреса маркетингового шаблона, которая при нажатии загружает определенное местоположение или контент внутри вашего приложения.

Если вы еще не подключились к API маркетинговых сообщений для WhatsApp (MM API для WhatsApp), ваши маркетинговые шаблоны не будут отображать показатели конверсии. Узнайте больше о том, как измерять конверсию .
Создание шаблонов через WhatsApp Manager
Чтобы создать шаблон с кнопкой, привязанной к прямой ссылке в Android:
Обратите внимание, что вы также можете использовать «Управление шаблонами» для редактирования существующего шаблона и добавления кнопки с прямой ссылкой, но в этом случае шаблон потребуется повторно проверить.

Поля формы
| Метка поля | Описание | Пример значения |
|---|---|---|
Глубокая ссылка Android | Обязательно. URI для глубоких ссылок Android. | luckyshrub://deals/summer_solstice |
резервный URL для Android | Необязательно. Резервный URL. Если клиент WhatsApp не может загрузить URI прямой ссылки, он загрузит этот URL в веб-браузере по умолчанию устройства. Если этот параметр опущен, клиент попытается загрузить URL-адрес, указанный в поле «URL-адрес веб-сайта». | https://www.luckyshrub.com/deals/summer_solstice |
Текст кнопки | Обязательно. Текст надписи кнопки. Максимум 25 символов. | Посмотреть предложение |
Мета-идентификатор приложения | Обязательно. Это список приложений Meta, связанных с вашим бизнес-портфелем. Выберите приложение, токен доступа которого вы будете использовать для отправки шаблона. | Счастливый кустарник (634974688087057) |
Тип действия | Необходимый. Необходимо установить значение « Посетить веб-сайт» . | Посетите веб-сайт |
Тип URL | Обязательно. Установите значение Static, если ваша прямая ссылка для Android или резервный URL-адрес Android не содержат динамических значений, в противном случае установите значение Dynamic . | Статический |
URL веб-сайта | Необходимый. URL веб-сайта, который будет загружен, если пользователь WhatsApp просматривает сообщение на устройстве, отличном от Android, или если клиент WhatsApp не может загрузить ваш URI глубокой ссылки для Android и не указан резервный URL для Android. | https://www.luckyshrub.com/ |
Создание шаблонов через API
Используйте POST / /message_templates используется для создания шаблона и включения компонента кнопки URL, связанного с вашей глубокой ссылкой Android.
Обратите внимание, что вы также можете использовать POST / Конечная точка для редактирования существующего шаблона и добавления компонента кнопки URL, но шаблон придется повторно проверить.
Синтаксис запроса
Компоненты шаблона могут различаться в зависимости от ваших потребностей. В этом примере синтаксиса создается маркетинговый шаблон со следующими компонентами:
'https://graph.facebook.com/
< API_VERSION > / < WHATSAPP_BUSINESS_ACCOUNT_ID > /message_templates' \ -H 'Content-Type: application/json' \
-H 'Authorization: Bearer
< ACCESS_TOKEN > ' \ -d '
{
"name": "
< TEMPLATE_NAME > ", "language": "
< TEMPLATE_LANGUAGE > ", "category": "marketing",
"components": [
{
"type": "header",
"format": "text",
"text": "
< HEADER_TEXT > " },
{
"type": "body",
"text": "
< BODY_TEXT > " },
{
"type": "buttons",
"buttons": [
{
"type": "url",
"text": "
< BUTTON_LABEL_TEXT > ", "url": "
< BUTTON_URL > ", "app_deep_link": {
"meta_app_id":
< META_APP_ID > , "android_deep_link": "
< ANDROID_DEEP_LINK > ", "android_fallback_playstore_url": "
< FALLBACK_URL > " }
}
]
}
]
}'
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
Нить | Обязательно. Системный токен или бизнес-токен . | EAAJB... |
Нить | Требуется при использовании компонента кнопки URL, связанного с прямой ссылкой. URI прямой ссылки Android . Клиент WhatsApp попытается загрузить этот URI, если пользователь WhatsApp нажмет кнопку на устройстве Android. | luckyshrub://deals/summer/ |
Нить | Дополнительная версия Graph API . | v22.0 |
Нить | Обязательно при использовании компонента body. Шаблон текста body. Поддерживаются переменные. Максимальное количество символов: 1024. | Спаситесь от жары с нашими потрясающими летними предложениями на суккуленты! В Lucky Shrub мы... |
Нить | Обязательно при использовании компонента кнопки URL. Текст метки кнопки. Максимум 25 символов. | Посмотреть предложения |
Нить | Обязателен при использовании компонента кнопки URL. URL веб-сайта, который клиент WhatsApp попытается загрузить в веб-браузере по умолчанию устройства при нажатии кнопки. Для прямых ссылок этот URL будет использоваться только в том случае, если пользователь WhatsApp нажимает кнопку на устройстве, отличном от Android. | https://www.luckyshrub.com/deals/summer/ |
Нить | Обязательно, если используется кнопка URL, привязанная к прямой ссылке. URL веб-сайта, который клиент WhatsApp попытается загрузить в веб-браузере по умолчанию устройства при нажатии кнопки, но не сможет загрузить URI прямой ссылки Android. | https://www.luckyshrub.com/deals/summer/ |
Нить | Обязательно при использовании компонента текстового заголовка. Строка текста заголовка шаблона. Поддерживает до 1 параметра. Если эта строка содержит параметр, необходимо указать пример свойства. Максимальная длина 60 символов. | Восхитительные летние предложения в Lucky Shrub! |
Целое число | Обязательно, если используется кнопка URL, привязанная к прямой ссылке. Ваш идентификатор приложения Meta. | 634974688087057 |
Нить | Обязательно. шаблона и код локали . | en_US |
Нить | Обязательно. Название шаблона. Максимальное количество символов: 512. | summer_deals_deep_link_v1 |
Нить | Обязательно. Идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
Пример запроса
curl
'https://graph.facebook.com/v22.0/102290129340398/ message_templates' \ -H
'Content-Type: application/json' \ -H
'Authorization: Bearer EAAJB...' \ -d
' {
"name": "summer_deals_deep_link_v1",
"language": "en_US",
"category": "marketing",
"components": [
{
"type": "header",
"format": "text",
"text": "Sizzling Summer Deals at Lucky Shrub
" },
{
"type": "body",
"text": "Спаситесь от жары с нашими потрясающими летними
предложениями на суккуленты! В Lucky Shrub мы стремимся привнести немного зелени. Наши суккуленты не только неприхотливы и просты в уходе , но и добавляют ярких красок и стиля. в любую комнату. Используйте кнопку ниже, чтобы посмотреть наши летние предложения ! },
{
"
type ": " buttons ", "
buttons ": [ { "
type
" : " url ", "
text ": " View Deals ", "
url ": " https://www.luckyshrub.com/deals/summer/ ", "
app_deep_link ": { "
meta_app_id ": 634974688087057, "
android_deep_link ": " luckyshrub://deals/summer/ ", "
android_fallback_playstore_url ": " https://www.luckyshrub.com/deals/summer/ " } }
]
}
]
}
'
Показатели просмотров
См. наш с показателями просмотров .