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

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

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

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

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

    Поля формы

    Метка поля Описание Пример значения
    Глубокая ссылка Android
    Обязательно. URI для глубоких ссылок Android.
    luckyshrub://deals/summer_solstice
    резервный URL для Android
    Необязательный. Резервный URL. Если клиент WhatsApp не может загрузить URI прямой ссылки, он загрузит этот URL в качестве резервного устройство'устройство's — веб-браузер по умолчанию.
    Если этот параметр опущен, клиент попытается загрузить 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

    Используйте ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates Конечная точка для создания шаблона и включения компонента кнопки URL, сопоставленного с вашей глубокой ссылкой Android.
    Обратите внимание, что вы также можете использовать ПОЧТА /<TEMPLATE_ID> Конечная точка для редактирования существующего шаблона и добавления компонента кнопки URL, но шаблон придется повторно проверить.

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

    Компоненты шаблона могут различаться в зависимости от ваших потребностей. В этом примере синтаксиса создается маркетинговый шаблон со следующими компонентами:
      текстовый заголовокбез параметровтелобез параметровкнопка URLсопоставляется с URI глубокой ссылки и резервным URL
      'https://graph.facebook.com/<API_VERSION>/<Идентификатор бизнес-аккаунта WhatsApp>/message_templates' \
      -H 'Content-Type: application/json' \
      -H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
      -д '
      {
        "имя": "<ИМЯ_ШАБЛОНА>",
        "язык": "<TEMPLATE_LANGUAGE>",
        "категория": "маркетинг",
        "компоненты": [
          {
            "type": "header",
            "формат": "текст",
            "текст": "<ЗАГОЛОВОК_ТЕКСТА>"
          },
          {
            "type": "body",
            "текст": "<BODY_TEXT>"
          },
          {
            "тип": "кнопки",
            "кнопки": [
              {
                "type": "url",
                "текст": "<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, привязанный к прямой ссылке.Глубокая ссылка Android URI. Клиент WhatsApp попытается загрузить этот URI, если пользователь WhatsApp нажмет кнопку на устройстве Android.
      luckyshrub://deals/summer/
      <API_VERSION>Нить
      Необязательный Graph API версия.
      v22.0
      <BODY_TEXT>Нить
      Обязательно при использовании компонента кузова. Шаблон основного текста. Поддерживаются переменные. Максимальное количество символов: 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

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

      локон'https://graph.facebook.com/v22.0/102290129340398/message_templates' \
      -ЧАС'Content-Type: application/json' \
      -ЧАС«Авторизация: Предъявитель EAAJB...» \
      '
      {
        "name": "summer_deals_deep_link_v1",
        "language": "en_US",
        "категория": "маркетинг",
        "компоненты": [
          {
            "type": "header",
            "формат": "текст",
            "текст": "Супервыгодные летние предложения в Lucky Shruб"
          },
          {
            "type": "body",
            "текст": "Спаситесь от жары с нашей восхитительной суммойВыгодные предложения на суккуленты! В Lucky Shrub мы..мы полны энтузиазма в отношении внедрения трогать Зелени в вашей жизни. Наши суккуленты не.. только низкий-обслуживание и просты в уходе дляно они также добавляют ярких красок и стиляВаша комната. Воспользуйтесь кнопкой ниже, чтобы посмотреть наши летние номераals!"
          },
          {
            "тип": "кнопки",
            "кнопки": [
              {
                "тип": "url",
                "текст": "Посмотреть предложения",
                "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/"
                }
              }
            ]
          }
        ]
      }'

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