База знаний GetMyBot

Уведомления

Где узнать о завершённой рассылке, оплате, низком балансе и сбоях бота. Как читать уведомления и отмечать их прочитанными.

На этой странице

Нажмите колокольчик вверху кабинета, чтобы узнать, завершилась ли рассылка, прошла ли оплата и не возникла ли проблема у бота. В одной ленте собраны события всех ваших ботов и объявления 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. Эти возможности настраиваются отдельно.

Что дальше