Интеграция с Telegram
Обзор
Telegram — основной транспортный слой в Signailist. Он используется для:
- Сбора новостей из каналов и чатов.
- Доставки сигналов при обнаружении горячих событий.
- Модерации автопубликаций через карточки approve/reject.
- Публикации утвержденного контента в целевые каналы.
Подключение аккаунта
Для работы с Telegram workspace подключает аккаунт через MTProto-авторизацию. Один и тот же Telegram-аккаунт можно привязать к нескольким workspace, и эти сессии не конфликтуют.
Роли для сбора и публикации
Telegram-аккаунт может использоваться в двух ролях:
- Сбор: чтение сообщений из настроенн ых источников.
- Публикация: отправка утвержденного контента в целевые каналы.
Роли можно включать независимо или совмещать на одном аккаунте.
Источники
Источник — это Telegram-канал или чат, который мониторит Signailist.
- Типы: канал или чат.
- Видимость: публичный по username или приватный через список диалогов подключенного аккаунта.
- Режим сбора: автоматический сбор по расписанию и ручной запуск из интерфейса.
Модерация автопубликаций
Модерация автопубликаций работает через Telegram-бота. Когда сигнал создает черновик публикации, карточка модерации отправляется в назначенный чат модератора, чтобы reviewer мог утвердить или отклонить материал, не выходя из Telegram.
Telegram в основных сценариях
| Сценарий | Что делает Telegram |
|---|---|
| Подключение аккаунта | Авторизует workspace-сессию |
| Загрузка диалогов | Дает список доступных чатов и каналов |
| Сбор сообщений | Читает историю сообщений из выбранных источников |
| Доставка сигнала | Отправляет алерты в Telegram-чаты |
| Модерация автопубликации | Отправляет карточки модерации и принимает решение модератора |
| Публикация в канал | Доставляет утвержденный контент в целевой канал |
Ограничения
- Приватные каналы нельзя подключить автоматически. У подключенного аккаунта уже должен быть к ним доступ.
- Если достигнуты лимиты Telegram API, сбор приостанавливается и возобновляется позже автоматически.
- Доставка через бота зависит от
TELEGRAM_BOT_TOKEN. Без него bot delivery недоступен. - Если меняется ключ шифрования сессий, существующие Telegram-сессии становятся невалидными и требуют переподключения.