Документация Telegram ботов полностью переработана

Официальный канал новостей мессенджера объявил о завершении создания документации для разработчиков ботов.

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

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

#BotAPI

Bot API был обновлён до версии 6.3

Что нового:
— Добавлена поддержка тем в группах.
— Добавлены поля is_forum и is_topic_message в Chat и Message соответственно.
— Добавлена возможность отправлять сообщения в тему через новый параметр message_thread_id.
— Добавлены служебные сообщения о новых, закрытых и заново открытых темах, каждое из которых имеет дополнительное поле в Message.
— Добавлена возможность создавать, закрывать, редактировать и удалять темы.
— Добавлены разрешения членам чата на управление темами, см. can_manage_topics как поле во всех соответствующих классах и как параметр в promoteChatMember.

Коллекционные публичные имена и статус Emoji
— Коллекционные публичные имена отображаются в поле active_usernames в классе Chat.
— Пользовательские статусы теперь отображаются в поле emoji_status_custom_emoji_id, возвращаемом из getChat.

Полный список изменений — на официальном сайте.

Вы можете тестировать совместимость своих ботов с темами в специальной ветке чата @infotopic.

#обновление #BotAPI

Bot API был обновлён до версии 6.4

Форумы
• Теперь боты могут открывать, закрывать, редактировать и переключать видимость Основной темы.
• Добавлена поддержка новых сервисных сообщений, таких как ForumTopicEdited, GeneralForumTopicHidden и другие.
• Метод sendChatAction теперь может отправлять действия в любую тему или поток сообщений с помощью параметра message_thread_id.

Спойлеры
• Добавлено обнаружение спойлеров с помощью нового поля has_media_spoiler в классе Message.
• Теперь боты могут отправлять медиа-контент со спойлерами с помощью поля has_spoiler в sendPhoto, sendVideo и sendAnimation.

Веб-боты
• Добавлен встроенный сканер QR-кода, управляемый с помощью showScanQrPopup и closeScanQrPopup.
• Теперь веб-боты, запущенные из меню вложений, могут запрашивать текст из буфера обмена с помощью readTextFromClipboard.
• Добавлено поле platform, показывающее, на какой платформе используется веб-бот.

Общее
• Добавлено поле is_persistent, чтобы сохранять ReplyKeyboard открытым по умолчанию.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API был обновлён до версии 6.5

Что нового:
• В тип KeyboardButton добавлен класс KeyboardButtonRequestUser и поле request_user.
• Добавлены запросы к пользователю и чатам и поддержка подробных разрешений медиа.
• Добавлен тип KeyboardButtonRequestChat и поле request_chat к классу KeyboardButton.
• Добавлены типы UserShared, ChatShared и поля user_shared и chat_shared к классу Message.
• Заменены поля can_send_media_messages в классах ChatMemberRestricted и ChatPermissions на отдельные поля can_send_audios, can_send_documents, can_send_photos, can_send_videos, can_send_video_notes и can_send_voice_notes для различных типов медиа.
• Добавлен параметр use_independent_chat_permissions в методы restrictChatMember и setChatPermissions.
• Добавлено поле user_chat_id в класс ChatJoinRequest.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API был обновлён до версии 6.6

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

Локализованные описания
• Теперь боты поддерживают локализованные описания, которые отображаются в зависимости от языка пользователя.
• Добавлены методы setMyDescription, и setMyShortDescription для установки локализованного описания и краткого описания бота.
• Добавлены методы getMyDescription и getMyShortDescription, чтобы получить описание или краткое описание бота на определенном языке.

Стикеры и эмодзи
• Теперь боты могут создавать наборы стикеров с пользовательскими эмодзи с помощью метода createNewStickerSet.
• Добавлена поддержка адаптивных цветов пользовательских эмодзи через параметр needs_repainting в методе createNewStickerSet.
• Добавлена возможность указать ключевые слова для поиска стикеров, добавленных в наборы стикеров.
• Улучшены опции редактирования наборов стикеров, включая изменение названия, удаление пака, редактирование списков эмодзи и многое другое.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Telegram ограничил возможности ботов

6 ноября 2021 года в Bot API появились изменения, в результате которых боты научились одобрять или отклонять заявки на вступление в группы и каналы. К сожалению, одновременно с этим они также научились и начинать диалоги с пользователями.

В начале апреля 2023 года администрация Telegram изменила Bot API, ограничив возможности ботов.

Подробнее о этих изменениях мы рассказываем в статье https://tginfo.me/bots-are-limited/.

#BotAPI

Bot API был обновлён до версии 6.7

Из важного:
• Теперь веб-приложение можно открыть через ссылку, inline-кнопку или inline-режим, причём не только в личных сообщениях, но и в группах. Это изменение позволяет всем разработчикам создавать веб-ботов для групповых чатов. Раньше эта возможность была доступна только тем ботам, владельцы которых заплатили за интеграцию в меню «Прикрепить». Впрочем, добавить ботов в меню «Прикрепить» до сих пор можно только платно.
• В BotFather появились команды для создания ссылок на открытие веб-ботов, в них можно передавать и дополнительные URL-параметры. Пример ссылки: t.iss.one/fStikBot/catalog

Другие нововведения:
• Добавлена возможность задать разные имена ботов для разных языков пользователя, используя метод setMyName.
• Добавлена возможность получить текущее имя бота на указанном языке как объект класса BotName, используя метод getMyName.
• Добавлена возможность изменять настройки бота из его профиля в официальных приложениях Telegram, включая возможность установки анимированных аватаров.
• Добавлена поддержка кастомных эмодзи. Отправлять такие эмодзи могут только боты с привязанным коллекционным именем.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API был обновлён до версии 6.8

Что нового:
• В класс Message добавлено поле story, предназначенное для сообщений с пересылаемыми историями. В настоящее время оно не содержит никакой информации.
• В класс PollAnswer добавлено поле voter_chat, предназначенное для указания на проголосовавших в чате, привязанном к каналу, в Polls. Для обратной совместимости поле user в таких объектах будет содержать пользователя 136817688 (@Channel_Bot).
• В класс Chat добавлено поле emoji_status_expiration_date.
• Добавлен метод unpinAllGeneralForumTopicMessages.
• Увеличена до 512 символов максимальная длина параметра startapp в прямых ссылках на Web App.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API был обновлён до версии 6.9

Что нового:
• В классы ChatMemberAdministrator и ChatAdministratorRights добавлены новые права администратора can_post_stories, can_edit_stories и can_delete_stories.
• В метод promoteChatMember добавлены параметры can_post_stories, can_edit_stories и can_delete_stories. В настоящее время боты не имеют возможности использовать эти права, кроме как присваивать их другим администраторам.
• Добавлена возможность установки любого цвета хэдера для Веб-бота с помощью метода setHeaderColor.
• В класс WebApp добавлено поле CloudStorage и методы requestWriteAccess, requestContact.
• Добавлены WebApp-события writeAccessRequested, contactRequested.
• В класс WriteAccessAllowed добавлены поля from_request и from_attachment_menu.
• В класс WebAppUser добавлены поля added_to_attachment_menu, allows_write_to_pm.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API был обновлён до версии 7.0

Реакции
• Добавлена поддержка реакций для ботов.
• Добавлен метод setMessageReaction, позволяющий ботам реагировать на сообщения.
• Реакции на сообщения теперь могут отслеживаться ботами.
• Добавлено поле available_reactions в класс Chat.

Ответы 2.0
• Боты теперь могут отвечать на сообщения в других чатах или темах.
• Добавлен класс ExternalReplyInfo для отслеживания ответов в различных чатах.
• Новый класс ReplyParameters заменяет собой отдельные параметры ответа во всех соответствующих методах и позволяет ботам цитировать части любого сообщения.
• Новое поле quote класса Message позволяет ботам определять поступающий цитируемый текст.

Настройки предпросмотра ссылки
• Теперь боты могут устанавливать пользовательский URL для создания предварительного просмотра ссылок в исходящих сообщениях.
• Добавлена поддержка кастомного размера и положения блоков предварительного просмотра ссылок.
• Добавлен класс LinkPreviewOptions для поддержки новых настроек.

Массовые действия
• Боты теперь могут удалять несколько сообщений в одном запросе с помощью deleteMessages.
• Боты теперь могут пересылать или копировать несколько сообщений в одном запросе с помощью соответствующих методов forwardMessages и copyMessages.

Голоса и розыгрыши Premium-подписок
• Добавлена поддержка сообщений о розыгрышах, позволяющая ботам определять их создание и завершение.
• Теперь боты могут отслеживать изменение количества голосов в канале с помощью новых классов ChatBoostUpdated и ChatBoostRemoved.
• Теперь боты могут узнать, был ли получен голос с Premium-подписки, подарочного кода или розыгрыша, а также проверять все активные голоса от пользователей с помощью getUserChatBoosts.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API обновился до версии 7.1

Кастомные эмодзи
• Теперь боты могут получать установленный в группе набор эмодзи и использовать кастомные эмодзи из этого пака.

Бусты
• Добавлена поддержка служебных сообщений boost_added о новых бустах, отданных чату.
• В класс Message добавлено поле sender_boost_count, подсчитывающее отданные отправителем бусты, активные на дату отправки сообщения.

Истории
• Теперь боты могут проверять, есть ли у администраторов права публиковать, редактировать и удалять истории в супергруппах.
• Добавлено поле reply_to_story в класс Message.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Биометрия в мини-приложениях

В исходном коде инструментов Telegram Mini Apps была обнаружена функция BiometricManager.

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

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

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

UPD. Мы переписали пост полностью, чтобы лучше подчеркнуть то, что ни приложения, ни Telegram не получают доступа к биометрическим данным.

#BotAPI

Bot API обновился до версии 7.2

Интеграция с бизнес-аккаунтами:
• Добавлен класс BusinessConnection и обновления о подключении или отключении бота к бизнес-аккаунту, представленные полем business_connection в обновлении класса.
• Добавлены обновления об удалении сообщений в бизнес-аккаунте, подключенном к боту.

Работа от имени бизнес-аккаунтов:
• Добавлено поле business_connection_id в класс Message.
• Добавлено поле sender_business_bot в класс Message.
• Добавлен параметр business_connection_id к методу sendChatAction.

Информация о бизнес-аккаунтах:
• Добавлены классы BusinessOpeningHours и BusinessOpeningHoursInterval.
• Добавлено поле business_opening_hours в класс Chat.

Наборы cтикеров с микс-форматом:
• Удалены поля is_animated и is_video из класса StickerSet.
• Добавлено поле format в класс InputSticker.
• Удален параметр sticker_format из метода createNewStickerSet.
• Увеличено максимальное количество стикеров в любом наборе до 120.
• Разрешено загружать стикеры в формате WEBM с помощью SendSticker.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API обновился до версии 7.5

Звёзды Телеграм:
• Боты могут использовать метод getStarTransactions для получения данных о транзакциях и выводе звёзд.

Телеграм для бизнеса:
• Сообщения, отправленные от имени бизнес-аккаунтов, теперь поддерживают inline callback кнопки.
• Добавлена поддержка редактирования сообщений бизнес-аккаунтов.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API обновился до версии 7.6

Платные посты
• Добавлены классы PaidMedia, PaidMediaInfo, PaidMediaPreview, PaidMediaPhoto и PaidMediaVideo, содержащие информацию о платных медиа.
• Добавлены метод sendPaidMedia и классы InputPaidMedia, InputPaidMediaPhoto и InputPaidMediaVideo для отправки платных медиа.

Мини-приложения
• Изменен режим открытия по умолчанию для мини-приложений по прямой ссылке.
• Добавлена поддержка запуска веб-приложений по ссылке t.iss.one в классе MenuButtonWebApp.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API обновился до версии 7.8

• Представлены main Mini App, которые можно просмотреть и запустить по ссылке или из профиля бота.
• Мини-приложения теперь могут передавать медиафайлы в редактор историй.
• Добавлена ​​поддержка управления закрепленными сообщениями от имени бизнес-аккаунтов.

• Полный список изменений — на официальном сайте.

#обновление #botAPI

Bot API обновился до версии 7.9

• Реализована подписка на канал за звезды ⭐️ — теперь боты могут управлять платными пригласительными ссылками.
• Боты теперь могут отправлять платные медиафайлы в любые чаты, в том числе от имени бизнес-аккаунтов.
• Добавлена поддержка "Суперканалов", в которых администраторы могут публиковать сообщения от имени своего профиля или от имени других своих каналов.

Полный список изменений — на официальном сайте.

#обновление #BotAPI

Bot API обновился до версии 7.10

• Добавлена поддержка событий покупки платных медиа.
• Боты теперь могут прикреплять к платным медиа метаданные, которые бот может прочесть из истории транзакций и событий покупки.
• В объекте розыгрыша появилось поле, которое описывает тип розыгрыша и количество разыгрываемых звёзд.
• Добавлены объекты, поля и события для отображения второстепенной кнопки действия в мини-приложениях.

Полный список изменений — на официальном сайте.

#обновление #BotAPI