28 августа 2026

• +readBusinessMessage — отметить сообщение прочитанным от имени аккаунта: chat_id с message_id, право can_read_messages.
• +deleteBusinessMessages — удалить сообщения в чате аккаунта, до 100 за вызов, включая те, что бот не отправлял.
• +setBusinessAccountName — имя и фамилия, оба поля до 64 символов.
• +setBusinessAccountBio — описание до 140 символов, без поля очищается.
• +setBusinessAccountUsername — юзернейм до 32 символов, без поля снимается и уходит в свободные.

Каждый метод проверяет своё право подключения, а все выданные боту права разом отдаёт getBusinessConnection. Отдельного метода для ответа в чат не нужно: business_connection_id принимают обычные методы отправки, для них требуется can_reply.

• ~Изменяющие методы бизнес-подключения можно вызывать повторно. Раньше второй вызов по тому же аккаунту отвечал 500 с текстом «gift operation failed».
• ~Заметнее всего на setBusinessAccountGiftSettings: вернуть настройки к прежним значениям было нельзя, потому что именно такое сочетание уже применялось.
• ~Защита от двойного выполнения осталась: повтор с тем же idempotency_key по-прежнему не делает работу дважды.

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

• ~Параметры из адреса запроса читают все методы. Раньше их подставляли поштучно, и там, где этого не сделали, строка запроса не доходила.
• ~Затронуло getBusinessAccountGifts, getBusinessAccountStarBalance и все методы подарков этого дня: GET отвечал «business_connection_id is required», хотя параметр был в адресе.
• ~Если параметр есть и в адресе, и в теле, берётся значение из тела.

Заметно только на GET: библиотеки почти всегда отправляют POST, а GET со строкой запроса удобен, когда метод дёргают руками из консоли.

• +getUserGifts, getChatGifts, getBusinessAccountGifts — подарки пользователя, канала и подключённого аккаунта.
• +getBusinessAccountStarBalance — баланс звёзд подключённого аккаунта.
• +convertGiftToStars, upgradeGift, transferGift — продажа за звёзды, улучшение до уникального, передача пользователю или каналу.
• +setBusinessAccountGiftSettings — какие подарки аккаунт принимает и показывать ли кнопку подарка.
• +transferBusinessAccountStars — вывести звёзды аккаунта владельцу бота.
• +giftPremiumSubscription — подарить Premium на 1, 3, 6 или 12 месяцев за 2500, 7000, 13000 или 25000 звёзд.

Каждый метод проверяет право, которое человек выдал боту в настройках подключения; права на продажу, передачу, настройки и вывод звёзд включаются по отдельности. Своего кошелька у бота нет: Premium и вывод идут через баланс владельца бота, улучшение и продажа — через баланс подключённого аккаунта.