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

Вспомогательные шаблоны имеют строгие требования к содержанию, особенно в отношении маркетинговых материалов. Если вы попытаетесь создать или обновить вспомогательный шаблон, добавив в него маркетинговые материалы, шаблон автоматически будет переклассифицирован как маркетинговый шаблон.
Рекомендации по классификации контента см. в нашей по категоризации шаблонов
Поддерживаемые компоненты
Вспомогательные шаблоны поддерживают следующие компоненты:
Создайте шаблон утилиты
Синтаксис запроса
ПОЧТА/<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templatescurl '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","текст": "<Текст метки кнопки быстрого ответа>"}]}]}'
Параметры запроса
| | |
| ||
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
Синтаксис ответа
{"идентификатор": "<TEMPLATE_ID>","статус": "<TEMPLATE_STATUS>","категория": "<TEMPLATE_CATEGORY>"}
Параметры отклика
| | |
| | |
| |
Пример запроса
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При необходимости следуйте инструкциям -->]}]}}'
Параметры запроса
| | |
| ||
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| |
Синтаксис ответа
{"messaging_product":"WhatsApp","контакты": [{"вход":"<WHATSAPP_USER_PHONE_NUMBER> ","ва_ид":"<WHATSAPP_USER_ID> "}],"сообщения": [{"идентификатор":"<WHATSAPP_MESSAGE_ID> ","message_status":"<PACING_STATUS> "}]}
Параметры отклика
| | |
| | |
| | |
| |
Пример запроса
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":"принял"}]}