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

Вспомогательные шаблоны | Документация для разработчиков

Вспомогательные шаблоны

Обновлено: 14 ноября 2025 г
В этом документе описывается, как создавать и отправлять шаблоны служебных файлов.
Вспомогательные шаблоны обычно отправляются в ответ на действие или запрос пользователя, например, подтверждение заказа или обновление информации.
Вспомогательные шаблоны имеют строгие требования к содержанию, особенно в отношении маркетинговых материалов. Если вы попытаетесь создать или обновить вспомогательный шаблон, добавив в него маркетинговые материалы, шаблон автоматически будет переклассифицирован как маркетинговый шаблон.
Рекомендации по классификации контента см. в нашей по категоризации шаблонов

Поддерживаемые компоненты

Вспомогательные шаблоны поддерживают следующие компоненты:
    1 заголовок (необязательно; поддерживаются все типы)1 тело1 нижний колонтитул (необязательно)До 10 кнопок (опционально). Поддерживаемые типы:
      Запрос на вызовСкопировать кодНомер телефонаБыстрый ответURL

      Создайте шаблон утилиты

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

      Используйте ПОЧТА/<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates Конечная точка для создания шаблона утилиты.
      curl 'https://graph.facebook.com/<API_VERSION>/<Идентификатор бизнес-аккаунта WhatsApp>/message_templates' \
      -H 'Content-Type: application/json' \
      -H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
      -д '
      {
        "имя": "<ИМЯ_ШАБЛОНА>",
        "язык": "<TEMPLATE_LANGUAGE>",
        "категория": "полезность",
        "parameter_format": "<ФОРМАТ ПАРАМЕТРА>",
        "компоненты": [

      <!-- header component optional -->
          {
            "type": "header",
            "формат": "<HEADER_TYPE>",
            "пример": {
              "header_handle": [
                "<HEADER_HANDLE>"
              ]
            }
          },

      <!-- body component required -->
          {
            "type": "body",
            "текст": "<BODY_TEXT>",

      <!-- example required if <BODY_TEXT>содержит один или больше параметров -->
            "пример": {
              "body_text_named_params": [
                {
                  "param_name": "<ИМЯ_ПАРАМЕТРА>",
                  "пример": "<PARAMETER_EXAMPLE_VALUE>"
                },

      <!-- additional parameters would follow, if using множественные параметры -->
              ]
            }
          },

      <!-- footer component optional -->
          {
            "type": "footer",
            "текст": "<FOOTER_TEXT>"
          },

      <!-- button components optional -->
          {
            "тип": "кнопки",
            "кнопки": [
              {
                "type": "url",
                "текст": "<URL_BUTTON_LABEL_TEXT>",
                "url": "<URL>"
              },
              {
                "type": "phone_number",
                "текст": "<Текст метки кнопки телефона>",
                "номер телефона": "<НОМЕР ТЕЛЕФОНА>"
              },
              {
                "type": "quick_reply",
                "текст": "<Текст метки кнопки быстрого ответа>"
              }
            ]
          }
        ]
      }'

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

      Заполнитель Описание Пример значения
      <ACCESS_TOKEN>
      Нить
      EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
      <API_VERSION>
      Нить
      Необязательный.
      Версия Graph API.
      v25.0
      <BODY_TEXT>
      Нить
      Необходимый.

      Шаблон основного текста. Поддерживаются переменные.

      Максимальное количество символов: 1024.
      Всё готово! Ваше бронирование на {{number_of_guests}} в Lucky Shrub Eatery на {{day}}, {{date}}, в {{time}} подтверждено. До встречи!
      <FOOTER_TEXT>
      Нить
      Необязательный.
      Шаблон текста нижнего колонтитула. Поддерживаются переменные
      Максимум 60 символов.
      Закусочная Lucky Shrub: Самая удачливая закусочная в городе!
      <HEADER_ASSET_HANDLE>
      Нить
      Обязательно, если используется заголовок с медиафайлом.
      Идентификатор ресурса примера медиафайла, загруженного в ваш аккаунт WhatsApp Business.
      Максимум 60 символов.
      4::aW1hZ2UvcG5n:ARYpf5zqqUjggwGfsZOJ2_o26Zs8ntcO2mss2vKpFb8P_IvskL043YXKpehYTD7IxqEB4t-uZcIzOTxO FRavEcN_tZLhk1WXFb3IOr4S8UKJcQ:e:1759093121:634974688087057:100089620928913:ARYyOAh63uQLhDpqOdk\ n4::aW1hZ2UvcG5n:ARZW8t9-cBNjpdmxV5Z9wcRAMhfmw4ATpJcJiHT0nY62hXq4ppOeBaTWaGI0IwX-twF2IkeKo-_MyW2pEDuBAE5vyw2oHTNgPZQkntclrgWMGg:e:1759093121:634974688087057:100089620928913:ARZE4NC5MrxnZUe5GRw
      <HEADER_TYPE>
      Нить
      Обязательно, если используется заголовок.
      Формат заголовка. Возможные значения:
        документацияизображениерасположениетекствидео
        изображение
        <PARAMETER_EXAMPLE_VALUE>
        Нить
        Обязательно, если используется строковый компонент тела документа, содержащий один или несколько параметров.
        Пример значения параметра. Необходимо указать пример для каждого параметра, определенного в строке компонента тела документа.
        Суббота
        <PARAMETER_NAME>
        Нить
        Обязательно при использовании именованных параметров.
        Это должна быть уникальная строка, состоящая из строчных букв и символов подчеркивания, заключенная в двойные фигурные скобки.
        {{день}}
        <PHONE_BUTTON_LABEL_TEXT>
        Нить
        Обязательно при использовании кнопки с номером телефона.
        Текст надписи на кнопке.
        Максимум 25 символов. Только буквенно-цифровые символы.
        Изменить бронирование
        <PHONE_NUMBER>
        Нить
        Обязательно, если используется компонент кнопки с номером телефона.
        Рабочий номер телефона, на который будет набран телефонный номер пользователя WhatsApp по умолчанию при нажатии пользователем.
        Обратите внимание, что в некоторых странах используются специальные телефонные номера, в начале которых после кода страны добавляются нули (например, +55-0-955-585-95436). Если вы назначите кнопке один из таких номеров, ведущий ноль будет удален. Если ваш номер не будет работать без ведущего нуля, назначьте кнопке другой номер или добавьте номер в качестве сообщения
        Максимум 20 символов. Только буквенно-цифровые символы.
        15550051310
        <QUICK_REPLY_BUTTON_LABEL_TEXT>
        Обязательно при использовании кнопки быстрого ответа.
        Текст надписи на кнопке.
        Максимум 25 символов. Только буквенно-цифровые символы.
        Отменить бронирование
        <TEMPLATE_LANGUAGE>
        Нить
        Необходимый.
        en_US
        <TEMPLATE_NAME>
        Нить
        Необходимый.
        Название шаблона. Должно быть уникальным, за исключением случаев, когда существующие шаблоны с тем же именем имеют другой язык программирования.
        Максимум 512 символов. Только строчные буквы, буквы и цифры, а также символы подчеркивания.
        подтверждение бронирования
        <URL>
        Нить
        Обязательно, если добавляется кнопка с URL-адресом.
        URL-адрес, который будет загружен в веб-браузере пользователя WhatsApp по умолчанию при нажатии.
        https://www.luckyshrubeater.com/reservations
        <URL_BUTTON_LABEL_TEXT>
        Нить
        Обязательно, если используется кнопка с URL-адресом.
        Текст надписи на кнопке.
        Максимум 25 символов. Только буквенно-цифровые символы.
        Изменить бронирование
        <WHATSAPP_BUSINESS_ACCOUNT_ID>
        Необходимый.
        Идентификатор бизнес-аккаунта WhatsApp.
        546151681022936

        Синтаксис ответа

        В случае успеха:
        {
          "идентификатор": "<TEMPLATE_ID>",
          "статус": "<TEMPLATE_STATUS>",
          "категория": "<TEMPLATE_CATEGORY>"
        }

        Параметры отклика

        Заполнитель Описание Пример значения
        <TEMPLATE_CATEGORY>
        КОММУНАЛЬНЫЕ УСЛУГИ
        <TEMPLATE_ID>
        Идентификатор шаблона.
        546151681022936
        <TEMPLATE_STATUS>
        В ОЖИДАНИИ

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

        В этом примере запроса создается шаблон утилиты, содержащий:
          компонент заголовка изображенияКомпонент тела запроса, содержащий строку с четырьмя именованными параметрамикомпонент нижнего колонтитулакомпонент кнопки URLкомпонент кнопки с номером телефонакомпонент кнопки быстрого ответа
          curl 'https://graph.facebook.com/v23.0/102290129340398/message_шаблоны' \
          -H 'Content-Type: application/json' \
          -H 'Авторизация: Предъявитель EAAJB...' \
          -д '
          {
          "имя""подтверждение_бронирования",
          "язык""en_US",
          "категория"«полезность»,
          "parameter_format""названный",
          «компоненты»: [
              {
          "тип""заголовок",
          "формат""изображение",
          "пример": {
          "header_handle": [
          "4::aW..."
                  ]
                }
              },
              {
          "тип""тело",
          "текст"«*Всё готово!*\n\nВаша бронь на {{number_of_guests}} в Lucky Shrub Eatery в {{day}}, {{Дата {{время}} подтверждена. До встречи!,
          "пример": {
          "body_text_named_params": [
                    {
          "param_name""количество_гостей",
          "пример""4"
                    },
                    {
          "param_name""день",
          "пример""Суббота"
                    },
                    {
          "param_name""дата",
          "пример"«30 августа 2025 года»
                    },
                    {
          "param_name""время",
          "пример"«19:30»
                    }
                  ]
                }
              },
              {
          "тип"«нижний колонтитул»,
          "текст"«Lucky Shrub Eatery: Самое удачливое заведение в городе!»
              },
              {
          "тип""кнопки",
          "кнопки": [
                  {
          "тип""url",
          "текст""Изменить бронирование",
          "url""https://www.luckyshrubeater.com/reservations"
                  },
                  {
          "тип""номер телефона",
          "текст"«Позвоните нам»,
          "номер телефона""+15550051310"
                  },
                  {
          "тип""быстрый_ответ",
          "текст""Отменить бронирование"
                  }
                ]
              }
            ]
          }'

          Пример ответа

          {
          "идентификатор""546151681022936",
          «статус»"В ОЖИДАНИИ",
          "категория""Утилиты"
          }

          Отправить шаблон служебной программы

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

          Используйте ПОЧТА/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщение Конечная точка для отправки утвержденного шаблона утилиты в сообщении шаблона.
          curl 'https://graph.facebook.com/<API_VERSION> /ESSS_PHONE_NUMBER_ID>/messages' \
          -H 'Content-Type: application/json' \
          -H 'Авторизация: Предъявитель'<ACCESS_TOKEN> ' \
          -д '
          {
          "messaging_product""WhatsApp",
          "recipient_type""индивидуальный",
          "к""<WHATSAPP_USER_PHONE_NUMBER> ",
          "тип""шаблон",
          "шаблон": {
          "имя""<TEMPLATE_NAME> ",
          "язык": {
          "код""<TEMPLATE_LANGUAGE> "
              },
          «компоненты»: [

                <!-- Only required if the template uses a meКомпонент заголовка dia -->
                {
          "тип""заголовок",
          "параметры": [
                    {
          "тип""<MEDIA_HEADER_TYPE> ",
          "<MEDIA_HEADER_TYPE> ": {
          "идентификатор""<MEDIA_HEADER_ASSET_ID> "
                      }
                    }
                  ]
                },

                <!-- Only required if the template uses body Параметры компонентов -->
                {
          "тип""тело",
          "параметры": [
                    {
          "тип""<NAMED_PARAM_TYPE> ",
          "parameter_name""<NAMED_PARAM_NAME> ",
          "текст""<NAMED_PARAM_VALUE> "
                    },

                    <!-- Additional parameters values would При необходимости следуйте инструкциям -->

                  ]
                }
              ]
            }
          }'

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

          Заполнитель Описание Пример значения
          <ACCESS_TOKEN>
          Нить
          EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
          <API_VERSION>
          Нить
          Необязательный
          Версия API. Если этот параметр опущен, по умолчанию используется самая новая версия API, доступная для вашего приложения.
          v25.0
          <MEDIA_HEADER_ASSET_ID>
          Нить
          Обязательно, если шаблон использует компонент заголовка медиафайлов.
          2871834006348767
          <MEDIA_HEADER_TYPE>
          Нить
          Обязательно, если шаблон использует компонент заголовка медиафайлов.
          Тип заголовка медиафайла. Возможные значения:
            документизображениевидео
            Обратите внимание, что этот заполнитель встречается дважды в синтаксисе запроса, приведенном выше.
            изображение
            <NAMED_PARAM_NAME>
            Обязательно, если шаблон использует параметры компонента тела.
            Имя параметра, определенное в текстовой строке компонента тела шаблона.
            количество_гостей
            <NAMED_PARAM_TYPE>
            Обязательно, если шаблон использует параметры компонента тела.
            Тип параметра. Установите значение «текст».
            текст
            <NAMED_PARAM_VALUE>
            Обязательно, если шаблон использует параметры компонента тела.
            Значение параметра.
            4
            <TEMPLATE_LANGUAGE>
            Нить
            Необходимый.
            en_US
            <TEMPLATE_NAME>
            Нить
            Необходимый.
            Название шаблона. Должно быть уникальным, за исключением случаев, когда существующие шаблоны с тем же именем имеют другой язык программирования.
            Максимум 512 символов. Только строчные буквы, буквы и цифры, а также символы подчеркивания.
            подтверждение бронирования
            <WHATSAPP_BUSINESS_ACCOUNT_ID>
            Необходимый.
            Идентификатор бизнес-аккаунта WhatsApp.
            546151681022936
            <WHATSAPP_USER_PHONE_NUMBER>
            Необходимый.
            Номер телефона пользователя WhatsApp.
            16505551234

            Синтаксис ответа

            В случае успеха:
            {
            "messaging_product""WhatsApp",
            "контакты": [
                {
            "вход""<WHATSAPP_USER_PHONE_NUMBER> ",
            "ва_ид""<WHATSAPP_USER_ID> "
                }
              ],
            "сообщения": [
                {
            "идентификатор""<WHATSAPP_MESSAGE_ID> ",
            "message_status""<PACING_STATUS> "
                }
              ]
            }

            Параметры отклика

            Заполнитель Описание Пример значения
            <PACING_STATUS>
            принял
            <WHATSAPP_MESSAGE_ID>
            Идентификатор сообщения WhatsApp.
            Этот идентификатор включен в статус сообщения вебхуки для отслеживания статуса доставки.
            wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJBRkJENzExMTRFRjk2NTI1OTEA
            <WHATSAPP_USER_ID>
            Идентификатор пользователя WhatsApp. Может не совпадать с введенным значением.
            16505551234
            <WHATSAPP_USER_PHONE_NUMBER>
            Номер телефона пользователя WhatsApp. Может не совпадать со значением wa_id.
            16505551234

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

            Это пример запроса, который отправляет шаблон, созданный в приведенном выше примере запроса на создание шаблона.
            curl 'https://graph.facebook.com/v23.0/106540352242922/messageс' \
            -H 'Content-Type: application/json' \
            -H 'Авторизация: Предъявитель EAAJB...' \
            -д '
            {
            "messaging_product""WhatsApp",
            "recipient_type""индивидуальный",
            "к""16505551234",
            "тип""шаблон",
            "шаблон": {
            "имя""подтверждение_бронирования",
            "язык": {
            "код""en_US"
                },
            «компоненты»: [
                  {
            "тип""заголовок",
            "параметры": [
                      {
            "тип""изображение",
            "изображение": {
            "идентификатор""2871834006348767"
                        }
                      }
                    ]
                  },
                  {
            "тип""тело",
            "параметры": [
                      {
            "тип""текст",
            "parameter_name""количество_гостей",
            "текст""4"
                      },
                      {
            "тип""текст",
            "parameter_name""день",
            "текст""Суббота"
                      },
                      {
            "тип""текст",
            "parameter_name""дата",
            "текст"«30 августа 2025 года»
                      },
                      {
            "тип""текст",
            "parameter_name""время",
            "текст"«19:30»
                      }
                    ]
                  }
                ]
              }
            }'

            Пример ответа

            {
            "messaging_product""WhatsApp",
            "контакты": [
                {
            "вход""16505551234",
            "ва_ид""16505551234"
                }
              ],
            "сообщения": [
                {
            "идентификатор""wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJBRkJENzExMTRFRjk2NTI1OTEA",
            "message_status""принял"
                }
              ]
            }