Telegram Business Bots — как боты управляют бизнес-аккаунтом в Telegram

Telegram Business — набор возможностей для пользовательского аккаунта Telegram: часы работы, локация, быстрые ответы, приветствия, автоответы, стартовая страница и подключаемые боты. Бизнес-бот может обрабатывать выбранные личные чаты и выполнять разрешённые действия от имени владельца аккаунта.

Что такое Telegram Business Bot

Telegram Business позволяет оформить аккаунт и автоматизировать общение. Подключение совместимого бизнес-бота к пользовательскому аккаунту доступно без Telegram Premium. По документации Telegram, все функции Telegram Business доступны бесплатно подписчикам Premium, а подключаемые боты дополнительно доступны пользователям без Premium.

Когда пользователь подключает бота, Telegram создаёт бизнес-соединение (BusinessConnection). Бот получает относящиеся к соединению апдейты и может отвечать от имени владельца в пределах выбранных чатов и выданных прав. В исходящем сообщении, отправленном через бизнес-соединение, поле sender_business_bot объекта Message указывает бота, который отправил его от имени бизнес-аккаунта.

Клиенты продолжают писать владельцу в обычный личный чат. Бот обрабатывает включённые диалоги в фоне, поэтому отдельный публичный бот-витрина для такого сценария не обязателен.

По состоянию на 10 сентября 2026 года к одному пользовательскому аккаунту можно подключить только одного бизнес-бота. Владелец может выбрать получателей, исключить отдельные чаты, приостановить бота в конкретном диалоге или полностью отключить соединение.

Основные возможности

Доступ определяется объектом прав BusinessBotRights. Например, пользователю можно разрешить боту отвечать на сообщения, но запретить менять профиль или управлять stories. Перед чувствительным вызовом приложение должно проверять актуальное состояние соединения и нужное право.

Подключение и интеграция

Подключение состоит из двух частей: пользователь выбирает бота, чаты и права, а приложение бота принимает апдейты и вызывает Bot API с идентификатором соединения.

Что понадобится

• Токен бота от @BotFather.
• Отдельный тестовый аккаунт Telegram для безопасной проверки.
• Публичный HTTPS-эндпоинт для webhook или процесс, вызывающий getUpdates.
• Среда выполнения и HTTP-клиент либо SDK (набор средств разработки) с поддержкой нужной версии Bot API.

Шаг 1. Включить Secretary Mode

1. Создайте обычного бота через @BotFather.
2. Включите для него Secretary Mode — режим, который позволяет подключать бота к пользовательским аккаунтам. В технической документации также встречается название business mode.
3. Вызовите getMe и убедитесь, что поле can_connect_to_business равно true.
4. Добавьте понятное имя и описание, чтобы пользователь мог узнать бота при подключении.

Точный путь к настройке в @BotFather может меняться. Ориентируйтесь на пункт Secretary Mode выбранного бота.

Шаг 2. Подключить бота к аккаунту

В актуальном клиенте Telegram откройте настройки Telegram Business или раздел подключения чат-бота, выберите бота, получателей и права. Названия и расположение пунктов могут отличаться между платформами и версиями приложения.

После подключения бот получает апдейт business_connection с объектом BusinessConnection. Сохраните:

• id как business_connection_id;
• состояние соединения;
• актуальный набор прав.

Подключение, отключение или изменение параметров создаёт новый апдейт business_connection. При изменении настроек Telegram может выдать новый идентификатор соединения, поэтому сохранённое состояние нужно заменить.

Шаг 3. Принимать сообщения

Bot API передаёт три основных типа апдейтов:

• business_message — новое сообщение, связанное с бизнес-аккаунтом;
• edited_business_message — новая версия сообщения;
• deleted_business_messages — сведения об удалённых сообщениях.

Объект Message содержит business_connection_id. Для ответа вызовите sendMessage, передав идентификатор чата и тот же идентификатор соединения.

# Для версии python-telegram-bot, которая поддерживает
# business_message и business_connection_id.
async def on_business_message(update, context):
    msg = update.business_message
    await context.bot.send_message(
        chat_id=msg.chat.id,
        text="Спасибо, я на связи!",
        business_connection_id=msg.business_connection_id,
    )

До отправки проверьте, что соединение активно, чат входит в выбранный круг получателей, а в BusinessBotRights присутствует can_reply. Для отправки и редактирования сообщений это право действует в подходящих личных чатах с входящим сообщением за последние 24 часа. Для редактирования бизнес-сообщений, которые бот не отправлял и которые не содержат встроенной клавиатуры (inline keyboard), дополнительно действует ограничение в 48 часов с момента отправки.

Шаг 4. Управлять профилем, stories, gifts и Stars

Бизнес-методы Bot API принимают business_connection_id. Среди них:

• setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto — изменение профиля;
• getBusinessAccountStarBalance, transferBusinessAccountStars — баланс и перевод Stars;
• getBusinessAccountGifts, convertGiftToStars, transferGift, upgradeGift — операции с подарками;
• postStory, editStory, deleteStory, repostStory — управление stories;
• readBusinessMessage, deleteBusinessMessages — работа с сообщениями;
• sendChecklist, editMessageChecklist — работа с чеклистами.

Метод выполнится только при активном соединении, подходящем праве и соблюдении ограничений объекта. Например, editStory разрешает редактировать story, ранее опубликованную этим ботом от имени соответствующего аккаунта.

# Сменить био бизнес-аккаунта.
# Передайте значения через переменные окружения.
curl -X POST "https://api.telegram.org/bot${BOT_TOKEN}/setBusinessAccountBio" -H "Content-Type: application/json" -d @- <<JSON
{
  "business_connection_id": "${BUSINESS_CONNECTION_ID}",
  "bio": "Отвечаем в течение часа в рабочее время"
}
JSON

Шаг 5. Проверить результат

1. Убедитесь, что getMe возвращает can_connect_to_business: true.
2. Подключите бота к тестовому аккаунту.
3. Дождитесь business_connection с активным соединением и нужными правами.
4. Отправьте сообщение в личный чат тестового аккаунта, включённый в получателей.
5. Проверьте получение business_message с непустым business_connection_id.
6. Ответьте через sendMessage, передав этот идентификатор.
7. Убедитесь в клиенте, что ответ появился от имени владельца аккаунта.
8. Проверьте, что sender_business_bot в возвращённом Message указывает отправившего сообщение бота.

Если апдейт подключения приходит, а сообщения отсутствуют, проверьте allowed_updates, настройки получателей и исключённые чаты. При ошибке отправки сначала сверьте сохранённое состояние с последним апдейтом business_connection. Если процесс ещё не сохранил сведения о соединении, запросите getBusinessConnection по известному идентификатору.

Тарифы и ограничения

Сведения проверены 10 сентября 2026 года по официальной документации Telegram.

• Подключение бизнес-бота не требует Telegram Premium. Это не означает, что все остальные функции Telegram Business доступны без Premium.
• Одновременно подключается один бизнес-бот. Это текущее ограничение пользовательского аккаунта.
• Инфраструктура оплачивается отдельно. Сервер, база данных, очереди и внешние модели относятся к вашему проекту.
• Для сообщений действует окно недавней активности. Право can_reply применяется к подходящим личным чатам с входящим сообщением за последние 24 часа. readBusinessMessage также требует, чтобы чат был активен в последние 24 часа.
• Некоторые операции с gifts требуют активного чата. Например, у transferGift чат нового владельца должен быть активен в последние 24 часа.
• Частотные ограничения сохраняются. Обрабатывайте 429 Too Many Requests и параметр retry_after.
• Stars и gifts требуют отдельных прав. Доступность операции зависит от баланса, состояния подарка и условий метода.
• Идентификатор соединения не заменяет проверку прав. Для каждого действия нужно соответствующее поле BusinessBotRights.

Полезные сценарии

Личный AI-ассистент предпринимателя

Клиенты пишут в личный аккаунт, а нужные диалоги включены в получателей бизнес-бота. Бот классифицирует обращения, отвечает на типовые вопросы и передаёт сложные случаи человеку. Результат проверяется в исходном чате и по сохранённой связи ответа с business_connection_id.

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

Магазин без отдельного бота-витрины

Клиент пишет владельцу аккаунта. Бизнес-бот отправляет карточки товаров, собирает данные заказа и запускает поддерживаемый платёжный сценарий. Проверяемый результат: клиент получает подтверждение в том же чате, а заказ появляется во внутренней системе с идентификаторами чата и соединения.

До запуска отдельно проверьте правила платежей, возвратов и доступность методов для выбранного типа оплаты.

Поддержка вне рабочего времени

Встроенное сообщение сообщает график, а бот классифицирует обращение и создаёт тикет. Клиент получает подтверждение, оператор видит исходное сообщение и срок ответа. Поле is_from_offline объекта Message помогает отличить сообщение, отправленное бизнес-аккаунтом в офлайн-режиме, от обычной переписки. Само это поле не доказывает, что сообщение создано конкретным автоответом.

Нужна защита от повторных ответов и циклов автоматизации.

Менеджер контента

Бот публикует stories по расписанию, обновляет био или фотографию профиля и выполняет разрешённые операции с gifts. Результат проверяется по ответу API и изменению в клиенте Telegram.

Выдавайте минимальный набор прав. Учитывайте, что редактирование story ограничено объектами, опубликованными тем же бизнес-ботом.

Чеклисты для клиентов и подрядчиков

Бизнес-аккаунт отправляет интерактивный чеклист, а бот принимает сервисные сообщения об изменении задач и синхронизирует их с внутренней системой. Наблюдаемый результат: статусы пунктов в Telegram и проектной системе совпадают.

Используйте сценарий только с версией SDK, поддерживающей sendChecklist, editMessageChecklist и связанные типы сообщений.

Взаимодействие с другими ботами

Начиная с Bot API 10.0 бизнес-бот может отвечать другим ботам, если для него включён режим взаимодействия бот-бот (bot-to-bot). Для отправки личного сообщения другому боту по username режим должен быть включён у отправителя и получателя.

Добавьте дедупликацию, частотные ограничения и максимальную глубину диалога, чтобы два бота не создали бесконечный цикл.

Официальные ссылки

• Bot API: core.telegram.org/bots/api
• Возможности бизнес-ботов: core.telegram.org/bots/features#bots-for-business
• Подключённые бизнес-боты: core.telegram.org/api/bots/connected-business-bots
• Telegram Business: core.telegram.org/api/business
• Changelog Bot API: core.telegram.org/bots/api-changelog
• Payments и Stars: core.telegram.org/bots/payments-stars
• Канал обновлений Bot API: @BotNews
• SDK: grammY, aiogram, python-telegram-bot, Telegraf

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

Если вы хотите расширить автоматизацию вокруг личного Telegram, посмотрите материал Telegram как рабочий интерфейс.

Связанные материалы

• Статья: Codex, Саркис и два месяца боли: как я наконец-то собрал рабочую инфраструктуру ИИ-агентов
• Блог: Люди + агенты в одном чате: как мы собрали рабочий контур в Telegram
• База знаний: Telegram Checklists — чеклисты в Bot API от имени business account

Если вы планируете автоматизировать поддержку или продажи через личный Telegram, такой контур полезно обсудить на примере ваших чатов, прав и ограничений.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov