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

Прямые ссылки

Обновлено: 10 февраля 2026 г

API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.

Вы можете сопоставить глубокую ссылку Androidс кнопкой URL-адреса маркетингового шаблона, которая при нажатии загружает определенное местоположение или контент внутри вашего приложения.

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

Создание шаблонов через WhatsApp Manager

Чтобы создать шаблон с кнопкой, привязанной к прямой ссылке в Android:

Откройте WhatsApp.ManagerПерейдите в «Шаблоны сообщений» > «Управление шаблонами» и нажмите «Создать шаблон» .Выберите «Маркетинг вкладку «Настройка » (переключатель) и нажмите «Далее» .В «Кнопки» нажмите на «+ Добавить кнопки» и выберите «Посетить веб-сайт».Установите «Отслеживать конверсии приложения» , чтобы отобразить поля для прямых ссылок (изображение ниже).Заполните каждое поле, используя в качестве ориентира всплывающие подсказки или полей формы описанияДобавьте любые дополнительные компоненты, которые вы хотите использовать в своем шаблоне, дайте ему имя и отправьте на утверждение.

Обратите внимание, что вы также можете использовать «Управление шаблонами» для редактирования существующего шаблона и добавления кнопки с прямой ссылкой, но в этом случае шаблон потребуется повторно проверить.

Поля формы

Метка поля	Описание	Пример значения
Глубокая ссылка 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 / Конечная точка для создания шаблона и включения компонента кнопки URL, сопоставленного с вашей глубокой ссылкой Android.

Обратите внимание, что вы также можете использовать POST / Конечная точка для редактирования существующего шаблона и добавления компонента кнопки URL, но шаблон придется повторно проверить.

Синтаксис запроса

Компоненты шаблона могут различаться в зависимости от ваших потребностей. В этом примере синтаксиса создается маркетинговый шаблон со следующими компонентами:

текстовый заголовокбез параметровтело, без параметровКнопка URL, сопоставленная с URI прямой ссылки и резервным 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>"
          }
        }
      ]
    }
  ]
}'

Параметры запроса

Заполнитель	Описание	Пример значения
`<ACCESS_TOKEN>`Нить	Обязательно.Системный токен или бизнес-токен.	`EAAJB...`
`<ANDROID_DEEP_LINK>`Нить	Требуется при использовании компонента кнопки URL, связанного с прямой ссылкой.прямой ссылки AndroidURI . Клиент WhatsApp попытается загрузить этот URI, если пользователь WhatsApp нажмет кнопку на устройстве Android.	`luckyshrub://deals/summer/`
`<API_VERSION>`Нить	Дополнительная Graph API версия.	`v22.0`
`<BODY_TEXT>`Нить	Обязательно при использовании компонента body. Шаблон текста body. Поддерживаются переменные. Максимальное количество символов: 1024.	`Спаситесь от жары с нашими потрясающими летними предложениями на суккуленты! В Lucky Shrub мы...`
`<BUTTON_LABEL_TEXT>`Нить	Обязательно при использовании компонента кнопки URL. Текст метки кнопки. Максимум 25 символов.	`Посмотреть предложения`
`<BUTTON_URL>`Нить	Обязателен при использовании компонента кнопки URL. URL веб-сайта, который клиент WhatsApp попытается загрузить в веб-браузере по умолчанию устройства при нажатии кнопки. Для прямых ссылок этот URL будет использоваться только в том случае, если пользователь WhatsApp нажимает кнопку на устройстве, отличном от Android.	`https://www.luckyshrub.com/deals/summer/`
`<FALLBACK_URL>`Нить	Обязательно, если используется кнопка URL, привязанная к прямой ссылке. URL веб-сайта, который клиент WhatsApp попытается загрузить в веб-браузере по умолчанию устройства при нажатии кнопки, но не сможет загрузить URI прямой ссылки Android.	`https://www.luckyshrub.com/deals/summer/`
`<HEADER_TEXT>`Нить	Обязательно при использовании компонента текстового заголовка. Строка текста заголовка шаблона. Поддерживает до 1 параметра. Если эта строка содержит параметр, необходимо указать `пример` свойства. Максимальная длина 60 символов.	`Восхитительные летние предложения в Lucky Shrub!`
`<META_APP_ID>`Целое число	Обязательно, если используется кнопка URL, привязанная к прямой ссылке. Ваш идентификатор приложения Meta.	`634974688087057`
`<TEMPLATE_LANGUAGE>`Нить	Обязательно. шаблона и код локали.	`en_US`
`<TEMPLATE_NAME>`Нить	Обязательно. Название шаблона. Максимальное количество символов: 512.	`summer_deals_deep_link_v1`
`<WHATSAPP_BUSINESS_ACCOUNT_ID>`Нить	Обязательно. Идентификатор бизнес-аккаунта 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/"
          } }
        ]
      }
    ]
  }
'

Показатели просмотров

См. наш с показателями просмотров .