EnotPRO Logo EnotPRO

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)

Подключение бота в профиле пользователя

Как пользователь подключает бота

  1. Пользователь открывает настройки Telegram → «Business» (или «Бизнес»)
  2. Выбирает «Bots» → «Add Bot»
  3. Вводит username бота (например, @MyBusinessBot)
  4. Выбирает, какие чаты будут доступны боту:
  • Все чаты
  • Избранные чаты (пользователь выбирает конкретные чаты)
  • Никакие чаты (бот подключён, но не видит сообщения — может только управлять аккаунтом)
  1. Подтверждает подключение

Обновление 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 Удалить фото профиля бизнес-аккаунта
© 2025 EnotPRO. Все права защищены.