Шаблоны | Документация для разработчиков
Шаблоны
Обновлено: 5 декабря 2025 г
Узнайте о шаблонах, их применении и ограничениях, а также о различных типах шаблонов, которые вы можете создавать.
Шаблоны — это ресурсы бизнес-аккаунта WhatsApp, которые можно отправлять в шаблонных сообщениях через Cloud API или Marketing Messages API для WhatsApp. Шаблонные сообщения — это единственный тип сообщений, которые можно отправлять пользователям WhatsApp вне окна обслуживания клиентов , поэтому шаблоны часто используются при массовой рассылке сообщений или когда вам нужно отправить сообщение пользователю, но окно обслуживания клиентов между вами и пользователем не открыто.
Творение
Используйте POST /
Создание шаблонов через API использует общий синтаксис. Основные различия заключаются в строке категории, которая присваивает шаблону категорию, и массиве компонентов, который определяет компоненты, из которых состоит шаблон.
В аккаунте WhatsApp Business можно создать максимум 100 шаблонов в час.
Общий синтаксис
curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates' \ -H 'Authorization: Bearer EAAJB...' \ -H 'Content-Type: application/json' \ -d ' { "fname": "<NAME> ", "категория": "<CATEGORY> ", "язык": "<LANGUAGE> ", "parameter_format": "<PARAMETER_FORMAT> ", "компоненты": [<COMPONENTS> ] }'Имена
Каждый шаблон должен иметь имя, но имена не уникальны. Такая гибкость позволяет создавать несколько шаблонов с одинаковым именем, но на разных языках.
Названия шаблонов ограничены максимум 512 символами и состоят из строчных буквенно-цифровых символов и символов подчеркивания.
Категории
Каждый шаблон должен быть отнесен к категориям аутентификации , маркетинга или служебных целей . В нашем по категоризации шаблонов описано, как правильно присвоить шаблону категорию и что может произойти, если мы обнаружим, что шаблон был отнесен к неправильной категории.
Обратите внимание, что категории шаблонов также влияют на ценообразование .
Компоненты
Шаблоны состоят из различных текстовых, мультимедийных и интерактивных компонентов пользовательского интерфейса, которые вы определяете при создании шаблона. В нашем документе, посвященном компонентам шаблонов, описаны все возможные компоненты и способы их определения.
Поскольку существует множество компонентов на выбор, у нас есть отдельные шаблоны и поддокументы для аутентификации , маркетинга и служебных функций
Языки
необходимо указать код языка шаблона . Строки и переменные шаблона не переводятся Meta, поэтому вы несете ответственность за предоставление строк и примеров параметров на соответствующем языке.
Если вы создадите несколько шаблонов с одинаковым именем, но на разных языках, каждый шаблон будет учитываться в рамках вашего лимита шаблонов .
Форматы параметров
Некоторые компоненты шаблона позволяют определять строки, содержащие один или несколько параметров (в WhatsApp Manager они называются «переменными»). Эти параметры заменяются значениями, которые вы указываете в полезной нагрузке вашего сообщения при отправке шаблона.
При создании шаблона, если строка содержит один или несколько параметров, вы можете указать их формат —
именованный или позиционный — и необходимо указать пример значения для каждого параметра. Если формат не указан, шаблон по умолчанию позиционный Именованные параметры
Параметры, использующие именованный формат, должны быть уникальными, представлять собой отдельные строки, состоящие из строчных букв и символов подчеркивания, заключенные в двойные фигурные скобки, например,
{{first_name}} . Примерные значения в полезных нагрузках для создания шаблона и реальные значения в полезных нагрузках для отправки шаблона могут располагаться в любом порядке.Пример полезной нагрузки для создания шаблона с именованными параметрами:
{ "name": "order_confirmation", "language": "en_US", "category": "utility", "parameter_format": "named", "components": [ { "type": "body", "text": "Спасибо, {{first_name}}! Номер вашего заказа: {{order_number}}."", "example": { "body_text_named_params": [ { "param_name": "first_name", "example": "Pablo" }, { "param_name": "order_number", "example": "860198-230332" } ] } } ] }Пример шаблона для отправки полезной нагрузки, использующего именованные параметры:
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "template", "template": { "name": "order_confirmation", "language": { "code": "en_US" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "parameter_name": "first_name", "text": "Jessica" }, { "type": "text", "parameter_name": "order_number", "text": "SKBUP2-4CPIG9" } ] } ] } }Позиционные параметры
Позиционные параметры должны представлять собой упорядоченные порядковые номера массива, начиная с 1, заключенные в двойные фигурные скобки: (
{{1}} ... {{2}} ...и так далее). Примеры значений в полезных нагрузках при создании шаблона и реальные значения в полезных нагрузках при отправке шаблона должны располагаться в том порядке, в котором соответствующие им заполнители отображаются в текстовой строке компонента.Пример полезной нагрузки для создания шаблона с позиционным параметром:
{ "name": "order_confirmation", "language": "en_US", "category": "utility", "parameter_format": "positional", "components": [ { "type": "body", "text": "Привет, {{1}}! Номер вашего заказа: {{2}}. Спасибо."", "example": { "body_text": [ [ "Pablo", "860198-230332" ] ] } } ] }Пример шаблона для отправки полезной нагрузки, использующего позиционный параметр:
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "template", "template": { "name": "order_confirmation", "language": { "code": "en_US" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Jessica" }, { "type": "text", "text": "SKBUP2-4CPIG9" } ] } ] } }СМИ
Компоненты заголовка шаблона могут отображать медиафайлы. Если вы создаете шаблон с медиазаголовком, вам необходимо использовать API возобновляемой загрузки , чтобы получить дескриптор медиафайла, и включить этот дескриптор в запрос на создание шаблона. Пример медиафайла будет проверен в рамках проверки шаблона .
Обзор шаблона
Шаблоны автоматически проверяются при создании или редактировании. Если ваш шаблон одобрен, его статус будет установлен на
«ОДОБРЕНО» , и вы сможете начать отправлять его в шаблонных сообщениях. Если он отклонен или его статус изменился на любое другое значение, его нельзя будет отправлять в шаблонных сообщениях.Ознакомьтесь с нашим о проверке шаблонов, чтобы узнать больше о процессе проверки шаблонов, распространенных причинах отказа и о том, что вы можете сделать, если ваш шаблон будет отклонен.
Статус шаблона
шаблоны можно будет отправлять в шаблонных сообщениях, они должны иметь статус
«ОДОБРЕНО» . Статус шаблона изначально устанавливается в процессе проверки шаблонов, но может быть изменен на другое значение в зависимости от использования и отзывов о качестве .Изменения статуса шаблона передаются через message_template_status_update , но вы также можете использовать GET-запрос /
статуса , чтобы в любое время получить статус шаблона.Пример запроса
curl 'https://graph.facebook.com/v23.0/1259544702043867?fields=status' \ -H 'Авторизация: Bearer EAAJ...'
Пример ответа
{ "status": "APPROVED", "id": "1259544702043867" }См. GET /
Менеджер WhatsApp
В «Управление шаблонами » в WhatsApp Manager также отображаются статусы шаблонов и добавляются оценки качества для утвержденных (
активных ) шаблонов:Ограничения шаблонов
Количество шаблонов, которые может иметь бизнес-аккаунт WhatsApp, определяется его основным бизнес-портфелем.
Если портфель родительского бизнеса не верифицирован, каждый из его бизнес-аккаунтов WhatsApp ограничен 250 шаблонами сообщений. Однако, если портфель верифицирован и хотя бы один из его бизнес-аккаунтов WhatsApp имеет рабочий номер телефона с утвержденным отображаемым именем , каждый из его бизнес-аккаунтов WhatsApp может иметь до 6000 шаблонов.
Кроме того, существуют ограничения на количество отправляемых шаблонов, а также процессы, которые могут повлиять на доставку шаблонов:
Время до смерти
Если сообщение, отправленное пользователю WhatsApp, не может быть доставлено, система будет продолжать попытки доставки в течение периода, известного как время жизни (TTL). Вы можете настроить значение TTL для шаблонов при их создании.
ознакомьтесь с нашим о продолжительности жизни .
Рейтинг качества
Рейтинг качества шаблонов — это система, используемая для оценки качества шаблонов сообщений на основе их использования, отзывов клиентов и вовлеченности. Этот рейтинг помогает поддерживать высокое качество экосистемы обмена сообщениями и гарантирует отправку релевантных и хорошо воспринимаемых сообщений.
Для получения дополнительной информации о рейтингах качества, о том, как они могут повлиять на статус шаблона, и о том, как вы можете получать уведомления об изменениях в оценках качества шаблонов, ознакомьтесь с нашим посвященным рейтингам качества шаблонов
Последовательность доставки нескольких сообщений
При отправке серии сообщений порядок их доставки не гарантирует совпадения с порядком ваших API-запросов. Если вам необходимо обеспечить последовательность доставки сообщений, подтвердите получение
доставки в сообщений о статусе перед отправкой следующего сообщения в вашей последовательности.Управление шаблонами
Список часто используемых конечных точек для получения, обновления и удаления шаблонов см. в нашем по управлению шаблонами
Комментарии отсутствуют
Комментарии отсутствуют