Уведомления
Где узнать о завершённой рассылке, оплате, низком балансе и сбоях бота. Как читать уведомления и отмечать их прочитанными.
На этой странице
Нажмите колокольчик вверху кабинета, чтобы узнать, завершилась ли рассылка, прошла ли оплата и не возникла ли проблема у бота. В одной ленте собраны события всех ваших ботов и объявления GetMyBot. Переключение проекта не меняет эту ленту.
Колокольчик и счётчик
Число рядом с колокольчиком показывает, сколько уведомлений вы ещё не прочитали. Оно обновляется при новых событиях. Для подключения через API счётчик доступен по адресу 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): «Новые подписчики».
- Статистика и журнал: отслеживание расхода и баланса.
- Проекты и каналы: «Бот офлайн», «Бот снова онлайн» и карточка «Здоровье бота».