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

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

Обновлено: 14 ноября 2025 г

Библиотека шаблонов позволяет компаниям быстрее и проще создавать вспомогательные шаблоны для распространенных сценариев использования, таких как напоминания об оплате, обновления информации о доставке, а также шаблоны аутентификации для распространенных случаев проверки личности.

Эти готовые шаблоны уже отнесены к категориям «утилитарные» или «аутентификационные». Шаблоны библиотеки содержат фиксированное содержимое, которое нельзя редактировать, и параметры, которые можно адаптировать для бизнес-задач или конкретных пользователей.

Вы можете просматривать и создавать шаблоны, используя библиотеку шаблонов в WhatsApp Manager, или программно через API.

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

Следуйте приведенным ниже инструкциям, чтобы создать шаблоны с помощью библиотеки шаблонов в WhatsApp Manager .

1: На боковой панели WAM, в разделе «Шаблоны сообщений» , выберите «Создать шаблон» .

2: В разделе «Просмотр библиотеки шаблонов WhatsApp» выберите «Просмотреть шаблоны» .

3: Теперь вы увидите все доступные шаблоны. Используйте строку поиска для поиска по теме или варианту использования, или воспользуйтесь выпадающими списками на боковой панели для фильтрации результатов.

Обратите внимание, что при наведении курсора на шаблон отобразятся значения его параметров.

4. Чтобы создать шаблон, выберите его , щелкнув по нему. Затем добавьте название шаблона, выберите язык и заполните поля для кнопок. После выполнения этих шагов нажмите « Отправить» .

Примечание: Если вы выберете «Настроить шаблон» , ваш шаблон должен пройти проверку перед отправкой сообщений.

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

Когда шаблон содержит значение library_template_name в запросе GET /message_templates?name= В ответ на это следует понимать, что это шаблон, созданный на основе библиотеки шаблонов, и он подлежит проверке типов и ограничениям.

В библиотеке шаблонов содержатся как фиксированные элементы, так и параметры. Параметры представляют собой поля в шаблоне, куда можно вставлять переменную информацию, такую как имена, адреса и номера телефонов.

В приведенном выше примере такие параметры, как имя Джим или название компании 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`
`ЭЛЕКТРОННАЯ ПОЧТА`	Стандартный адрес электронной почты. Необходимо указать действительный адрес электронной почты	`[email protected][email protected][email protected]`
`ЧИСЛО`	Число. Должно быть, это число.Не может содержать пробелы.	`2344490001234921388904453638`

Формы

Формы доступны только для учетных записей, у которых был увеличен лимит сообщений.

Некоторые шаблоны в библиотеке шаблонов представляют собой интерактивные формы, работающие на основе WhatsApp Flows.

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

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

При вызове конечной точки GET /message_template_library типа в buttons будет отображаться как "FORMS" .

{
 "name"
 : "delivery_failed_2_form" , "language"
 : "en_US" , "category"
 : "UTILITY" , "topic"
 : "ORDER_MANAGEMENT" , "usecase"
 : "DELIVERY_FAILED" , "industry"
 : [ "E_COMMERCE"
 ],
 "body"

 : "Нам не удалось доставить заказ {{1}} сегодня. Пожалуйста, {{2}} запланируйте еще одну попытку доставки.
 " , "body_params"
 : [ "#12345"
 , "попробуйте повторную доставку"
 ],
 "body_param_types"
 : [ "TEXT"
 , "TEXT"
 ],
 "buttons"
 : [ {
 "type"
 : "FLOW" , "text"
 : "Перепланировать" }
 ],
 "id"
 : "7138055039625658" },

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

API библиотеки шаблонов имеет две конечные точки:

// Используется для просмотра доступных шаблонов библиотеки GET / message_template_library

// Используется, когда вы готовы создать шаблон из библиотеки. POST /< WHATSAPP_BUSINESS_ACCOUNT_ID >/ message_templates

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

Шаблоны с параметрами заголовка «Документ» поддерживают только PDF-файлы.

Для просмотра и фильтрации доступных шаблонов используйте message_template_library .

Найдя интересующий вас шаблон, запишите его название, так как оно понадобится вам при создании шаблона POST .

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

// Получить все доступные шаблоны GET / message_template_library // Поиск по подстроке GET / message_template_library ? search =< SEARCH_KEY > // Фильтрация по теме шаблона GET / message_template_library ? topic =< TOPIC > // Фильтрация по варианту использования шаблона GET / message_template_library ? usecase =< USECASE > // Фильтрация по отрасли шаблона GET / message_template_library ? industry =< INDUSTRY > // Фильтрация по языку шаблона GET / message_template_library ? language =< LANGUAGE >

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

Заполнитель	Описание	Пример значения
`<SEARCH_KEY>` Нить	Необязательный. Искомая подстрока в содержимом, имени, заголовке, теле или нижнем колонтитуле шаблона.	`платежи`
`<TOPIC>` Перечисление	Необязательный. Тема шаблона. См. Фильтры шаблонов ниже.	`УПРАВЛЕНИЕ ЗАКАЗАМИ`
`<USECASE>` Перечисление	Необязательный. Пример использования шаблона. См. раздел «Фильтры шаблона» ниже.	`ПОДТВЕРЖДЕНИЕ ОТПРАВКИ`
`<INDUSTRY>` Перечисление	Необязательный. Отрасль, использующая шаблоны. См. Фильтры шаблонов ниже.	`Электронная коммерция`
`<LANGUAGE>` Перечисление	Необязательный. Код локализации для языка шаблона. См. «Поддерживаемые языки»	`en_US`

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

curl 'https://graph.facebook.com/ v25.0 /102290129340398/message_templates?search="payments"' - H 'Авторизация: Bearer EAAJB...'

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

{
 "name"
 : "low_balance_warning_1" , "language"
 : "en_US" , "category"
 : "UTILITY" , "topic"
 : "PAYMENTS" , "usecase"
 : "LOW_BALANCE_WARNING" , "industry"
 : [ "FINANCIAL_SERVICES"
 ],
 "header"
 : "Ваш баланс счета низкий" , "body"
 : "Привет, {{1}}, сообщаем вам, что ваш баланс {{2}} на
 счете {{3} }, заканчивающемся на {{4}}, ниже установленного вами лимита { {5}} в размере {{6}}. Нажмите кнопку, чтобы пополнить счет {{7}}.
 {{8}}"
 , "body_params"
 : [ "Jim"
 , "available funds"
 , "CS Mutual checking plus"
 , "1234"
 , "limit"
 , "$75.00"
 , "funds"
 , "CS Mutual"
 ],
 "buttons"
 : [ {
 "type"
 : "URL" , "text"
 : "Make a deposit" , "url"
 : "https://www.example.com/" },
 {
 "type"
 : "PHONE_NUMBER" , "text"
 : "Call us" , "phone_number"
 : "+18005551234" }
 ],
 "id"
 : "7147013345418927" }

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

В библиотеке шаблонов представлено несколько шаблонов на выбор. Вы можете использовать API для их фильтрации по нескольким параметрам.

Промышленность

Электронная коммерцияФИНАНСОВЫЕ_УСЛУГИ

Тема

ОБНОВЛЕНИЕ УЧЕТНОЙ ЗАПИСИОТЗЫВЫ КЛИЕНТОВУПРАВЛЕНИЕ ЗАКАЗАМИПЛАТЕЖИ

Вариант использования

ПОДТВЕРЖДЕНИЕ СОЗДАНИЯ УЧЕТНОЙ ЗАПИСИАВТОМАТИЧЕСКОЕ НАПОМИНАНИЕ ОБ ОПЛАТЕПОДТВЕРЖДЕНИЕ ДОСТАВКИДОСТАВКА НЕ УДАЛАСЬОБНОВЛЕНИЕ ДОСТАВКИОпрос обратной связиПРЕДУПРЕЖДЕНИЕ О МОШЕННИЧЕСТВЕПРЕДУПРЕЖДЕНИЕ О НИЗКОМ БАЛАНСЕORDER_ACTION_NEEDEDПОДТВЕРЖДЕНИЕ ЗАКАЗАORDER_DELAYОТМЕНА ЗАКАЗА ИЛИ ТРАНЗАКЦИИЗАКАЗ_САМОВЫВОЗТРЕБУЕТСЯ ПЛАТЕЖНОЕ ДЕЙСТВИЕПОДТВЕРЖДЕНИЕ ПЛАТЕЖАНАПОМИНАНИЕ О СРОКЕ ОПЛАТЫПРОСРОЧЕННЫЙ ПЛАТЕЖPAYMENT_REJECT_FAILПЛАТЕЖ_ЗАПЛАНИРОВАНПРИЛОЖЕНИЕ_ЧЕКАRETURN_CONFIRMATIONПОДТВЕРЖДЕНИЕ ОТПРАВКИПРИЛОЖЕНИЕ_ЗАЯВЛЕНИЯЗАЯВЛЕНИЕ ДОСТУПНОTRANSACTION_ALERT

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

Примечание: Изменение правил, касающихся свойств тела запроса для этой конечной точки, предназначено исключительно для демонстрации того, как использовать эту конечную точку с библиотекой шаблонов.

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

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

POST /< WHATSAPP_BUSINESS_ACCOUNT_ID >/ message_templates

Тело поста

{
 "имя"
 : " " , "category"
 : "UTILITY" , "language"
 : "en_US" , "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': '+16315
 551010'} ]"
 }

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

Заполнитель	Описание	Пример значения
`<NAME>` Нить	Необходимый. Название, которое вы указываете для своего шаблона. Максимальное количество символов: 512.	`мой_платежный_шаблон`
`<CATEGORY>` Перечисление	Необходимый. Категория шаблонов. Для использования с библиотекой шаблонов должна быть `UTILITY`	`КОММУНАЛЬНЫЕ УСЛУГИ`
`<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'} ]"`

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

Заполнитель	Описание	Пример значения
`тип` перечисление	Тип кнопки `QUICK_REPLY` , `URL` , `PHONE_NUMBER` , `OTP` , `MPM` , `CATALOG` , `FLOW` , `VOICE_CALL` , `APP` Необходимый	`ОТП`
`номер телефона` Нить	Номер телефона для кнопки. Необязательный	`"+13057652345"`
`url` Объект JSON	Параметры URL-адреса JSON-объекта `base_url` и `url_suffix_example` здесь. Необязательный
`zero_tap_terms_accepted` логический	Были ли пользователь приняты или нет условия нулевого касания. Необязательный	`истинный`
`otp_type` перечисление	Тип OTP. `COPY_CODE` , `ONE_TAP` , `ZERO_TAP` Необязательный	`истинный`
`поддерживаемые_приложения` Массив JSON-объектов	здесь поддерживаемые параметры приложения в формате JSON: `package_name` и `signature_hash` Необязательный

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

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

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

curl
 'https://graph.facebook.com/v19.0/102290129340398/ message_templates' -H
 'Authorization: Bearer EAAJB...' -H
 'Content-Type: application/json' -d
 ' {
 "name": "my_delivery_update",
 "language": "en_US",
 "category": "UTILITY",
 "library_template_name”: "delivery_update_1",
 "library_template_button_inputs": "[
 {'
 type ': ' URL ', ' url ': {' base_url ' : ' https://www.example.com/{{ 1 }} ', '
 url_suffix_example ' : ' https://www.example.com/order_update}} ]
 " }

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

{
 "id"
 : "{hsm-id}" , "status"
 : "APPROVED" , "category"
 : "UTILITY" }

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

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