Библиотека шаблонов | Документация для разработчиков
Библиотека шаблонов
Обновлено: 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 бумажных полотенецваш запроспокупкаРынок ДжаспераКОЛИЧЕСТВОЧисло, обозначающее количество.
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Формы

Идентификация форм в ответе на запрос
GET /message_template_libraryтипкнопки"ФОРМЫ"{"имя":"delivery_failed_2_form","язык":"en_US","категория":"Утилиты","тема":«УПРАВЛЕНИЕ ЗАКАЗАМИ»,«вариант использования»:"ДОСТАВКА НЕ УДАЛАСЬ","промышленность": ["Электронная коммерция"],"тело":«Сегодня мы не смогли доставить заказ {{1}}».Пожалуйста, {{2}}, чтобы запланировать еще одну попытку доставки.","body_params": ["#12345","Попробуйте повторную доставку"],"body_param_types": ["ТЕКСТ","ТЕКСТ"],"кнопки": [{"тип":"ПОТОК","текст":"Перенести"}],"идентификатор":"7138055039625658"},
Использование API
// Используется для просмотра доступных шаблонов библиотеки
ПОЛУЧАТЬ /message_template_library// Используется, когда вы готовы создать шаблон из библиотеки.
ПОЧТА /<Идентификатор бизнес-аккаунта WhatsApp>/шаблоны сообщенийПоиск и фильтрация доступных шаблонов
ЗаголовокДокументmessage_template_libraryПОЧТАСинтаксис запроса
// Получить все доступные шаблоны
ПОЛУЧАТЬ /message_template_library
// Поиск подстроки
ПОЛУЧАТЬ /message_template_library?поиск=<SEARCH_KEY>// Фильтрация по теме шаблона
ПОЛУЧАТЬ/message_template_library?тема=<ТЕМА>// Фильтрация по варианту использования шаблона
ПОЛУЧАТЬ/message_template_library?вариант использования=<ПРИМЕР ИСПОЛЬЗОВАНИЯ>// Фильтрация по отраслям шаблонов
ПОЛУЧАТЬ/message_template_library?промышленность=<ОТРАСЛЬ>// Фильтрация по языку шаблона
ПОЛУЧАТЬ/message_template_library?язык=<ЯЗЫК>Параметры строки запроса
| | |
| | |
| | |
| | |
| |
Пример запроса
локон '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"}
Фильтры шаблонов
Электронная коммерцияФИНАНСОВЫЕ_УСЛУГИОБНОВЛЕНИЕ УЧЕТНОЙ ЗАПИСИОТЗЫВЫ КЛИЕНТОВУПРАВЛЕНИЕ ЗАКАЗАМИПЛАТЕЖИПОДТВЕРЖДЕНИЕ СОЗДАНИЯ УЧЕТНОЙ ЗАПИСИАВТОМАТИЧЕСКОЕ НАПОМИНАНИЕ ОБ ОПЛАТЕПОДТВЕРЖДЕНИЕ ДОСТАВКИДОСТАВКА НЕ УДАЛАСЬОБНОВЛЕНИЕ ДОСТАВКИОпрос обратной связиПРЕДУПРЕЖДЕНИЕ О МОШЕННИЧЕСТВЕПРЕДУПРЕЖДЕНИЕ О НИЗКОМ БАЛАНСЕ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'}]"}
Свойства тела
| | |
| | |
| | |
| | |
| |
Поля ввода кнопок шаблона библиотеки
| | |
| | |
| ||
| | |
| | |
|
Ввод данных в тело шаблона библиотеки
| ||
| | |
| | |
| | |
| | |
| |
Пример запроса
локон'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}",«статус»:"ОДОБРЕННЫЙ","категория":"Утилиты"}
Отправка шаблонных сообщений
Чтобы узнать, как отправлять сообщения по шаблону, ознакомьтесь с руководством по отправке шаблонов.