База знаний

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

Telegram Business позволяет подключить бота к личному бизнес-аккаунту: он отвечает на сообщения, ведёт профиль, управляет stories, gifts и Stars. Разбираем, что это за слой, как подключить и какие есть ограничения.

Опубликовано

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

📌
Коротко: Telegram Business Bot — это обычный Telegram-бот, которому бизнес-аккаунт выдаёт права работать от его имени. Бот может читать и писать в личные чаты пользователя, редактировать профиль, управлять stories, отправлять gifts и платежи в Stars. Всё это поверх Telegram Bot API через объект business_connection.

Что это такое

Telegram Business — это набор функций, доступных любому Premium-пользователю бесплатно. Аккаунт остаётся личным, но получает «бизнес-обвес»: часы работы, адрес, приветствие, автоответы вне рабочего времени, набор быстрых ответов и возможность подключить бота-помощника.

Когда пользователь подключает бота к своему бизнес-аккаунту, Telegram создаёт business_connection — связку, по которой бот получает апдейты о входящих сообщениях в личных чатах пользователя и может отвечать так, будто это пишет сам человек. Для собеседника это выглядит как обычный диалог с владельцем аккаунта; в API сообщения помечаются специальным полем via_business_bot_id.

Это принципиально отличается от классической схемы «у меня есть бот @MyShopBot, в него пишут клиенты»: тут клиенты пишут вам лично, а бот молча работает за вас.

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

ВозможностьЧто делает бот
Сообщения в личных чатахПолучает входящие, отправляет ответы, редактирует и удаляет свои сообщения, ставит реакции, отмечает прочитанным
Быстрые ответы (Quick Replies)Создаёт и редактирует шорткаты с готовыми ответами, отправляет их по команде
Профиль аккаунтаМеняет имя, фамилию, имя пользователя, био, аватар, подарочные настройки
StoriesПубликует, редактирует и удаляет stories от имени пользователя
GiftsПросматривает, отправляет, конвертирует и трансферит подарки
StarsЗапрашивает баланс бизнес-аккаунта, переводит звёзды и принимает платежи
ЧеклистыОтправляет интерактивные чеклисты, обновляет статусы пунктов

Всё это управляется через бизнес-права бота (businessBotRights): пользователь сам выбирает, что разрешить, — например, можно дать только чтение и ответы, но запретить менять профиль и публиковать stories.

⚖️
Важный нюанс: бот работает только в личных чатах. Группы и каналы пользователя ему недоступны — это сделано осознанно, чтобы бот случайно не наговорил лишнего в общем эфире.

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

Подключение состоит из двух частей: бизнес-аккаунт настраивает права, бот ловит апдейты и работает с API.

Шаг 1. Подготовить бота

  1. Создайте обычного бота через @BotFather.
  2. В настройках бота включите Business Mode (/mybots → Bot Settings → Business Mode → Turn on). Без этого Telegram не покажет бота в списке доступных.
  3. Опишите бота понятно — пользователь будет выбирать его в интерфейсе Telegram Business.

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

Пользователь идёт в Settings → Telegram Business → Chatbots, вводит юзернейм бота и выставляет права: чтение, ответы, управление профилем, stories, gifts, Stars. После подтверждения бот получает апдейт business_connection с уникальным business_connection_id — это ключ ко всем последующим вызовам.

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

Телеграм шлёт боту два новых типа апдейтов:

  • business_message — входящее сообщение в личном чате пользователя.
  • edited_business_message — редактирование такого сообщения.

Каждый апдейт несёт business_connection_id и обычный message. Бот отвечает методом sendMessage, передавая тот же business_connection_id, — Telegram отправит сообщение от имени пользователя.

# Пример на python-telegram-bot 21+
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,
    )

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

Для действий «от имени аккаунта» Bot API даёт отдельный набор методов с префиксом setBusinessAccount* и *BusinessAccount*:

  • setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto — профиль (требуют права can_change_*).
  • getBusinessAccountStarBalance, transferBusinessAccountStars — баланс и переводы Stars.
  • getBusinessAccountGifts, convertGiftToStars, transferGift, upgradeGift — подарки.
  • postStory, editStory, deleteStory — stories.
  • readBusinessMessage, deleteBusinessMessages — служебные действия с входящими.

Каждый метод принимает business_connection_id и проверяет право, выданное пользователем.

# Сменить био бизнес-аккаунта от имени бота
curl -X POST "https://api.telegram.org/bot$BOT_TOKEN/setBusinessAccountBio" \
  -H "Content-Type: application/json" \
  -d '{
    "business_connection_id": "abc123...",
    "bio": "Отвечаем в течение часа в рабочее время"
  }'
💡
Совет: удобнее всего работать через современные SDK — aiogram 3.x, grammY, python-telegram-bot 21+, Telegraf 4.16+. У всех есть нативная поддержка business_connection_id и хелперы для бизнес-методов.

Тарифы и лимиты

  • Bot API сам по себе бесплатен — без комиссий, без квот по сообщениям, без оплаты за аккаунт. Платите только за свою инфраструктуру.
  • Telegram Business доступен бесплатно для Premium-подписчиков. Без Premium у пользователя не будет раздела «Business» в настройках — и бот к такому аккаунту просто не подключится.
  • Лимиты Bot API стандартные: ~30 сообщений в секунду суммарно, до 1 в секунду в один чат. Для бизнес-чатов это с большим запасом.
  • Платежи в Stars идут по правилам Telegram Bot Payments: комиссии Telegram нет, но владелец бота сам организует возвраты и поддержку (/paysupport).
  • Чувствительные методы (профиль, stories, gifts) включаются только при явном выдаче права в интерфейсе Business — отдельной платы нет, но без галочки метод вернёт ошибку.
⚠️
Внимание: даже если у бота есть can_change_username, имя пользователя в Telegram должно быть свободным и удовлетворять правилам платформы. Бот не получит занятое имя, как и обычный пользователь.

Практические сценарии

Личный AI-ассистент для предпринимателя. Все клиенты пишут в личный аккаунт владельца. Бот ловит входящие, классифицирует через LLM, отвечает на типовые вопросы, эскалирует сложные — оставляет их «непрочитанными» для человека.

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

Автоматическая поддержка вне рабочего времени. Сначала срабатывает встроенный Away Message, потом подключается бот: разбирает обращение, заводит тикет в вашей системе, обещает ответ в начале рабочего дня — и сам же отвечает утром, когда вы готовы.

Менеджер контента. Бот публикует stories по расписанию, обновляет био, ротирует аватарку под акции, отправляет ежемесячные подарки топ-клиентам через Gifts — без ручных действий владельца.

Чеклисты для работы с клиентами и подрядчиками. Бизнес-аккаунт отправляет в чат интерактивный чеклист (бриф, согласование, прогон по проекту), а бот следит за статусом пунктов и подсказывает следующий шаг.

Ссылки


По теме

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