Интеграция с Телеграм

Интеграция с Телеграм работает через вашего собственного бота: пространство подключает бота, подписывает командные разделы на чаты — и получает уведомления о страницах и комментариях прямо в Телеграм. Участники, привязавшие свой аккаунт, могут искать и открывать страницы командами /search и /get.

Настройка (администратор пространства)

Требуется роль OWNER или ADMIN и тариф с пространством разработчика.

1. Создайте бота

Напишите @BotFather в Телеграм команду /newbot и получите токен. Формат токена — числовой id, двоеточие и не менее 30 символов (латиница, цифры, _, -), например 1234567890:AAE…; строки другого вида отклоняются ещё до сохранения.

2. Подключите бота к пространству

Откройте Настройки пространства → Телеграм и вставьте токен. AnyNote сразу выполняет рукопожатие: проверяет токен (getMe) и регистрирует вебхук бота (setWebhook). Если оба шага успешны, подключение становится активным; иначе сохраняется статус ошибки с описанием от Bot API — исправьте причину и нажмите «Проверить» для повторного рукопожатия.

• Токен хранится в зашифрованном виде и никогда не возвращается обратно — ни в интерфейс, ни в API.
• На пространство — одно подключение; повторное подключение заменяет токен и секреты и сбрасывает счётчик ошибок.
• «Отключить» снимает вебхук у бота (по возможности), останавливает доставки и переводит подключение в статус «отключено».

3. Добавьте бота в чаты

Добавьте бота в нужные группы или каналы. Чаты регистрируются автоматически и появляются в списке чатов в настройках; лишний чат можно удалить — вместе с ним удаляются его подписки.

4. Подпишите разделы на чаты

Создайте подписку: выберите чат, командный раздел и набор событий (каталог тот же, что у вебхуков: page.created, page.content_updated, page.properties_updated, page.moved, page.deleted, page.undeleted, comment.created, comment.resolved; минимум одно событие).

• Подписать можно только командные разделы — личные разделы и сайты не предлагаются и отклоняются.
• Один чат нельзя подписать на один раздел дважды.
• На подключение — не более 50 подписок.

В настройках доступны журнал доставок и журнал аудита команд.

Привязка аккаунта (любой участник)

Команды /search и /get работают только для участников, привязавших свой Telegram-аккаунт:

1. Откройте Настройки → Интеграции (/settings/integrations) и выпустите код привязки. Код — 8 символов (заглавные латинские буквы и цифры, без похожих 0/O/1/I), действует 15 минут, одноразовый. Выпуск нового кода аннулирует предыдущий.
2. Отправьте боту команду:

/link ВАШКОД12

Регистр не важен — код приводится к верхнему регистру. После успешной привязки бот подтверждает связь.

• Один Telegram-аккаунт привязывается к одному пользователю; повторная привязка с нового аккаунта заменяет старую. Аккаунт, уже привязанный к другому пользователю, отклоняется.
• Коды хранятся только в виде SHA-256-хеша; в журнал аудита код не попадает.
• Отвязать аккаунт можно в тех же настройках в любой момент.

Команды бота

В группах поддерживается адресация /команда@ИмяБота. Неизвестные команды получают ответ-подсказку; сообщения без команд бот игнорирует.

Лестница прав

Перед выполнением /search и /get проверяются по порядку:

1. Привязка — Telegram-аккаунт отправителя привязан через /link;
2. Членство — привязанный пользователь состоит в пространстве подключения;
3. Область чата — у чата есть хотя бы одна подписка на раздел.

Поиск и выдача ограничены разделами, на которые подписан именно этот чат. Для /get некорректный, чужой или удалённый идентификатор даёт один и тот же ответ «не найдено» — по ответу нельзя выяснить существование страницы.

Конфиденциальность

• Личные разделы не покидают пространство: подписать на чат можно только командные разделы, и команды ищут только в подписанных разделах этого чата.
• Сообщения бота содержат только заголовки и ссылки — содержимое страниц в Телеграм не передаётся.
• Каждая команда — включая отказы и неизвестные команды — фиксируется в журнале аудита, доступном администраторам пространства.
• Токен бота и секрет вебхука хранятся в зашифрованном виде; коды привязки — только в виде хеша.