BusinessConnection

business_connection — это специальный объект, который появляется в обновлениях (Update) вашего бота. Он сигнализирует об изменении статуса подключения бота к бизнес-аккаунту пользователя в Telegram.

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

Когда бот получает обновление business_connection

Согласно документации, объект business_connection присылается боту в трех основных случаях:

Бот был подключен к бизнес-аккаунту.

Бот был отключен от бизнес-аккаунта.

Пользователь отредактировал существующее подключение бота к своему бизнес-аккаунту (например, изменил права или настройки).

{
  "business_connection": {
    "can_reply": true,
    "date": 1772021056,
    "id": "string",
    "is_enabled": true,
    "rights": {
      10
      items
    },
    "user": {
      7
      items
    },
    "user_chat_id": 123456789
  },
  "update_id": 565656244
}

Как это работает в контексте API

Когда пользователь подключает вашего бота к своему бизнес-аккаунту (через специальный интерфейс в настройках Telegram), Telegram сервер начинает отправлять вашему боту обновления с полем business_connection.

{
  "business_message": {
    "business_connection_id": "string",
    "chat": { 4 items },
    "date": 1772021299,
    "from": { 5 items },
    "message_id": 790157,
    "text": "текст"
  },
  "update_id": 565656245
}

Это позволяет боту понять, какому именно бизнес-аккаунту и с какими правами он теперь принадлежит. После этого бот может, например, начать обрабатывать входящие сообщения из этого бизнес-аккаунта (объекты business_message), используя контекст подключения.

Ключевые выводы для разработчика

Это событие, а не сущность для прямых запросов. Вы не можете "запросить" подключение, вы можете только отреагировать на факт его изменения.

Оно открывает сценарии для создания бизнес-решений: боты могут выступать в роли ассистентов, систем обработки заказов или CRM прямо в интерфейсе бизнес-аккаунта пользователя.

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

Если вы планируете разрабатывать бота для бизнес-аккаунтов, вам потребуется глубокое понимание полей объекта BusinessConnection (которые можно найти в полной спецификации API) и методов работы с business_message. Я могу помочь найти более детальную информацию о структуре этого объекта, если она вам нужна.