Документация API

REST API для уведомлений через Telegram и Max. Подписчики, OTP, рассылки, формы, helpdesk.

Custom Bots — свой бот (white-label)

White-label режим: подписчики проекта общаются с вашим собственным ботом — с вашим именем, аватаром и приветствием — вместо системного бота Zapnoty. Доступен на платных тарифах.

Режим бота проекта

Режим выбирается при создании проекта: «системный бот» (по умолчанию) или «свой бот» (white-label). Режим неизменяем — подписка привязана к конкретному боту, перенести подписчиков между ботами нельзя. Если у вас уже есть проект на системном боте и нужен white-label — создайте новый проект.

Подключение бота

В разделе «Свой бот» кабинета введите токен бота — для Telegram его выдаёт @BotFather, для Max — кабинет бота. Zapnoty проверит токен, зашифрует его (AES-256-GCM) и зарегистрирует webhook. Можно подключить по одному боту на канал (Telegram и Max).

POST /api/projects/{id}/custom-bots
{
"channel": "telegram",
"token": "123456:ABC-DEF..."
}
→ { "id": "...", "channel": "telegram",
"bot_username": "my_company_bot", "status": "active" }

Приветствие и команды

Приветствие — сообщение на команду /start без deep-link: текст и до 6 кнопок-ссылок. Кастомные команды (до 20) — свои команды бота с фиксированным ответом и до 6 кнопок-ссылок, публикуются в меню бота. Имена start, help, lang, subscriptions зарезервированы под встроенную логику. Стандартная логика (подписки, OTP, helpdesk, рассылки) работает как и у системного бота.

Брендинг Mini App

Mini App использует имя, логотип и акцентный цвет проекта. Цвет (#RRGGBB) задаётся в разделе «Свой бот» и применяется к странице подписки.

Доставка сообщений

Сообщения подписчикам custom-проекта уходят через ваш бот автоматически — API не меняется. Уведомления команде и агентам helpdesk по-прежнему идут через системный бот Zapnoty (они привязаны к кабинету). У вашего бота отдельные лимиты платформы, не зависящие от системного.

Связанные разделы