РУ

База знаний

Регистрация

Вход

РУ

База знаний

Шаблоны WABA

Шаблоны WABA нужны на каналах WhatsApp Business API, чтобы написать клиенту первым, когда в чате не открыто окно обслуживания.

Эти шаблоны вы создаете самостоятельно и можете написать в них то, что вам нужно. Шаблоны WABA надо согласовывать с Meta*.

Узнайте в инструкции больше о том, как и когда использовать шаблоны WABA, какие ограничения есть.

В этом разделе описано, как работать с шаблонами WABA по API: создавать, получать, редактировать и удалять.

При работе с перечисленными методами используйте в заголовках токен дочернего аккаунта client_access_token, который получили с помощью упрощенной авторизации или OAuth: Authorization: Bearer client_access_token

Методы

POST /v2/templates/waba — Создание шаблона WABA
GET /v2/templates/waba — Получение списка шаблонов WABA
GET /v2/templates/waba/{template_id} — Получение шаблонов WABA по template_id
PATCH /v2/templates/waba/{template_id} — Редактирование шаблона WABA
DELETE /v2/templates/waba/{template_id} — Удаление WABA шаблона

Для управления шаблонами также можно использовать iframe Wazzup

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

Метод позволяет создать и отправить на модерацию в Meta* шаблон WABA.

Метод POST /v2/templates/waba

Структура запроса

POST /v2/templates/waba
│
├── template *
│ ├── title *
│ ├── waba *
│ │ ├── waba_id *
│ │ └── waba_name *
│ ├── channels[] *
│ ├── category *
│ ├── language *
│ ├── components[] *
│ │ ├── type
│ │ ├── format
│ │ ├── text
│ │ ├── example[]
│ │ └── buttons[]
│ │ ├── type
│ │ ├── text
│ │ └── url
│ └── tricky_templates_priority
└── is_draft *

Body-параметр. Обязательные отмечены *	Тип	Описание
`template` *	`object template`	Шаблон
`is_draft` *	`boolean`	Укажите `false`, чтобы отправить на модерацию, `true` — создать шаблон в режиме черновика

template (объект)

Body-параметр. Обязательные отмечены *	Тип	Описание
`title` *	`string`	Название шаблона в Wazzup. Нужно, чтобы пользователь смог быстрее найти шаблон в списке
`waba` *	`object waba`	Объект с информацией о бизнес-аккаунте Facebook
`channels` *	`array(string)`	ID каналов, к которым привязан шаблон
`category` *	`string`	Категория шаблона: `MARKETING`, `UTILITY`. Подробнее о категориях шаблонов и требованиях к ним — в статье
`language` *	`string`	Язык шаблона
`components` *	`array(object) components`	Компоненты шаблона
`tricky_templates_priority`	`number`	Приоритет универсального шаблона (nullable)

waba (объект)

Body-параметр. Обязательные отмечены *	Тип	Описание
`waba_id` *	`string`	ID бизнес-аккаунта WABA
`waba_name` *	`string`	Название бизнес-аккаунта WABA

components (объект)

Body-параметр. Обязательные отмечены *	Тип	Описание
`type`	`string`	Тип компонента шаблона: `HEADER` — заголовок, `FOOTER` — подпись, `BUTTONS` — кнопки, `BODY` — основной текст
`format`	`string`	Формат. Только для `HEADER`: `IMAGE`, `DOCUMENT`, `VIDEO`, `TEXT`
`text`	`string`	Текст компонента, если есть
`example`	`array(string)`	Примеры переменных для компонента
`buttons`	`array(object) buttons`	Список кнопок, если они есть

buttons (объект)

Body-параметр. Обязательные отмечены *	Тип	Описание
`type`	`string`	Тип кнопки: `URL` — ссылка, `QUICK_REPLY` — быстрый ответ, `PHONE_NUMBER` — номер телефона
`text`	`string`	Текст на кнопке
`url`	`string`	Для кнопок типа `URL` — ссылка, по которой перейдёт пользователь

Пример шаблона с медиа-заголовком, текстом, подписью и кнопками

curl -L 'https://tech.wazzup24.com/v2/templates/waba'
-H 'Authorization: Bearer <client_access_token>'
-H 'Content-Type: application/json'
-d '{
"template": {
"title": "Шаблон для быстрого поиска",
"waba": {
"waba_id": "1399322699894",
"waba_name": "Test Photo 2"
},
"channels": [
"bf65cc76-8e64-4fe3-bdef-e309946ec9"
],
"category": "MARKETING",
"language": "ru",
"components": [
{
"type": "BODY",
"text": "Привет {{1}}, Ознакомься со всем, пожалуйста"
},
{
"file": {
"name": "test.mp4",
"sha1": "123123asdasd",
"size": 2548020,
"mimetype": "video/mp4"
},
"type": "HEADER",
"format": "VIDEO"
},
{
"type":"FOOTER",
"text":"С уважением команда\u0021"
},
{
"type":"BUTTONS",
"buttons":[
{
"type":"QUICK_REPLY",
"text":"Ознакомился\u0021"
}
]
}
],
},
"is_draft": false
}

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

{
"data": {
"guid": "d61f0684-8645-4e4e-876c-307556930",
"account_id": 11111111,
"title": "Шаблон тестовый API1",
"name": "shablon_testovyy_api1_1",
"waba": {
"waba_id": "139932269209894",
"waba_name": "Test Photo 2"
},
"channels": ["bf65cc76-8e64-4fe3-bdef-e30994cec9"],
"category": "MARKETING",
"language": "ru",
"status": "pending",
"rejected_reason": null,
"components": [
{
"text": "Привет {{1}}, Ознакомься со всем, пожалуйста",
"type": "BODY"
},
{
"file": {
"name": "test.mp4",
"sha1": "123123asdasd",
"size": 2548020,
"mimetype": "video/mp4"
},
"type": "HEADER",
"format": "VIDEO"
},
{
"text": "С уважением команда!",
"type": "FOOTER"
},
{
"type": "BUTTONS",
"buttons": [
{
"text": "Ознакомился!",
"type": "QUICK_REPLY"
}
]
}
],
"tricky_templates_priority": 10,
"components_defaults": {
"file": {
"name": "test.mp4",
"sha1": "123123asdasd",
"size": 2548020,
"mimetype": "video/mp4"
}
},
"published_at": "2025-10-03T12:38:23.769Z"
},
"meta": {
"timestamp": 1759495103
}
}

Результат: Создан и отправлен на модерацию WABA шаблон с template_id: 07e8c66a-db87-4923-94bc-565c7bbd82c5. В ответе пришёл статус (status) со значением pending — это значит, что шаблон на модерации. Обо всех значениях параметра рассказали ниже в описании метода «Получение списка шаблонов WABA».

Чтобы получать информацию об изменении статуса WABA-шаблона подпишитесь на вебхуки

Получение списка шаблонов WABA

Метод GET /v2/templates/waba

Пример:

curl -L 'https://tech.wazzup24.com/v2/templates/waba?limit=50&offset=0' -H 'Authorization: Bearer <client_access_token>'

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

{
"data": [
{
"template_guid": "b68dd829-835b-4f65-b780-697f095d963d",
"account_id": 11111111,
"title": "test_webhook_4_1",
"channels": ["020e3f61-e5df-447f-8ef9-ce8258e92c7a"],
"order": 30,
"category": "MARKETING",
"language": "ru",
"status": "approved",
"quality": "UNKNOWN",
"rejected_reason": "NONE",
"components": [
{
"text": "Test WZ",
"type": "HEADER",
"format": "TEXT"
},
{
"text": "Test",
"type": "BODY"
}
],
"waba": {
"waba_id": "139932269209894",
"waba_name": "Test Photo 2"
},
"name": "test_webhook_4_1",
"namespace": "67711ae2_6cdd_4694_b1a5_4d0b124df572",
"published_at": null,
"is_tricky_template": false,
"tricky_templates_priority": null,
"created_at": "2025-02-03T10:00:03.618Z",
"updated_at": "2025-02-05T11:04:48.620Z",
"components_defaults": {},
"tags": null,
"template_code": "@template: b68dd829-835b-4f65-b780-697f095d963d { }"
},
{
"template_guid": "006cc8ca-39d8-4d79-b12c-d0a761af5e31",
"account_id": 11111111,
"title": "test_webhook_5_1",
"channels": ["020e3f61-e5df-447f-8ef9-ce8258e92c7a"],
"order": 31,
"category": "MARKETING",
"language": "ru",
"status": "approved",
"quality": "UNKNOWN",
"rejected_reason": "NONE",
"components": [
{
"text": "Проверка",
"type": "HEADER",
"format": "TEXT"
},
{
"text": "Настройка",
"type": "BODY"
}
],
"waba": {
"waba_id": "139932269209894",
"waba_name": "Test Photo 2"
},
"name": "test_webhook_6_1",
"namespace": "67711ae2_6cdd_4694_b1a5_4d0b124df572",
"published_at": null,
"is_tricky_template": false,
"tricky_templates_priority": null,
"created_at": "2025-02-03T10:00:02.943Z",
"updated_at": "2025-07-31T13:41:43.700Z",
"components_defaults": {},
"tags": null,
"template_code": "@template: 006cc8ca-39d8-4d79-b12c-d0a761af5e31 { }"
}
],
"meta": {
"timestamp": 1759495468
}
}

Результат: Список шаблонов WABA, которые были созданы в рамках текущего WABA-аккаунта.

Значения параметра status
status показывает статус модерации шаблона в Meta*.

Значение	Описание
`APPROVED`	То же, что «Активен» в ЛК Wazzup. Шаблон одобрен Meta*, его можно использовать
`PENDING`	То же, что «На модерации» в ЛК Wazzup. Meta* еще проверяет шаблон
`REJECTED`	В ЛК Wazzup — «Отклонен». Шаблон не прошел модерацию Meta*
`PAUSED`	В ЛК Wazzup — «Отклонен». На шаблон жаловались получатели, поэтому Meta* его снова проверяет
`DISABLED`	В ЛК Wazzup — «Отклонен». Шаблон заблокировали после жалоб

Получение шаблона по id

Метод GET /v2/templates/waba/{template_id}

Path-параметры
template_id — ID шаблона WABA

Пример:

curl -L 'https://tech.wazzup24.com/v2/templates/waba/b1bcd76c-52f3-4bf7-8e60-52b56ce060c5' -H 'Authorization: Bearer <client_access_token>'

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

{
"data": {
"template_guid": "b1bcd76c-52f3-4bf7-8e60-52b56ce060c5",
"account_id": 11111111,
"title": "Отредактированный шаблон",
"channels": [
"020e3f61-e5df-447f-8ef9-ce8258e92c7a",
"bf65cc76-8e64-4fe3-bdef-e309946bcec9"
],
"order": 2,
"category": "MARKETING",
"language": "ru",
"status": "approved",
"rejected_reason": "NONE",
"components": [
{
"type": "HEADER",
"format": "VIDEO"
},
{
"text": "Привет {{1}}, Ознакомься со всем, пожалуйста",
"type": "BODY",
"example": {
"body_text": [["[body-example-1]"]]
}
},
{
"text": "С уважением команда!",
"type": "FOOTER"
},
{
"type": "BUTTONS",
"buttons": [
{
"text": "Ознакомился!",
"type": "QUICK_REPLY"
}
]
}
],
"waba": {
"waba_id": "139932269209894",
"waba_name": "Test Photo 2"
},
"name": "shablon_testovyy_api_1",
"namespace": "67711ae2_6cdd_4694_b1a5_4d0b124df572",
"created_at": "2025-10-02T07:28:38.966Z",
"updated_at": "2025-10-02T08:00:06.793Z",
"components_defaults": {},
"tags": null,
"template_code": "@template: b1bcd76c-52f3-4bf7-8e60-52b56ce060c5 { [[headerContentUrl]]; [[bodyVar1]] }"
},
"meta": {
"timestamp": 1759496601
}
}

Результат: WABA шаблон с указанным template_id, если такой существует.

Редактирование шаблона WABA

Метод позволяет редактировать черновые и отклоненные шаблоны WABA. В одобренном Meta* шаблоне можно изменить только название шаблона (title) и каналы (channels).

Метод PATCH /v2/templates/waba/{template_id}

Path-параметры
template_id — ID ранее созданного шаблона WABA

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

curl -L -X PATCH 'https://tech.wazzup24.com/v2/templates/waba/2ae3f91d-3107-4946-8315-9a6a80cbdde0' -H 'Authorization: Bearer <client_access_token>' -H 'Content-Type: application/json' -d '{
"template": {
"guid": "b1bcd76c-52f3-4bf7-8e60-52b56ce060c5",
"title": "Отредактированный шаблон",
"waba": {
"waba_id": "139932269209894",
"waba_name": "Test Photo 2"
},
"channels": [
"020e3f61-e5df-447f-8ef9-ce8258e92c7a",
"bf65cc76-8e64-4fe3-bdef-e309946bcec9"
],
"category": "MARKETING",
"language": "ru",
"components": [
{
"type": "BODY",
"text": "Привет {{1}}, Ознакомься со всем, пожалуйста"
},
{
"type": "HEADER",
"format": "VIDEO"
}
],
"tricky_templates_priority": 10
},
"is_draft": false
}'

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

{
"data": {
"guid": "b1bcd76c-52f3-4bf7-8e60-52b56ce060c5",
"account_id": 11111111,
"title": "Отредактированный шаблон",
"name": "shablon_testovyy_api_1",
"waba": {
"waba_id": "139932269209894",
"waba_name": "Test Photo 2"
},
"channels": [
"020e3f61-e5df-447f-8ef9-ce8258e92c7a",
"bf65cc76-8e64-4fe3-bdef-e309946bcec9"
],
"category": "MARKETING",
"language": "ru",
"status": "approved",
"rejected_reason": "NONE",
"components": [
{
"text": "Привет {{1}}, Ознакомься со всем, пожалуйста",
"type": "BODY"
},
{
"type": "HEADER",
"format": "VIDEO"
}
],
"tricky_templates_priority": 10,
"components_defaults": {},
"published_at": "2025-10-02T07:28:38.945Z"
},
"meta": {
"timestamp": 1759495552
}
}

Результат: Шаблон template_id: b1bcd76c-52f3-4bf7-8e60-52b56ce060c5 обновлен.

Удаление шаблона WABA

Метод DELETE /v2/templates/waba/{template_id}

Path-параметры
template_id — ID ранее созданного шаблона WABA

Пример:

curl -L -X DELETE 'https://tech.wazzup24.com/v2/templates/waba/2ae3f91d-3107-4946-8315-9a6a80cbdde0' -H 'Authorization: Bearer <client_access_token>'

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

{
"data": null,
"meta": {
"timestamp": 1759485643
}
}

Результат: Шаблон template_id: 2ae3f91d-3107-4946-8315-9a6a80cbdde0 удален.

*Запрещены и признаны экстремистскими на территории РФ