Business Bot
Business Bot (также известный как Secretary Bot или Chat Access Mode) — это бот, который пользователь может подключить к своему бизнес-аккаунту Telegram. Подключённый бот может:
- Читать входящие сообщения в чатах, указанных пользователем
- Отправлять сообщения от имени пользователя
- Управлять бизнес-аккаунтом (имя, username, bio, фото профиля)
- Блокировать/разблокировать пользователей в бизнес-аккаунте
💡 Важно: Эта функция доступна всем пользователям Telegram, не только Premium. Ранее требовалась подписка Premium.(также известный как Secretary Bot или Chat Access Mode) — это бот, который пользователь может подключить к своему бизнес-аккаунту Telegram. Подключённый бот может:
Что нужно знать перед началом
Требования к боту
| Требование | Описание |
|---|---|
| Режим секретаря | Должен быть включён в BotFather |
| Права | Бот должен иметь право can_reply (может отвечать от имени пользователя) |
| Доступ к чатам | Пользователь выбирает, какие чаты будут доступны боту |
Ограничения
| Ограничение | Значение |
|---|---|
| Доступные чаты | Только чаты, в которых пользователь был активен за последние 24 часа |
| Сообщения от ботов | Бот не видит сообщения от других ботов (если только бот-отправитель не включил режим Bot-to-Bot Communication) |
| Свои сообщения | Бот не видит сообщения, отправленные им самим |
| Доступ к истории | Бот не видит сообщения, отправленные до момента подключения |
Настройка бота в BotFather
Создание бота
Если у вас ещё нет бота, создайте его через BotFather:
- Откройте @BotFather
- Отправьте команду
/newbot - Следуйте инструкциям (имя, username, заканчивающийся на
bot)
Включение режима Secretary Mode
-
Откройте @BotFather
-
Отправьте команду
/mybots -
Выберите вашего бота
-
Нажмите «Bot Settings» → «Chat Access Mode» (или «Secretary Mode»)
-
Включите режим (Turn on)
Подключение бота в профиле пользователя
Как пользователь подключает бота
- Пользователь открывает настройки Telegram → «Business» (или «Бизнес»)
- Выбирает «Bots» → «Add Bot»
- Вводит username бота (например, @MyBusinessBot)
- Выбирает, какие чаты будут доступны боту:
- Все чаты
- Избранные чаты (пользователь выбирает конкретные чаты)
- Никакие чаты (бот подключён, но не видит сообщения — может только управлять аккаунтом)
- Подтверждает подключение
Обновление business_connection
Когда пользователь подключает, изменяет настройки или отключает бота, ваш бот получает обновление типа business_connection.
{
"update_id": 542915065,
"business_connection": {
"id": "WjqmvljjsEjVFgAA_NQHzdauVNM",
"user": {
"id": 255621638,
"first_name": "Akcium",
"last_name": "Сепрей",
"username": "AkciumKicum",
"is_bot": false,
"is_premium": true,
"language_code": "ru"
},
"user_chat_id": 255621638,
"date": 1779825995,
"can_reply": true,
"is_enabled": true,
"rights": {
"can_reply": true,
"can_read_messages": true,
"can_delete_all_messages": true,
"can_delete_sent_messages": true
}
}
}
Бизнес-сообщения (business_message)
Когда бот подключён к бизнес-аккаунту, он получает обновления business_message для всех сообщений в разрешённых чатах.
Структура сообщения
{
"update_id": 542915066,
"business_message": {
"message_id": 12345,
"business_connection_id": "WjqmvljjsEjVFgAA_NQHzdauVNM",
"chat": {
"id": 123456789,
"type": "private",
"first_name": "Клиент",
"last_name": "Иванов"
},
"from": {
"id": 123456789,
"first_name": "Клиент",
"last_name": "Иванов"
},
"date": 1779826000,
"text": "Здравствуйте! Есть вопрос по заказу."
}
}
Ключевое отличие от обычного message
| Поле | Обычный message | business_message |
|---|---|---|
| business_connection_id | Отсутствует Присутствует всегда | |
| chat.id | ID чата с ботом | ID чата пользователя с клиентом |
| Отправка ответа | Через chat_id | Через business_connection_id |
⚠️ Важно: Если бот не имеет права
can_reply, отправка сообщений черезbusiness_connection_idбудет невозможна.
Доступные реакции (методы) для Business Bots
Платформа EnotPro поддерживает следующие реакции для работы с бизнес-аккаунтами:
| Реакция | Описание |
|---|---|
| ReadBusinessMessage | Прочитать уведомление о сообщении (отметить как прочитанное в бизнес-аккаунте) |
| DeleteBusinessMessages | Удалить сообщения в бизнес-аккаунте |
| GetBusinessConnection | Получить информацию о подключении бизнес-бота |
| BanBusinessUser | Заблокировать пользователя в бизнес-аккаунте |
| UnbanBusinessUser | Разблокировать пользователя в бизнес-аккаунте |
| SetBusinessAccountName | Установить имя бизнес-аккаунта |
| SetBusinessAccountUsername | Установить username бизнес-аккаунта |
| SetBusinessAccountBio | Установить описание (bio) бизнес-аккаунта |
| SetBusinessAccountProfilePhoto | Установить фото профиля бизнес-аккаунта |
| RemoveBusinessAccountProfilePhoto | Удалить фото профиля бизнес-аккаунта |