Шаблоны промокодов
Обновлено: 3 декабря 2025 г
Шаблоны купонов — это маркетинговые шаблоны, отображающие одну кнопку для копирования кода. При нажатии на нее код копируется в купон клиент'клиент'буфер обмена.
В настоящее время веб-клиент WhatsApp не поддерживает шаблоны промокодов.Текст кнопки «Копировать код» изменить нельзя.В шаблонах доступна только одна кнопка для копирования кода.Создание шаблонов купонных кодов
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "name": "<TEMPLATE_NAME> ", "язык": "<TEMPLATE_LANGUAGE> ", "категория": "маркетинг", "компоненты": [<!-- Only if using a header component --> { "type": "header", "format": "text", "text": "<HEADER_TEXT> " }, { "type": "body", "text": "<BODY_TEXT> ",<!-- Only include if body text includes one or more parameters --> "пример": { "body_text": [ [ "<BODY_PARAMETER_EXAMPLE_VALUE> "<!-- Additional examples values would follow, if using multiple body parameters --> ] ] } }, { "type": "buttons", "buttons": [<!-- Only if using a quick-reply button --> { "type": "quick_reply", "text": "<QUICK_REPLY_BUTTON_LABEL_TEXT> " }, { "type": "copy_code", "example": "<COPY_CODE_BUTTON_EXAMPLE_CODE> " } ] } ] }'
Заполнитель
|
Описание
|
Пример значения
|
|---|
| Необходимый.
Токен доступа.
| |
| Необязательный.
Версия API. Если этот параметр опущен, по умолчанию используется самая новая версия API, доступная для вашего приложения.
| |
<BODY_PARAMETER_EXAMPLE_VALUE>
Нить
| Обязательно, если используется строковый компонент тела документа, содержащий один или несколько параметров.
Пример значения параметра. Необходимо указать пример для каждого параметра, определенного в строке компонента тела документа.
| |
| Необходимый.
Шаблон основного текста. Поддерживаются переменные.
Максимальное количество символов: 1024.
| Делайте покупки с сегодняшнего дня до конца декабря и используйте одноразовый код {{1}}, чтобы получить скидку {{2}} на весь ваш заказ!
|
<COPY_CODE_BUTTON_EXAMPLE_CODE>
Нить
| Необходимый.
Код, который будет скопирован в буфер обмена устройства при нажатии.
Максимум 20 символов.
| |
| Обязательно при использовании компонента текстового заголовка.
Заголовочный текст.
Максимум 60 символов.
| Наша зимняя распродажа началась!
|
<QUICK_REPLY_BUTTON_LABEL_TEXT>
| Обязательно при использовании кнопки быстрого ответа.
Текст надписи на кнопке. Максимум 25 символов. Только буквенно-цифровые символы.
| |
| | |
| Необходимый.
Название шаблона. Должно быть уникальным, за исключением случаев, когда существующие шаблоны с тем же именем имеют другой язык программирования.
Максимум 512 символов. Только строчные буквы, буквы и цифры, а также символы подчеркивания.
| купон_одноразовый_зимний_2025
|
<WHATSAPP_BUSINESS_ACCOUNT_ID>
Нить
| Необходимый.
Идентификатор бизнес-аккаунта WhatsApp.
| |
В случае успеха:
{ "идентификатор": "<TEMPLATE_ID> ", "статус": "<TEMPLATE_STATUS> ", "категория": "<TEMPLATE_CATEGORY> " }
Заполнитель
|
Описание
|
Пример значения
|
|---|
| | |
| | |
| | |
локон 'https://graph.facebook.com/v25.0/102290129340398/message_templates' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "name": "coupon_code_onetime_winter_2025", "language": "en_US", "category": "marketing", "components": [ { "type": "header", "format": "text", "text": "Наша зимняя распродажа началась!" }, { "type": "BODY", "text": "Покупайте сейчас до конца декабря и используйте одноразовый код {{1}}, чтобы получить скидку {{2}} на весь ваш заказ!", "example": { "body_text": [ [ "fLBponPDsqF0KQThzkrf", "30%" ] ] } }, { "type": "BUTTONS", "buttons": [ { "type": "QUICK_REPLY", "text": "Unsubscribe" }, { "type": "COPY_CODE", "example": "fLBponPDsqF0KQThzkrf" } ] } ] }'
{ "category" : "MARKETING", "id" : "1924084211297547", "status" : "PENDING" }
Отправка шаблонов купонов
curl -X POST "https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /messages" \ -H "Авторизация: Bearer"<ACCESS_TOKEN> " \ -H "Content-Type: application/json" \ -d ' { "messaging_product": "whatsapp", "to": "<USER_PHONE_NUMBDER> ", "type": "template", "template": { "name": "<TEMPLATE_NAME> ", "язык": { "код": "<TEMPLATE_LANGUAGE> " }, "components": [ { "type": "button", "sub_type": "copy_code", "index":<BUTTON_INDEX> , "параметры": [ { "тип": "код_купона", "код_купона": "<COUPON_CODE> " } ] }<!-- Additional components would follow, if templates requires them --> ] } }'
Заполнитель
|
Описание
|
Пример значения
|
|---|
| Необходимый.
Токен доступа.
| |
| Необязательный.
Версия API. Если этот параметр опущен, по умолчанию используется самая новая версия API, доступная для вашего приложения.
| |
<BUSINESS_PHONE_NUMBER_ID>
Нить
| Необходимый.
Идентификатор бизнес-телефона WhatsApp.
| |
<BUTTON_INDEX>
Целое число
| Необходимый.
Указывает порядок отображения кнопок, если шаблон содержит несколько кнопок.
Кнопки имеют нулевой индекс, поэтому установка значения равна нулю 0 Это приведет к тому, что сначала появится кнопка, а затем другая кнопка с индексом 1 появится следующим и т. д.
| |
| Необходимый.
Код купона, который будет скопирован при нажатии покупателем кнопки. Принимаются только буквенно-цифровые символы.
Максимум 20 символов.
| |
| Необходимый.
Название шаблона, который необходимо отправить.
| купон_код_осень2023_25скидка
|
| Необходимый.
Языковой и локализационный код шаблона.
| |
| | |
В случае успеха API ответит следующим образом:
{ "messaging_product": "whatsapp", "contacts": [ { "input": "<WHATSAPP_USER_PHONE_NUMBER> ", "wa_id": "<WHATSAPP_USER_ID> " } ], "messages": [ { "id": "<WHATSAPP_MESSAGE_ID> ", "group_id": "<GROUP_ID> ",<!-- Only included if messaging a group --> "message_status": "<PACING_STATUS> "<!-- Only included if sending a template --> } ] }
Заполнитель
|
Описание
|
Пример значения
|
|---|
| Строковый идентификатор группы, созданной с помощью API групп.
В этом поле отображается информация о том, когда сообщения были отправлены, получены или прочитаны из группы.
| Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD
|
| Указывает темп шаблона статус message_status Свойство включается в ответы только при отправке сообщения шаблон сообщения который использует шаблон, темп которого отбирается. | wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI4MjZGRDA0OUE2OTQ3RkEyMzcA
|
<WHATSAPP_USER_PHONE_NUMBER>
Нить
| Номер телефона пользователя WhatsApp. Может не совпадать wa_id ценить.
| |
| Идентификатор пользователя WhatsApp. Может не совпадать вход ценить.
| |
<WHATSAPP_MESSAGE_ID>
Нить
| Идентификатор сообщения WhatsApp. Этот идентификатор отображается в связанных сообщениях сообщения вебхуки, такие как отправленные, прочитанные и доставленные вебхуки.
| wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI4MjZGRDA0OUE2OTQ3RkEyMzcA
|
локон 'https://graph.facebook.com/v25.0/106540352242922/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "messaging_product": "whatsapp", "to": "16505551234", "type": "template", "template": { "name": "coupon_code_fall2023_25off", "language": { "code": "en_US" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "25OFF" }, { "type": "text", "text": "25%" } ] }, { "type": "button", "sub_type": "COPY_CODE", "index": 1, "parameters": [ { "type": "coupon_code", "coupon_code": "25OFF" } ] } ] } }'
{ "messaging_product": "whatsapp", "contacts": [ { "input": "16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBIxRjk1REYzMDBERDE3RUI0RDYA" } ] }
