Боты

← Приложения и файлы · Обзор · Далее: частые вопросы →

Бот — сервисный участник одного пространства. Он может публиковать сообщения, отвечать на команды, показывать кнопки и работать в комнатных или личных чатах. Раздел предназначен для владельцев пространства, администраторов и разработчиков интеграций.

Что умеет бот

• отправлять обычный и форматированный текст;
• прикладывать фото, документы, видео, аудио, voice и группы медиа;
• показывать inline- и reply-клавиатуры;
• обрабатывать slash-команды, ответы, реакции и callback-кнопки;
• работать в комнате или в личном чате участника пространства;
• получать события через webhook либо getUpdates;
• использовать Telegram-совместимый Bot API в пределах поддерживаемого профиля.

Создать бота

1. Откройте настройки пространства.
2. Перейдите в раздел Боты.
3. Нажмите Создать бота.
4. Укажите имя, короткое и полное описание.
5. Выберите каталоговую или свою иконку.
6. Настройте Privacy Mode.
7. Создайте webhook нужного типа.
8. Скопируйте выданный Bot Token и сохраните его в защищённом хранилище.

Бот навсегда принадлежит выбранному пространству и не переносится в другое.

Сохраните токен сразу

Полный Bot Token показывается только при создании или ротации. Прежний секрет нельзя запросить повторно. Не публикуйте его в чате, документации, скриншотах и логах.

Типы webhook

Тип	Назначение
Общий webhook бота	Может адресовать разные доступные чаты пространства
Webhook комнаты	Всегда работает с одной комнатой этого пространства
Личный webhook	Всегда работает с личным чатом бота и выбранного участника

Для комнаты доступен только чат этого же пространства с включённой перепиской. Пользователь личного webhook должен быть участником пространства.

Webhook можно временно выключить, снова включить, ротировать или безвозвратно отозвать. Ротация немедленно делает старый токен недействительным.

Privacy Mode

По умолчанию Privacy Mode включён. В комнатах бот получает только события, которые явно к нему относятся:

• зарегистрированные slash-команды;
• ответы на сообщения или клавиатуры бота;
• callback-кнопки;
• предусмотренные реакции.

Если режим выключен и webhook подписан на обычные сообщения, бот может получать все новые сообщения доступных комнат. Используйте это только для интеграции, которой действительно требуется полный поток.

Использовать бота в чате

Введите /, выберите команду и отправьте её. Если одинаковая команда есть у нескольких ботов, используйте квалифицированный вариант с именем бота. На сообщения бота можно отвечать, реагировать и нажимать его кнопки.

В личном чате с ботом доступны команды, обычные сообщения и клавиатуры. Пользователь может заблокировать бота для себя и позже разблокировать. Личный звонок и пользовательский опрос в таком чате недоступны.

После исключения пользователя из пространства личный чат с ботом скрывается и перестаёт открываться. История не уничтожается и снова становится доступна при возвращении membership.

Bot API

Адрес API имеет форму /bot<TOKEN>/<METHOD>. Поддерживаются основные методы identity, отправки и изменения сообщений, медиа, reactions/callbacks, команды, webhook/updates и получение сохранённых файлов.

Совместимость не равна полной совместимости с Telegram. Channels, topics, inline mode, payments, stickers и Telegram polls не входят в текущий профиль. Перед переносом существующего бота сверяйте публичную таблицу совместимости вашей версии Calls.

Для pipeline-запросов используйте Idempotency-Key, чтобы сетевой повтор не создал второе сообщение или действие.

Права и безопасность

• Управлять ботом могут владелец пространства и административные роли с соответствующим правом.
• Право на настройки бота не раскрывает закрытый комнатный или личный чат.
• Бот не адресует пользователей и комнаты другого пространства.
• Выключение, удаление или аварийная блокировка прекращает новые операции токенов.
• Удаление бота сохраняет понятную историю старых сообщений, но токены больше не работают.
• Callback, файл или chat_id всегда повторно проверяются по токену и доступу.

Если токен мог быть раскрыт, немедленно выполните Ротировать токен, обновите секрет в интеграции и проверьте журнал управления ботом.