Уведомления
Центр уведомлений и колокольчик: события ботов, счётчик непрочитанных, объявления.
На этой странице
Центр уведомлений сообщает о событиях ваших ботов. Он открывается по колокольчику в верхней панели. Там собираются и события по вашим ботам (рассылка завершена, платёж прошёл, мало баланса), и общие объявления платформы. Лента уведомлений привязана к аккаунту и видна на всех ботах сразу.
Колокольчик и счётчик
В верхней панели есть иконка колокольчика с счётчиком непрочитанных. Счётчик берётся отдельным дешёвым запросом (GET /api/notifications/unread-count) и обновляется по мере появления событий. Клик по колокольчику открывает ленту.
Лента уведомлений
Лента (GET /api/notifications) объединяет два источника:
- Уведомления: события по вашим ботам и аккаунту.
- Объявления: общие сообщения платформы для всех пользователей.
У каждого элемента есть заголовок, текст, привязка к боту (если событие ботовое), время и признак «прочитано».
Типы событий
- Рассылка завершена (
broadcast_done): массовая отправка закончилась. - Платёж прошёл (
payment_succeeded): пополнение баланса подтверждено. - Тариф продлён (
subscription_renewed): подписка обновилась. - Мало баланса (
balance_low): остаток запросов на исходе. - Ошибка бота (
bot_error): бот столкнулся с проблемой. - Новые подписчики (
new_subscribers): у бота прибавилось аудитории. - Бот офлайн (
bot_offline): у бота дольше порога из карточки «Здоровье бота» нет ни одной отметки о жизни; в тексте названа причина и что с ней делать. Уведомление получает владелец бота, по одному на инцидент. - Бот снова онлайн (
bot_online): отметки о жизни вернулись; в тексте длительность перерыва. Приходит только тем, кому до этого пришло «Бот офлайн».
Отметка прочитанным
- Один элемент:
POST /api/notifications/read(по источнику и идентификатору). - Все сразу:
POST /api/notifications/read-allотмечает прочитанным всю ленту и обнуляет счётчик.
Это не уведомления клиентам
Всё, что описано на этой странице, предназначено вам и вашей команде: оно приходит в кабинет и в операторские мобильные приложения и привязано к вашему аккаунту. Уведомления вашим клиентам: другая система с другим хранилищем, другими ключами и другой аудиторией: пуш в браузере для посетителей сайта и клиентский SDK для вашего мобильного приложения. Включение одного никак не влияет на другое.
Что дальше
- Рассылки: событие «Рассылка завершена».
- Платежи и баланс: «Платёж прошёл», «Тариф продлён», «Мало баланса».
- Люди (CRM): «Новые подписчики».
- Статистика и журнал: отслеживание расхода и баланса.
- Проекты и каналы: «Бот офлайн», «Бот снова онлайн» и карточка «Здоровье бота».