Сделать бота для бизнес-аккаунта

Что это

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

Как сделать

1. В @BotFather включи для бота Secretary Mode.
2. Человек подключает бота в разделе Настройки › Автоматизация чатов и выбирает… Человек подключает бота в разделе Настройки › Автоматизация чатов и выбирает ему чаты: например, все, кроме контактов, или только новые.
3. Бот получает обновление `business_connection`: `id`, `user`, `user_chat_id`,… Бот получает обновление `business_connection`: `id`, `user`, `user_chat_id`, `rights` и `is_enabled`. Ориентируйся на последние `rights`.
4. Обрабатывай `business_message`, `edited_business_message` и… Обрабатывай `business_message`, `edited_business_message` и `deleted_business_messages`: в каждом есть `business_connection_id`.
5. Отвечай через `sendMessage` или другие методы отправки, добавляя этот `business_connection_id`.
6. При нужном праве доступны `readBusinessMessage`, `deleteBusinessMessages`,… При нужном праве доступны `readBusinessMessage`, `deleteBusinessMessages`, `setBusinessAccountBio`, `transferBusinessAccountStars`, `postStory` и другие методы.
7. В каждом управляемом чате у владельца есть кнопка Manage Bot: она открывает… В каждом управляемом чате у владельца есть кнопка Manage Bot: она открывает твоего бота с `/start bizChat<user_chat_id>`.

Осторожно

• `can_reply` работает только в личных чатах, где за последние 24 часа были входящие сообщения; `readBusinessMessage` тоже требует чат, активный за эти 24 часа.
• Сообщения, отправленные не ботом и без инлайн-клавиатуры, можно редактировать только 48 часов.
• `deleteBusinessMessages` принимает 1–100 сообщений из одного чата, `transferBusinessAccountStars` переводит боту 1–10 000 звёзд.
• Раздел 5.4 условий для разработчиков: честно опиши, что делает бот и какие данные хранит, ничего не скрывай от владельца и не передавай содержимое сообщений третьим лицам, в том числе сторонним API, без разрешения пользователя. За нарушение могут навсегда заблокировать и бота, и твой аккаунт.

С Gem

Gem не подключается к бизнес-аккаунтам. Рядом другое: в проекте на Gem бота @gembot держит Gem, и он отвечает в твоих группах, обрабатывает заявки на вступление, публикует посты в каналах и принимает звёзды за предложения.

Источники

• https://core.telegram.org/bots/features#business-bots
• https://core.telegram.org/bots/api#businessconnection
• https://telegram.org/blog/ai-bot-revolution-11-new-features/ru
• https://telegram.org/tos/bot-developers

Открыть в Telegram ↗