TelegramNotifier
Ваши приложения могут передавать вам текстовые уведомления в Telegram, используя простые HTTP запросы к Telegram-боту системы Студенты.онлайн.
Общие принципы
Бот принимает сообщения длиной до 2000 символов GET или POST запросом на собственную точку входа и передаёт полученный текст в т.н. "канал" сообщений. Для получения сообщений в диалог Telegram вам нужно связаться с ботом и создать новый "канал". Так вы получите токен для отправки сообщений. В одном диалоге с ботом вы можете быть подписаны сразу на несколько каналов. Кроме того, на один канал может быть подписано одновременно несколько пользователей (например: ваши коллеги по проекту могут одновременно с вами получать уведомления о событиях в ваших приложениях). При отправке сообщений рекомендуется использовать HTTPS протокол, но допускаются и HTTP вызовы.
Обратите внимание!
@STOUNbot является простым способом информирования разработчика о происходящих событиях в его приложении. Он может быть одним из средств обратной связи от приложения, но не следует полагаться на него полностью. 100% доставка отправленных уведомлений в чат Telegram не гарантируется.
Бот @STOUNBot
Для начала работы с ботом найдите его в поиске Telegram по никнейму @STOUNBot, начните диалог (нажав кнопку
"/start") и следуйте инструкциям бота, отправив команду /createChannel или другую из списка доступных.
Сейчас доступны следующие команды:
| /createChannel |
Создать канал для передачи сообщения
|
| /subscribe |
Подписаться на канал
|
| /unsubscribe |
Отписаться от канала
|
| /deleteChannel |
Удалить канал
|
Каналы
Каналы используются для группировки сообщений и идентификации получателей сообщения. Есть возможность
подписаться одновременно на несколько каналов и наоборот - на уведомления канала могут быть подписаны
одновременно несколько
человек.
После завершения регистрации канал будет иметь следующие, известные вам, данные:
| Название |
Является статичным префиксом для сообщений в канал. Вы его выберете сами.
|
| Токен |
Необходим для идентификации канала при отправке сообщений HTTP запросом или в
диалоге с ботом.
|
| Секретный ключ |
Строка для выполнения операций над каналом из диалога с ботом (удалить,
подписаться, отписаться).
|
Отправка уведомлений
После создания канала вы можете отправлять в него уведомления. Для этого потребуется сформировать HTTP запрос с параметрами token и message. Их допускается передать методами GET или POST.
Пример GET запроса:
https://stoun.stonline.club/notify?channel-token=XI5KQZj20pw8zYTsPagJvsIoJTkSz099&message=Пример_текста_оповещения
Об успешности выполнения запроса следует судить по HTTP коду ответа и тексту сопроводительного сообщения об ошибке.