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

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

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

Обновлено: 14 ноября 2025 г
Template Library makes it faster and easier for businesses to create utility templates for common use cases, like payment reminders, delivery updates —- and authentication templates for common identity verification use cases.
Эти готовые шаблоны уже отнесены к категориям «утилитарные» или «аутентификационные». Шаблоны библиотеки содержат фиксированное содержимое, которое нельзя редактировать, и параметры, которые можно адаптировать для бизнес-задач или конкретных пользователей.
Вы можете просматривать и создавать шаблоны, используя библиотеку шаблонов в WhatsApp Manager, или программно через API.

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

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

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

Когда шаблон содержит значение library_template_name в запросе GET /message_templates?name= В ответ на это следует понимать, что это шаблон, созданный на основе библиотеки шаблонов, и он подлежит проверке типов и ограничениям.
ИзображениеИзображениеИзображение
В библиотеке шаблонов содержатся как фиксированные элементы, так и параметры. Параметры представляют собой поля в шаблоне, куда можно вставлять переменную информацию, такую ​​как имена, адреса и номера телефонов.
In the example above, parameters like the name Jim or the business name CS Mutual can be modified to accept variables like your клиент'клиент's name and your бизнес'бизнес's name.
Сообщения, отправляемые с использованием шаблонов из библиотеки шаблонов, подвергаются проверке параметров во время отправки. Значения параметров, выходящие за пределы установленных диапазонов, указанных ниже, приведут к сбою отправки сообщения.

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

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

                        Формы

                        Формы are only available to accounts who have had their message limits increased.
                        Изображение
                        Некоторые шаблоны в библиотеке шаблонов представляют собой интерактивные формы, работающие на основе WhatsApp Flows.
                        В WhatsApp Manager эти шаблоны можно определить по пометке «Форма». В настоящее время поддерживаются следующие сценарии использования: «Отзыв клиента» и «Сбой доставки».

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

                        When calling the GET /message_template_library endpoint, the тип key in the кнопки array will show as "FORMS".
                        {
                        "имя": "delivery_failed_2_form",
                        "язык": "en_US",
                        "категория": "Утилиты",
                        "topic": "ORDER_MANAGEMENT",
                        "usecase": "DELIVERY_FAILED",
                        "industry": [
                        "E_COMMERCE"
                              ],
                        "тело": "We were unable to deliver order {{1}} today.

                        Please {{2}} to schedule another delivery attempt.",
                        "body_params": [
                        "#12345",
                        "try a redelivery"
                              ],
                        "body_param_types": [
                        "ТЕКСТ",
                        "ТЕКСТ"
                              ],
                        "кнопки": [
                                {
                        "тип": "FLOW",
                        "текст": "Reschedule"
                                }
                              ],
                        "идентификатор": "7138055039625658"
                        },
                        Использование API
                        API библиотеки шаблонов имеет две конечные точки:
                        // Used to browse available library templates
ПОЛУЧАТЬ /message_template_library
                        // Used when you are ready to create a template from the library.
ПОЧТА /<Идентификатор бизнес-аккаунта WhatsApp>/шаблоны сообщений
                        Поиск и фильтрация доступных шаблонов
                        Шаблоны с Заголовок parameter types of Документ only support PDFs
                        To browse and filter available templates, use the message_template_library конечная точка.
                        Once you find the template you are interested in, note the name as you will use it when creating the template via the ПОЧТА method.
                        Синтаксис запроса
                        // Get all available templates
ПОЛУЧАТЬ /message_template_library

// Search for substring
ПОЛУЧАТЬ /message_template_library?search=<SEARCH_KEY>// Filter by template topic
ПОЛУЧАТЬ/message_template_library?topic=<TOPIC>// Filter by template use case
ПОЛУЧАТЬ/message_template_library?usecase=<USECASE>// Filter by template industry
ПОЛУЧАТЬ/message_template_library?industry=<INDUSTRY>// Filter by template language
ПОЛУЧАТЬ/message_template_library?язык=<ЯЗЫК>
                        Параметры строки запроса
                        
Заполнитель

Описание

Пример значения

                        <SEARCH_KEY>
                        Нить
                        Необязательный.

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

                        
The topic of the template.

                        
See Template Filters below
                        УПРАВЛЕНИЕ ЗАКАЗАМИ
                        <USECASE>
                        Перечисление
                        Необязательный.

                        
The use case of the template.

                        
See Template Filters below
                        ПОДТВЕРЖДЕНИЕ ОТПРАВКИ
                        <INDUSTRY>
                        Перечисление
                        Необязательный.

                        
The industry of the template.

                        
See Template Filters below
                        Электронная коммерция
                        <LANGUAGE>
                        Перечисление
                        Необязательный.

                        
The template language locale code.

                        
Видеть Supported Languages
                        en_US
                        Пример запроса
                        локон 'https://graph.facebook.com/v25.0/102290129340398/message_templates?search="payments"'-ЧАС «Авторизация: Предъявитель EAAJB...»
                        Пример ответа
                        {
                        "имя": "low_balance_warning_1",
                        "язык": "en_US",
                        "категория": "Утилиты",
                        "topic": "PAYMENTS",
                        "usecase": "LOW_BALANCE_WARNING",
                        "industry": [
                        "FINANCIAL_SERVICES"
                              ],
                        "заголовок": "Your account balance is low",
                        "тело": "Hi {{1}},
                        This is to notify you that your {{2}} in your {{3}} account, ending in {{4}} is below your pre-set {{5}} of {{6}}.
                        Click the button to deposit more {{7}}.
                        {{8}}",
                        "body_params": [
                        "Jim",
                        "available funds",
                        "CS Mutual checking plus",
                        "1234",
                        "limit",
                        "$75.00",
                        "funds",
                        "CS Mutual"
                              ],
                        "кнопки": [
                                {
                        "тип": "URL",
                        "текст": "Make a deposit",
                        "url": "https://www.example.com/"
                                },
                                {
                        "тип": "НОМЕР ТЕЛЕФОНА",
                        "текст": «Позвоните нам»,
                        "номер телефона": "+18005551234"
                                }
                              ],
                        "идентификатор": "7147013345418927"
                        }
                        Фильтры шаблонов
                        В библиотеке шаблонов представлено несколько шаблонов на выбор. Вы можете использовать API для их фильтрации по нескольким параметрам.
                        Промышленность
                          Электронная коммерцияФИНАНСОВЫЕ_УСЛУГИ
                          Тема
                            ОБНОВЛЕНИЕ УЧЕТНОЙ ЗАПИСИОТЗЫВЫ КЛИЕНТОВУПРАВЛЕНИЕ ЗАКАЗАМИПЛАТЕЖИ
                            Вариант использования
                              ПОДТВЕРЖДЕНИЕ СОЗДАНИЯ УЧЕТНОЙ ЗАПИСИАВТОМАТИЧЕСКОЕ НАПОМИНАНИЕ ОБ ОПЛАТЕПОДТВЕРЖДЕНИЕ ДОСТАВКИДОСТАВКА НЕ УДАЛАСЬОБНОВЛЕНИЕ ДОСТАВКИОпрос обратной связиПРЕДУПРЕЖДЕНИЕ О МОШЕННИЧЕСТВЕПРЕДУПРЕЖДЕНИЕ О НИЗКОМ БАЛАНСЕORDER_ACTION_NEEDEDПОДТВЕРЖДЕНИЕ ЗАКАЗАORDER_DELAYОТМЕНА ЗАКАЗА ИЛИ ТРАНЗАКЦИИЗАКАЗ_САМОВЫВОЗТРЕБУЕТСЯ ПЛАТЕЖНОЕ ДЕЙСТВИЕПОДТВЕРЖДЕНИЕ ПЛАТЕЖАНАПОМИНАНИЕ О СРОКЕ ОПЛАТЫПРОСРОЧЕННЫЙ ПЛАТЕЖPAYMENT_REJECT_FAILПЛАТЕЖ_ЗАПЛАНИРОВАНПРИЛОЖЕНИЕ_ЧЕКАRETURN_CONFIRMATIONПОДТВЕРЖДЕНИЕ ОТПРАВКИПРИЛОЖЕНИЕ_ЗАЯВЛЕНИЯЗАЯВЛЕНИЕ ДОСТУПНОTRANSACTION_ALERT
                              Создание шаблонов
                              Примечание: Изменение правил, касающихся свойств тела запроса для этой конечной точки, предназначено исключительно для демонстрации того, как использовать эту конечную точку с библиотекой шаблонов.
                              To create a new template using the Template Library, call the existing <WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates endpoint using the body properties below.
                              Синтаксис запроса
                              ПОЧТА /<Идентификатор бизнес-аккаунта 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.com/demo'}},
                                  {type: 'PHONE_NUMBER', 'phone_number': '+16315551010'}
                              ]"
                              }
                              Свойства тела
                              
Заполнитель

Описание

Пример значения

                              <NAME>
                              Нить
                              Необходимый.

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

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

                              
Категория шаблонов.

                              Должно быть КОММУНАЛЬНЫЕ УСЛУГИ for use with Template Library.
                              КОММУНАЛЬНЫЕ УСЛУГИ
                              <LANGUAGE>
                              Перечисление
                              Необходимый.

                              
The template language locale code.

                              
Видеть Supported Languages
                              en_US
                              <LIBRARY_TEMPLATE_NAME>
                              Нить
                              Необходимый.

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

                              
The website and/or phone number of the business being used in the template.

                              Note: For utility templates that have button inputs, this property is нет optional.
                              “[ {'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, НОМЕР ТЕЛЕФОНА, ОТП, MPM, КАТАЛОГ, FLOW, ГОЛОСОВОЙ ВЫЗОВ, ПРИЛОЖЕНИЕ
                              Необходимый
                              ОТП
                              номер телефона
                              Нить
                              Номер телефона для кнопки.
                              Необязательный
                              "+13057652345"
                              url
                              Объект JSON
                              zero_tap_terms_accepted
                              логический
                              Были ли пользователь приняты или нет условия нулевого касания.
                              Необязательный
                              истинный
                              otp_type
                              перечисление
                              Тип OTP.
                              COPY_CODE, ONE_TAP, ZERO_TAP
                              Необязательный
                              истинный
                              поддерживаемые_приложения
                              Массив JSON-объектов
                              Ввод данных в тело шаблона библиотеки
                              
Заполнитель

Описание

Пример значения

                              <LIBRARY_TEMPLATE_BODY_INPUTS>
                              Объект JSON
                              Необязательный.

                              
Optional data during creation of a template from Template Library. These are optional fields for the button component.

                              Learn how to create templates using Template Library
                              добавить_контактный_номер
                              логический
                              Логическое значение для добавления информации в шаблон о том, как связаться с компанией по указанному номеру телефона.
                              Необязательный
                              истинный
                              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': {'base_url' : 'https://www.example.com/{{1}}',
                                  'url_suffix_example' : 'https://www.example.com/order_update}}
                                ]"
                              }
                              Пример ответа
                              {
                              "идентификатор": "{hsm-id}",
                              «статус»: "ОДОБРЕННЫЙ",
                              "категория": "Утилиты"
                              }
                              Отправка шаблонных сообщений
                              

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

            
                              
        
                              
    
                              

    
                              

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