Подключение Telegram

Результат

Вы установите отдельный Telegram bot для проекта, проверите webhook, свяжете пользователей Threadory и разрешите только нужные chats.

В продакшене сейчас работает доставка Telegram notifications, включая weekly digest. Connector также предоставляет messaging и chat administration, но Telegram не является общим knowledge-ingestion source. Не обещайте Q&A или write-back сверх возможностей Telegram, перечисленных в матрице интеграций.

Что потребуется

• Роль Admin или Owner в проекте Threadory.
• Право создать bot через Telegram @BotFather.
• Webhook endpoint Threadory, доступный Telegram.
• Заранее определённый список private chats или groups.

Telegram bot token — credential без отдельных scopes. Считайте его secret и не размещайте в ticket, screenshot, Git или chat.

Профиль подключения

Параметр	Минимум или ожидаемое поведение
Credential	Отдельный Telegram bot token от @BotFather. Token не имеет scopes и управляет всем bot.
Минимальный доступ	У Telegram bot token нет OAuth scopes. Ограничивайте доступ через privacy/group permissions, allowed chat types и project-level список Allowed chats.
Identity	Сообщения отправляются от настроенного bot, а не от каждого пользователя Threadory. Pairing связывает Telegram account с Threadory user для attribution.
Направление и entities	Incoming messages/callbacks могут запускать настроенные interactions; outbound actions отправляют или изменяют bot messages. Connector не создаёт Knowledge entities.
Delivery mode	Только webhook. Telegram events проверяются per-installation secret-token header; polling fallback отсутствует.

Создать и проверить bot

1. Откройте @BotFather в Telegram.
2. Отправьте /newbot и задайте name и username.
3. Скопируйте API token во временное разрешённое secret-хранилище.
4. В Threadory выберите project и откройте Connectors → Telegram.
5. Вставьте token в Telegram bot token.
6. Нажмите Probe connection.
7. Проверьте name, username и badges возможностей groups/privacy.

Остановитесь, если Threadory показывает не тот bot, который вы собирались подключить.

Установить connector

1. Оставьте включённым Auto-generate webhook secret. Verification token будет создан server-side.
2. Оставьте Register now включённым, если Threadory API доступен из интернета.
3. Нажмите кнопку install и дождитесь закрытия drawer.
4. Откройте Settings → Telegram.
5. В Bot identity проверьте username и group capabilities.
6. В Webhook health проверьте webhook path и Last delivery после первого test event.

Manual webhook secret и delayed registration используйте только вместе с platform operator: они меняют deployment prerequisites.

Связать пользователя

1. В Settings → Telegram нажмите Generate code.
2. Приватно передайте code или bot link нужному авторизованному пользователю Threadory.
3. В direct message bot пользователь отправляет /start <code>.
4. В Linked Telegram accounts проверьте Telegram identity и email Threadory.

Code истекает через 24 часа. Используйте Unlink, если mapping ошибочен или пользователь отключён.

Разрешить chat

1. Добавьте bot в нужный private chat или group.
2. Отправьте безопасное test message, чтобы chat появился в Known chats.
3. Проверьте title и type.
4. Включите Allowed только для нужного chat.
5. Оставьте неизвестные chats выключенными.

Forget удаляет сохранённую conversation history и заставляет bot считать chat новым. Действие destructive; сначала экспортируйте нужные records.

Как проверить результат

• Bot identity показывает ожидаемый @username.
• В Webhook health есть недавний Last delivery.
• Нужный user появился в Linked Telegram accounts.
• Allowed включён только для утверждённых chats.
• Настроенный low-risk notification или digest один раз пришёл в нужный chat.

Частые проблемы

Симптом	Вероятная причина	Что сделать
Probe возвращает 401	Bot token неверен или отозван	Скопируйте актуальный token из @BotFather и повторите probe
Settings предлагает сначала установить connector	Project installation не завершён	Вернитесь в Connectors → Telegram и повторите probe/install
Webhook delivery не появляется	Public webhook недоступен или registration не удался	Попросите platform operator проверить routing до rotation secrets
Pairing code не работает	Code истёк, введён с ошибкой или использован другим Threadory user	Создайте новый code и приватно передайте нужному пользователю
Group messages отсутствуют	Privacy mode или permissions bot блокируют delivery	Проверьте capability badges и настройки @BotFather до расширения доступа
Bot игнорирует известный chat	Allowed выключен	Проверьте identity chat и осознанно включите его
Bot token мог утечь	Token оказался в небезопасном месте	Отзовите его в @BotFather, обновите connector и проверьте audit/activity

Безопасное отключение

Отключение останавливает новые bot messages, callbacks и interactions связанных пользователей. Оно не отзывает уже доставленные в Telegram сообщения и не удаляет project audit records. Forget удаляет сохранённую историю chat без product rollback; сначала экспортируйте нужные записи.

1. Отключите notifications и workflows, использующие bot.
2. Проверьте pending approvals и нужные Telegram records.
3. Сделайте export необходимых project data.
4. Unlink users и отключите или забудьте chats по retention policy.
5. Отключите connector в Threadory.
6. Отзовите bot token в @BotFather, если bot больше не используется.

Убедитесь, что Telegram settings больше не показывают установленный connector, webhook удалён или больше не получает deliveries, а low-risk test notification не отправляется. Для восстановления установите новый token, снова выполните pairing пользователей и явно разрешите только проверенные chats.

Следующий шаг

Настройте audit и Telegram retention, а статус и возможности коннекторов сверяйте с integration matrix.