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

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

Библиотека шаблонов

Обновлено: 14 ноября 2025 г
Библиотека шаблонов позволяет компаниям быстрее и проще создавать шаблоны для распространенных сценариев использования, таких как напоминания об оплате и обновления статуса доставки - а также шаблоны аутентификации для распространенных сценариев проверки личности.
Эти готовые шаблоны уже отнесены к категориям «утилитарные» или «аутентификационные». Шаблоны библиотеки содержат фиксированное содержимое, которое нельзя редактировать, и параметры, которые можно адаптировать для бизнес-задач или конкретных пользователей.
Вы можете просматривать и создавать шаблоны, используя библиотеку шаблонов в WhatsApp Manager, или программно через API.

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

Следуйте приведенным ниже инструкциям, чтобы создать шаблоны с помощью библиотеки шаблонов Менеджер WhatsApp?.
1: На боковой панели WAM, в разделе «Шаблоны сообщений», выберите «Создать шаблон».
Изображение
2: В разделе «Просмотр библиотеки шаблонов WhatsApp»выберите «Просмотреть шаблоны».
Изображение
3: Теперь вы увидите все доступные шаблоны. Используйте строку поиска для поиска по теме или варианту использования, или воспользуйтесь выпадающими списками на боковой панели для фильтрации результатов.
Обратите внимание, что при наведении курсора на шаблон отобразятся значения его параметров.
Изображение
4. Чтобы создать шаблон, выберите его , щелкнув по нему. Затем добавьте название шаблона, выберите язык и заполните поля для кнопок. После выполнения этих шагов нажмите « Отправить».
Примечание: Если вы выберете «Настроить шаблон», ваш шаблон должен пройти проверку перед отправкой сообщений.
Изображение

Параметры и ограничения шаблона

Когда шаблон содержит значение library_template_name в запросе GET В ответ на это следует понимать, что это шаблон, созданный на основе библиотеки шаблонов, и он подлежит проверке типов и ограничениям.
ИзображениеИзображениеИзображение
В библиотеке шаблонов содержатся как фиксированные элементы, так и параметры. Параметры представляют собой поля в шаблоне, куда можно вставлять переменную информацию, такую ​​как имена, адреса и номера телефонов.
В приведенном выше примере параметры, такие как имя, Джим или название компании CS Mutual можно изменить, чтобы он принимал переменные, подобные вашей клиент'клиент'имя и ваше бизнес'бизнес'имя.
Сообщения, отправляемые с использованием шаблонов из библиотеки шаблонов, подвергаются проверке параметров во время отправки. Значения параметров, выходящие за пределы установленных диапазонов, указанных ниже, приведут к сбою отправки сообщения.

Список параметров и примерные значения

Все параметры имеют ограничения по длине. Если вы получили ошибку, попробуйте еще раз, указав меньшее значение.
Тип параметра Описание Пример значения
АДРЕС
Адрес местоположения.
    Адрес должен быть действительным
      1 Hacker Way, Menlo Park, CA 94025
      ТЕКСТ
      Основной текст.
        относительно вашего заказа.Упаковка из 12 бумажных полотенецваш запроспокупкаРынок Джаспера
        КОЛИЧЕСТВО
        Число, обозначающее количество.
          Может содержать префикс или суффикс для обозначения денежных значений, таких как USD или RSМожет содержать десятичные знаки (.) и запятые (,)Может содержать допустимые символы валюты, такие как $ и ?
            145375,32 долларов США?1 376,22 евроРС 1200
            ДАТА
            Стандартная календарная дата.
              2021-04-1913/03/20215 января 1982 года08.22.19911 января 2024 г05 12 2022
              НОМЕР ТЕЛЕФОНА
              Номер телефона.
                Может содержать цифры, пробелы, дефисы (-), скобки и символы плюса (+)
                  +1 4256789900+91-7884-789122+39 87 62232
                  ЭЛЕКТРОННАЯ ПОЧТА
                  Стандартный адрес электронной почты.
                    Необходимо указать действительный адрес электронной почты
                    ЧИСЛО
                    Число.
                      Должно быть, это число.Не может содержать пробелы.
                        2344490001234921388904453638

                        Формы

                        Формы Доступны только для учетных записей, у которых был увеличен лимит сообщений.
                        Изображение
                        Некоторые шаблоны в библиотеке шаблонов представляют собой интерактивные формы, работающие на основе WhatsApp Flows.
                        В WhatsApp Manager эти шаблоны можно определить по пометке «Форма». В настоящее время поддерживаются следующие сценарии использования: «Отзыв клиента» и «Сбой доставки».

                        Идентификация форм в ответе на запрос

                        При вызове GET /message_template_library конечная точка, тип ключ в кнопки массив отобразится как "ФОРМЫ".
                        {
                        "имя""delivery_failed_2_form",
                        "язык""en_US",
                        "категория""Утилиты",
                        "тема"«УПРАВЛЕНИЕ ЗАКАЗАМИ»,
                        «вариант использования»"ДОСТАВКА НЕ УДАЛАСЬ",
                        "промышленность": [
                        "Электронная коммерция"
                              ],
                        "тело"«Сегодня мы не смогли доставить заказ {{1}}».

                        Пожалуйста, {{2}}, чтобы запланировать еще одну попытку доставки.",
                        "body_params": [
                        "#12345",
                        "Попробуйте повторную доставку"
                              ],
                        "body_param_types": [
                        "ТЕКСТ",
                        "ТЕКСТ"
                              ],
                        "кнопки": [
                                {
                        "тип""ПОТОК",
                        "текст""Перенести"
                                }
                              ],
                        "идентификатор""7138055039625658"
                        },

                        Использование API

                        API библиотеки шаблонов имеет две конечные точки:
                        // Используется для просмотра доступных шаблонов библиотеки
                        ПОЛУЧАТЬ /message_template_library
                        // Используется, когда вы готовы создать шаблон из библиотеки.
                        ПОЧТА /<Идентификатор бизнес-аккаунта WhatsApp>/шаблоны сообщений

                        Поиск и фильтрация доступных шаблонов

                        Шаблоны с Заголовок типы параметров Документ поддерживаются только PDF-файлы
                        Для просмотра и фильтрации доступных шаблонов используйте message_template_library конечная точка.
                        Найдя интересующий вас шаблон, запишите его название, так как оно понадобится вам при создании шаблона ПОЧТА метод.

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

                        // Получить все доступные шаблоны
                        ПОЛУЧАТЬ /message_template_library
                        
                        // Поиск подстроки
                        ПОЛУЧАТЬ /message_template_library?поиск=<SEARCH_KEY>// Фильтрация по теме шаблона
                        ПОЛУЧАТЬ/message_template_library?тема=<ТЕМА>// Фильтрация по варианту использования шаблона
                        ПОЛУЧАТЬ/message_template_library?вариант использования=<ПРИМЕР ИСПОЛЬЗОВАНИЯ>// Фильтрация по отраслям шаблонов
                        ПОЛУЧАТЬ/message_template_library?промышленность=<ОТРАСЛЬ>// Фильтрация по языку шаблона
                        ПОЛУЧАТЬ/message_template_library?язык=<ЯЗЫК>

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

                        Заполнитель Описание Пример значения
                        <SEARCH_KEY>
                        Нить
                        Необязательный.

                        Искомая подстрока в содержимом, имени, заголовке, теле или нижнем колонтитуле шаблона.
                        платежи
                        <TOPIC>
                        Перечисление
                        Необязательный.

                        Тема шаблона.
                        См. фильтры шаблонов ниже
                        УПРАВЛЕНИЕ ЗАКАЗАМИ
                        <USECASE>
                        Перечисление
                        Необязательный.

                        Пример использования шаблона.
                        См. фильтры шаблонов ниже
                        ПОДТВЕРЖДЕНИЕ ОТПРАВКИ
                        <INDUSTRY>
                        Перечисление
                        Необязательный.

                        Индустрия шаблонов.
                        См. фильтры шаблонов ниже
                        Электронная коммерция
                        <LANGUAGE>
                        Перечисление
                        Необязательный.

                        Код локализации для языка шаблона.
                        Видеть Поддерживаемые языки
                        en_US

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

                        локон 'https://graph.facebook.com/v25.0/102290129340398/message_templates?search="payments"'-ЧАС «Авторизация: Предъявитель EAAJB...»

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

                        {
                        "имя""low_balance_warning_1",
                        "язык""en_US",
                        "категория""Утилиты",
                        "тема""ПЛАТЕЖИ",
                        «вариант использования»"ПРЕДУПРЕЖДЕНИЕ О НИЗКОМ БАЛАНСЕ",
                        "промышленность": [
                        "ФИНАНСОВЫЕ_УСЛУГИ"
                              ],
                        "заголовок"«На вашем счете низкий баланс»,
                        "тело""Привет {{1}},
                        Это сообщение для вас, чтобы сообщить, что ваш {{2}} находится в вашем {{3}} аккаунт, заканчивающийся на {{4}}, находится ниже вашего предварительно установленного {{5}} из {{6}}.
                        Нажмите кнопку, чтобы внести еще {{7}}.
                        {{8}}",
                        "body_params": [
                        "Джим",
                        «доступные средства»,
                        «CS Mutual checking plus»,
                        "1234",
                        "лимит",
                        "$75.00",
                        "фонды",
                        «CS Mutual»
                              ],
                        "кнопки": [
                                {
                        "тип""URL",
                        "текст""Внесите депозит",
                        "url""https://www.example.com/"
                                },
                                {
                        "тип""НОМЕР ТЕЛЕФОНА",
                        "текст"«Позвоните нам»,
                        "номер телефона""+18005551234"
                                }
                              ],
                        "идентификатор""7147013345418927"
                        }

                        Фильтры шаблонов

                        В библиотеке шаблонов представлено несколько шаблонов на выбор. Вы можете использовать API для их фильтрации по нескольким параметрам.
                        Промышленность
                          Электронная коммерцияФИНАНСОВЫЕ_УСЛУГИ
                          Тема
                            ОБНОВЛЕНИЕ УЧЕТНОЙ ЗАПИСИОТЗЫВЫ КЛИЕНТОВУПРАВЛЕНИЕ ЗАКАЗАМИПЛАТЕЖИ
                            Вариант использования
                              ПОДТВЕРЖДЕНИЕ СОЗДАНИЯ УЧЕТНОЙ ЗАПИСИАВТОМАТИЧЕСКОЕ НАПОМИНАНИЕ ОБ ОПЛАТЕПОДТВЕРЖДЕНИЕ ДОСТАВКИДОСТАВКА НЕ УДАЛАСЬОБНОВЛЕНИЕ ДОСТАВКИОпрос обратной связиПРЕДУПРЕЖДЕНИЕ О МОШЕННИЧЕСТВЕПРЕДУПРЕЖДЕНИЕ О НИЗКОМ БАЛАНСЕORDER_ACTION_NEEDEDПОДТВЕРЖДЕНИЕ ЗАКАЗАORDER_DELAYОТМЕНА ЗАКАЗА ИЛИ ТРАНЗАКЦИИЗАКАЗ_САМОВЫВОЗТРЕБУЕТСЯ ПЛАТЕЖНОЕ ДЕЙСТВИЕПОДТВЕРЖДЕНИЕ ПЛАТЕЖАНАПОМИНАНИЕ О СРОКЕ ОПЛАТЫПРОСРОЧЕННЫЙ ПЛАТЕЖPAYMENT_REJECT_FAILПЛАТЕЖ_ЗАПЛАНИРОВАНПРИЛОЖЕНИЕ_ЧЕКАRETURN_CONFIRMATIONПОДТВЕРЖДЕНИЕ ОТПРАВКИПРИЛОЖЕНИЕ_ЗАЯВЛЕНИЯЗАЯВЛЕНИЕ ДОСТУПНОTRANSACTION_ALERT

                              Создание шаблонов

                              Примечание: Изменение правил, касающихся свойств тела запроса для этой конечной точки, предназначено исключительно для демонстрации того, как использовать эту конечную точку с библиотекой шаблонов.
                              Чтобы создать новый шаблон с помощью библиотеки шаблонов, вызовите существующий <WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates Конечная точка с использованием указанных ниже свойств тела запроса.

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

                              ПОЧТА /<Идентификатор бизнес-аккаунта WhatsApp>/шаблоны сообщений

                              Тело поста

                              {
                              "имя""<NAME> ",
                              "категория""Утилиты",
                              "язык""en_US",
                                “library_template_name”: «<LIBRARY_TEMPLATE_NAME> ”,
                              "library_template_button_inputs""[
                                  {'type': 'URL', 'url': {'base_url' : 'https://www.example.com/{{1}}',
                                  'url_suffix_example' : 'https://www.example.coм/демо'}},
                                  {type: 'PHONE_NUMBER', 'phone_number': '+16315551010'}
                              ]"
                              }

                              Свойства тела

                              Заполнитель Описание Пример значения
                              <NAME>
                              Нить
                              Необходимый.

                              Название, которое вы указываете для своего шаблона.

                              Максимальное количество символов: 512.
                              мой_платежный_шаблон
                              <CATEGORY>
                              Перечисление
                              Необходимый.

                              Категория шаблонов.
                              Должно быть КОММУНАЛЬНЫЕ УСЛУГИ Для использования с библиотекой шаблонов.
                              КОММУНАЛЬНЫЕ УСЛУГИ
                              <LANGUAGE>
                              Перечисление
                              Необходимый.

                              Код локализации для языка шаблона.
                              Видеть Поддерживаемые языки
                              en_US
                              <LIBRARY_TEMPLATE_NAME>
                              Нить
                              Необходимый.

                              Точное название шаблона из библиотеки шаблонов.
                              доставка_обновление_1
                              <LIBRARY_TEMPLATE_BUTTON_INPUTS>
                              Массив объектов
                              Необязательный.

                              Веб-сайт и/или номер телефона компании, используемой в шаблоне.
                              Примечание: Для шаблонов вспомогательных функций, содержащих кнопки ввода, это свойство имеет значение.. нет необязательный.
                              “[ {'type': 'URL', 'url': {'base_url' : 'https://www.example.com/{{1}}', 'url_suffix_example' : 'https://www.example.com/demo'}}, {type: 'PHONE_NUMBER', 'phone_number': '+16315551010'} ]"
                              

                              Поля ввода кнопок шаблона библиотеки

                              Заполнитель Описание Пример значения
                              тип
                              перечисление
                              Тип кнопки
                              БЫСТРЫЙ ОТВЕТ, URL, НОМЕР ТЕЛЕФОНА, ОТП, МПМ, КАТАЛОГ, ПОТОК, ГОЛОСОВОЙ ВЫЗОВ, ПРИЛОЖЕНИЕ
                              Необходимый
                              ОТП
                              номер телефона
                              Нить
                              Номер телефона для кнопки.
                              Необязательный
                              "+13057652345"
                              url
                              Объект JSON
                              zero_tap_terms_accepted
                              логический
                              Были ли пользователь приняты или нет условия нулевого касания.
                              Необязательный
                              истинный
                              otp_type
                              перечисление
                              Тип OTP.
                              COPY_CODE, ONE_TAP, ZERO_TAP
                              Необязательный
                              истинный
                              поддерживаемые_приложения
                              Массив JSON-объектов

                              Ввод данных в тело шаблона библиотеки

                              Заполнитель Описание Пример значения
                              <LIBRARY_TEMPLATE_BODY_INPUTS>
                              Объект JSON
                              Необязательный.

                              Дополнительные данные, предоставляемые при создании шаблона из библиотеки шаблонов. Это необязательные поля для компонента кнопки.
                              Узнайте, как создавать шаблоны с помощью библиотеки шаблонов
                              добавить_контактный_номер
                              логический
                              Логическое значение для добавления информации в шаблон о том, как связаться с компанией по указанному номеру телефона.
                              Необязательный
                              истинный
                              add_learn_more_link
                              логический
                              Логическое значение для добавления информации в шаблон о получении дополнительных сведений с помощью URL-ссылки.
                              Информация не получила широкого распространения, и в случае отсутствия будет проигнорирована.
                              Необязательный
                              истинный
                              add_security_recommendation
                              логический
                              Логическое значение для добавления в шаблон информации о запрете передачи кодов аутентификации кому бы то ни было.
                              Необязательный
                              истинный
                              add_track_package_link
                              логический
                              Логическое значение для добавления информации в шаблон с целью отслеживания доставленных посылок.
                              Информация не получила широкого распространения, и в случае отсутствия будет проигнорирована.
                              Необязательный
                              истинный
                              code_expiration_minutes
                              int64
                              Целочисленное значение для добавления в шаблон информации о сроке действия кода.
                              Необязательный
                              5

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

                              локон'https://graph.facebook.com/v19.0/102290129340398/message_templates'
                              -ЧАС«Авторизация: Предъявитель EAAJB...»
                              -ЧАС'Content-Type: application/json'
                              '
                              {
                                "name": "my_delivery_update",
                                "language": "en_US",
                                "категория": "ПОЛЕЗНОСТЬ",
                                “library_template_name”: “delivery_update_1”,
                                "library_template_button_inputs": "[
                                  {'тип': 'URL', 'url': {'базовый_урл' : 'https://www.example.com/{{1}}',
                                  'url_suffix_example' : 'https://www.example.com/order_update}}
                                ]"
                              }

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

                              {
                              "идентификатор""{hsm-id}",
                              «статус»"ОДОБРЕННЫЙ",
                              "категория""Утилиты"
                              }

                              Отправка шаблонных сообщений

                              Чтобы узнать, как отправлять сообщения по шаблону, ознакомьтесь с руководством по отправке шаблонов.