Broadcast (массовая рассылка)
Отправка сообщения всем подписчикам или сегменту.
POST /v1/broadcast
Создаёт задачу рассылки. Сообщения отправляются через очередь.
text string обязательныйТекст сообщения
format string Формат текста: plain (по умолчанию), markdown или html
media object Объект медиа: {type, url}. Типы: photo, video, document
buttons array Массив рядов кнопок: [[{text, url}]] или [[{text, callback_data}]]
permission string Фильтр по permission
tags array Фильтр по тегам: ["vip", "beta"]
POST /v1/broadcast
{
"text": "Версия 2.0 доступна!",
"permission": "updates",
"tags": ["beta"]
}
Ответ
{
"job_id": "a1b2c3d4-e5f6-...",
"status": "pending",
"total_subscribers": 1500
}
GET /v1/broadcast/:job_id
Получение статуса рассылки.
Поля ответа: status (pending/processing/completed/failed), total, sent, failed.
{
"job_id": "b7f3...",
"status": "completed",
"total": 2847,
"sent": 2835,
"failed": 12
}
Связанные разделы
Быстрый старт
Первое сообщение за 2 минуты: получение ключа, deep link для подписки, отправка через curl.
Аутентификация
Как авторизовать запросы к API через Authorization: Bearer zn_… ключ проекта.
POST /v1/send — отправка
Отправка персональных уведомлений: текст, HTML/Markdown, медиа, кнопки, шаблоны.