Перейти к основному содержимому

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

Обновлено: 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 / /message_templates используется для создания шаблона и включения компонента кнопки 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 > " }
      }
      ]
      }
      ]
      }'

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

      Заполнитель Описание Пример значения
      Нить
      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/ " } }
      ]
      }
      ]
      }
      '

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