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

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

Обновлено: 10 февраля 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
You can map an Глубокая ссылка Android⁠? to a marketing template URL button that, when tapped, loads a particular location or content within your app.
Если вы еще не подключились к API маркетинговых сообщений для WhatsApp (MM API для WhatsApp), ваши маркетинговые шаблоны не будут отображать показатели конверсии. Узнайте больше о том, как измерять конверсию .

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

Чтобы создать шаблон с кнопкой, привязанной к прямой ссылке в Android:
    Access Менеджер WhatsApp⁠?.Перейдите в «Шаблоны сообщений» > «Управление шаблонами» и нажмите «Создать шаблон» .Выберите вкладку «Маркетинг «Настройка » (переключатель) и нажмите «Далее» .В «Кнопки» нажмите на «+ Добавить кнопки» и выберите «Посетить веб-сайт» .Установите «Отслеживать конверсии приложения» , чтобы отобразить поля для прямых ссылок (изображение ниже).Заполните каждое поле, используя в качестве ориентира всплывающие подсказки или описания полей формы Add any additional components ты'ты'd like your template to use, name your template, and submit it for approval.
    Обратите внимание, что вы также можете использовать «Управление шаблонами» для редактирования существующего шаблона и добавления кнопки с прямой ссылкой, но в этом случае шаблон потребуется повторно проверить.

    Поля формы

    Метка поля Описание Пример значения
    Глубокая ссылка Android
    Обязательно. URI для глубоких ссылок Android.
    luckyshrub://deals/summer_solstice
    резервный URL для Android
    Необязательный. Fallback URL. If the WhatsApp client cannot load the deep link URI, the client will load this URL in the устройство'устройство's default web browser.
    Если этот параметр опущен, клиент попытается загрузить 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/

    Шаблон creation via API

    Используйте ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates endpoint to create the template and include a URL button component mapped to your Android deep link.
    Note that you can also use the ПОЧТА /<TEMPLATE_ID> endpoint to edit an existing template and add a URL button component, but the template will have to undergo template review again.

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

    Компоненты шаблона могут различаться в зависимости от ваших потребностей. В этом примере синтаксиса создается маркетинговый шаблон со следующими компонентами:
      text header, without parametersтело, without parametersкнопка URL, mapped to a deep link URI and fallback URL
      'https://graph.facebook.com/<API_VERSION>/<Идентификатор бизнес-аккаунта WhatsApp>/message_templates' \
      -H 'Content-Type: application/json' \
      -H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
      -д '
      {
        "имя": "<ИМЯ_ШАБЛОНА>",
        "язык": "<TEMPLATE_LANGUAGE>",
        "category": "marketing",
        "компоненты": [
          {
            "type": "header",
            "format": "text",
            "текст": "<HEADER_TEXT>"
          },
          {
            "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>Нить
      Required if using a URL button component mapped to a deep link.Глубокая ссылка Android⁠ URI. The WhatsApp client will attempt to load this URI if the WhatsApp user taps the button on an Android device.
      luckyshrub://deals/summer/
      <API_VERSION>Нить
      Необязательный
Graph API version.
      v22.0
      <BODY_TEXT>Нить
      Required if using a body component.
Template body text. Variables are supported. Maximum 1024 characters.
      Спаситесь от жары с нашими потрясающими летними предложениями на суккуленты! В Lucky Shrub мы...
      <BUTTON_LABEL_TEXT>Нить
      Required if using a URL button component.
Button label text. Maximum 25 characters.
      Посмотреть предложения
      <BUTTON_URL>Нить
      Required if using a URL button component.
URL of a website that the WhatsApp client will attempt to load in the device’s default web browser when the button is tapped. For deep links, this URL only be used if the WhatsApp user taps the button on a non-Android device.
      https://www.luckyshrub.com/deals/summer/
      <FALLBACK_URL>Нить
      Required if using a URL button mapped to a deep link.
URL of a website that the WhatsApp client will attempt to load in the device’s default web browser when the button is tapped but unable to load the Android deep link URI.
      https://www.luckyshrub.com/deals/summer/
      <HEADER_TEXT>Нить
      Обязательно при использовании компонента текстового заголовка.
Template header text string. Supports up to 1 parameter. If this string contains a parameter, you must include an пример property. Maximum 60 characters.
      Восхитительные летние предложения в Lucky Shrub!
      <META_APP_ID>Целое число
      Required if using a URL button mapped to a deep link.
Your Meta app ID.
      634974688087057
      <TEMPLATE_LANGUAGE>Нить
      Необходимый.
Шаблон языковой и локализованный код.
      en_US
      <TEMPLATE_NAME>Нить
      Необходимый.
Template name. Maximum 512 characters.
      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",
        "category": "marketing",
        "компоненты": [
          {
            "type": "header",
            "format": "text",
            "text": "Sizzling Summer Deals at Lucky Shrub"
          },
          {
            "type": "body",
            "text": "Beat the heat with our sizzling summer deals on succulents! At Lucky Shrub, we're passionate about bringing a touch of greenery to your life. Our succulents are not only low-maintenance and easy to care для, but they also add a pop of color and style to any room. Use the button below to see our Summer Steals!"
          },
          {
            "тип": "кнопки",
            "кнопки": [
              {
                "тип": "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/"
                }
              }
            ]
          }
        ]
      }'
      Показатели просмотров
      

      
    
              
      
    
      

            
      
        
      
    
      

    
      

    
    
      
        
      
             Вернуться наверх