🚀 Что нового

Теперь публичный API WazzaBee поддерживает отправку согласованных шаблонов WhatsApp (HSM). Это открывает возможность для автоматизации рассылок и, что особенно важно, отправки OTP-кодов (AUTHENTICATION) прямо из вашего приложения или CRM.

🛠️ Метод API

POST /v1/messages/send

Эндпоинт для отправки сообщений был расширен. Чтобы отправить шаблон, вам необходимо вместо стандартных параметров (text или mediaUrl) передать параметр templateName с сопутствующими данными.

📋 Параметры тела запроса (JSON)

Параметр	Тип	Описание
channelId	строка (обязательно)	ID вашего подключенного WABA-канала.
chatId	строка (обязательно)	Номер телефона получателя (с кодом страны, без "+").
templateName	строка (обязательно)	Системное имя согласованного шаблона в Meta (например, `auth_code_123`).
templateLanguage	строка (опционально)	Код языка шаблона (например, `"ru"`, `"en"`). По умолчанию: "ru".
templateVariables	объект (опционально)	Переменные для подстановки в текст. В WhatsApp они нумеруются как `{{1}}`, `{{2}}`. Пример: `{"1": "Значение 1"}`.
templateHeader	объект (опционально)	Медиа-заголовок шаблона (картинка, видео, документ). Пример: `{"type": "image", "link": "https://..."}`.

📱 Пример: Отправка OTP-кода (AUTHENTICATION)

Обычно шаблоны аутентификации содержат одну переменную (сам код) и одну скрытую переменную для кнопки COPY_CODE. Наш API автоматически обрабатывает переменные тела.

⚠️ Важно: Убедитесь, что ваш шаблон в Meta согласован именно в категории AUTHENTICATION и настроен на принятие кода.

{
  "channelId": "ВАШ_CHANNEL_ID",
  "chatId": "77771234567",
  "templateName": "my_otp_template",
  "templateLanguage": "ru",
  "templateVariables": {
    "1": "456789"
  }
}

⚙️ Как это работает под капотом

Запрос: Вы отправляете JSON на POST /v1/messages/send.
Очередь: Система проверяет доступы и ставит сообщение во внутреннюю очередь (вы моментально получаете ответ HTTP 202).
Отправка: Наш воркер формирует правильный объект для провайдера (Gupshup) и отправляет шаблон напрямую в WhatsApp.
Статусы: Уведомления о доставке и прочтении приходят вам через настроенные Webhook.