Шаблоны сообщений

Шаблоны сообщений (message templates) используются для отправки structured-сообщений с переменными вне 24-часового окна свободной переписки — в первую очередь WhatsApp Business HSM-шаблоны, проходящие модерацию Meta. API покрывает CRUD шаблона, публикацию на модерацию (`submit`), архивирование и синхронизацию статуса одобрения с Meta. Готовый одобренный шаблон отправляется контакту через `POST /messages/send-template` (см. группу Сообщения).

Эндпоинты

Метод	Путь	Описание
GET	`/v1/templates` Список шаблонов с пагинацией, поиском и фасетами по статусу/языку/каналу.	Список шаблонов с пагинацией, поиском и фасетами по статусу/языку/каналу.
GET	`/v1/templates/channel-types` Типы каналов, для которых можно создавать шаблоны.	Типы каналов, для которых можно создавать шаблоны.
GET	`/v1/templates/{template}` Получить шаблон по id (тело, параметры, кнопки).	Получить шаблон по id (тело, параметры, кнопки).
GET	`/v1/templates/{template}/channels` Каналы, на которых шаблон доступен для отправки.	Каналы, на которых шаблон доступен для отправки.
POST	`/v1/templates` Создать черновик шаблона.	Создать черновик шаблона.
PATCH	`/v1/templates/{template}` Обновить черновик шаблона.	Обновить черновик шаблона.
DELETE	`/v1/templates/{template}` Удалить шаблон.	Удалить шаблон.
POST	`/v1/templates/{template}/submit` Отправить шаблон на модерацию в Meta (WhatsApp Business).	Отправить шаблон на модерацию в Meta (WhatsApp Business).
POST	`/v1/templates/{template}/publish` Опубликовать одобренный шаблон (сделать доступным для отправки).	Опубликовать одобренный шаблон (сделать доступным для отправки).
POST	`/v1/templates/{template}/archive` Архивировать шаблон.	Архивировать шаблон.
POST	`/v1/templates/{template}/unarchive` Разархивировать шаблон.	Разархивировать шаблон.
POST	`/v1/templates/sync` Синхронизировать статусы модерации всех шаблонов компании с Meta.	Синхронизировать статусы модерации всех шаблонов компании с Meta.

Примеры

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

Запрос

bash

curl -X POST "https://api.aisar.app/v1/templates" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_type": "whatsapp_business",
    "name": "Order shipped",
    "language": "ru",
    "category": "utility",
    "body": "Здравствуйте, {{1}}! Ваш заказ №{{2}} передан в доставку.",
    "parameters": [
      { "name": "first_name", "type": "text", "sample_value": "Иван", "position": 1 },
      { "name": "order_number", "type": "text", "sample_value": "1045", "position": 2 }
    ]
  }'

Ответ

json

{
  "data": {
    "id": 12,
    "company_id": 1,
    "channel_type": { "id": 4, "key": "whatsapp_business", "name": "WhatsApp Business" },
    "name": "Order shipped",
    "slug": "order_shipped",
    "status": "draft",
    "language": "ru",
    "category": "utility",
    "body": "Здравствуйте, {{1}}! Ваш заказ №{{2}} передан в доставку.",
    "parameters": [
      { "id": 1, "name": "first_name", "type": "text", "sample_value": "Иван", "position": 1 },
      { "id": 2, "name": "order_number", "type": "text", "sample_value": "1045", "position": 2 }
    ],
    "buttons": [],
    "uses_count": 0,
    "created_at": "2026-02-09T18:00:00Z",
    "updated_at": "2026-02-09T18:00:00Z"
  }
}

Отправка шаблона на модерацию

Запрос

bash

curl -X POST "https://api.aisar.app/v1/templates/12/submit" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ответ

json

{
  "data": {
    "message": "Template submitted for review.",
    "template": {
      "id": 12,
      "status": "pending"
    }
  }
}