Telegram Bot API 9.4 (#186)

Author: vjik

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Telegram Bot API for PHP Change Log
 
+## 0.14.1 February 9, 2026
+
+- New #186: Add `SetMyProfilePhoto`, `RemoveMyProfilePhoto` and `GetUserProfileAudios` methods.
+- New #186: Add `ChatOwnerLeft`, `ChatOwnerChanged`, `VideoQuality` and `UserProfileAudios` types.
+- New #186: Add `allowsUsersToCreateTopics` field to `User` type.
+- New #186: Add `iconCustomEmojiId` and `style` fields to `KeyboardButton` type.
+- New #186: Add `iconCustomEmojiId` and `style` fields to `InlineKeyboardButton` type.
+- New #186: Add `chatOwnerLeft` and `chatOwnerChanged` fields to `Message` type.
+- New #186: Add `qualities` field to `Video` type.
+- New #186: Add `firstProfileAudio` field to `ChatFullInfo` type.
+- New #186: Add `rarity` field to `UniqueGiftModel` type.
+- New #186: Add `isBurned` field to `UniqueGift` type.
+
 ## 0.14 February 7, 2026
 
 - New #182: Introduce resource readers that handle reading content from different types of resources stored in

README.md

@@ -15,7 +15,7 @@
 
 The package provides a simple and convenient way to interact with the Telegram Bot API.
 
-✔️ Telegram Bot API 9.3 (December 31, 2025) is **fully supported**.
+✔️ Telegram Bot API 9.4 (February 9, 2026) is **fully supported**.
 
 > [!IMPORTANT]
 > This project is developed and maintained by [Sergei Predvoditelev](https://github.com/vjik).

src/Method/GetUserProfileAudios.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method;
+
+use Phptg\BotApi\MethodInterface;
+use Phptg\BotApi\ParseResult\ValueProcessor\ObjectValue;
+use Phptg\BotApi\Transport\HttpMethod;
+use Phptg\BotApi\Type\UserProfileAudios;
+
+/**
+ * @see https://core.telegram.org/bots/api#getuserprofileaudios
+ *
+ * @template-implements MethodInterface<UserProfileAudios>
+ */
+final readonly class GetUserProfileAudios implements MethodInterface
+{
+    public function __construct(
+        private int $userId,
+        private ?int $offset = null,
+        private ?int $limit = null,
+    ) {}
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::GET;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'getUserProfileAudios';
+    }
+
+    public function getData(): array
+    {
+        return array_filter(
+            [
+                'user_id' => $this->userId,
+                'offset' => $this->offset,
+                'limit' => $this->limit,
+            ],
+            static fn(mixed $value): bool => $value !== null,
+        );
+    }
+
+    public function getResultType(): ObjectValue
+    {
+        return new ObjectValue(UserProfileAudios::class);
+    }
+}

src/Method/RemoveMyProfilePhoto.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method;
+
+use Phptg\BotApi\MethodInterface;
+use Phptg\BotApi\ParseResult\ValueProcessor\TrueValue;
+use Phptg\BotApi\Transport\HttpMethod;
+
+/**
+ * @see https://core.telegram.org/bots/api#removemyprofilephoto
+ *
+ * @template-implements MethodInterface<true>
+ *
+ * @api
+ */
+final readonly class RemoveMyProfilePhoto implements MethodInterface
+{
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::POST;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'removeMyProfilePhoto';
+    }
+
+    public function getData(): array
+    {
+        return [];
+    }
+
+    public function getResultType(): TrueValue
+    {
+        return new TrueValue();
+    }
+}

src/Method/SetMyProfilePhoto.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method;
+
+use Phptg\BotApi\FileCollector;
+use Phptg\BotApi\MethodInterface;
+use Phptg\BotApi\ParseResult\ValueProcessor\TrueValue;
+use Phptg\BotApi\Transport\HttpMethod;
+use Phptg\BotApi\Type\InputProfilePhoto;
+
+/**
+ * @see https://core.telegram.org/bots/api#setmyprofilephoto
+ *
+ * @template-implements MethodInterface<true>
+ *
+ * @api
+ */
+final readonly class SetMyProfilePhoto implements MethodInterface
+{
+    public function __construct(
+        private InputProfilePhoto $photo,
+    ) {}
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::POST;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'setMyProfilePhoto';
+    }
+
+    public function getData(): array
+    {
+        $fileCollector = new FileCollector();
+        $photo = $this->photo->toRequestArray($fileCollector);
+
+        return [
+            'photo' => $photo,
+            ...$fileCollector->get(),
+        ];
+    }
+
+    public function getResultType(): TrueValue
+    {
+        return new TrueValue();
+    }
+}

src/TelegramBotApi.php

@@ -61,6 +61,7 @@
 use Phptg\BotApi\Method\GetMyStarBalance;
 use Phptg\BotApi\Method\GetUserChatBoosts;
 use Phptg\BotApi\Method\GetUserGifts;
+use Phptg\BotApi\Method\GetUserProfileAudios;
 use Phptg\BotApi\Method\GetUserProfilePhotos;
 use Phptg\BotApi\Method\GiftPremiumSubscription;
 use Phptg\BotApi\Method\HideGeneralForumTopic;
@@ -82,6 +83,7 @@
 use Phptg\BotApi\Method\PromoteChatMember;
 use Phptg\BotApi\Method\RepostStory;
 use Phptg\BotApi\Method\RemoveBusinessAccountProfilePhoto;
+use Phptg\BotApi\Method\RemoveMyProfilePhoto;
 use Phptg\BotApi\Method\RemoveChatVerification;
 use Phptg\BotApi\Method\RemoveUserVerification;
 use Phptg\BotApi\Method\ReopenForumTopic;
@@ -123,6 +125,7 @@
 use Phptg\BotApi\Method\SetMyDefaultAdministratorRights;
 use Phptg\BotApi\Method\SetMyDescription;
 use Phptg\BotApi\Method\SetMyName;
+use Phptg\BotApi\Method\SetMyProfilePhoto;
 use Phptg\BotApi\Method\SetMyShortDescription;
 use Phptg\BotApi\Method\SetUserEmojiStatus;
 use Phptg\BotApi\Method\Sticker\AddStickerToSet;
@@ -236,6 +239,7 @@
 use Phptg\BotApi\Type\Update\WebhookInfo;
 use Phptg\BotApi\Type\User;
 use Phptg\BotApi\Type\UserChatBoosts;
+use Phptg\BotApi\Type\UserProfileAudios;
 use Phptg\BotApi\Type\UserProfilePhotos;
 
 use function extension_loaded;
@@ -1459,6 +1463,19 @@ public function getUserGifts(
         );
     }
 
+    /**
+     * @see https://core.telegram.org/bots/api#getuserprofileaudios
+     */
+    public function getUserProfileAudios(
+        int $userId,
+        ?int $offset = null,
+        ?int $limit = null,
+    ): FailResult|UserProfileAudios {
+        return $this->call(
+            new GetUserProfileAudios($userId, $offset, $limit),
+        );
+    }
+
     /**
      * @see https://core.telegram.org/bots/api#getuserprofilephotos
      */
@@ -1683,6 +1700,14 @@ public function removeBusinessAccountProfilePhoto(
         );
     }
 
+    /**
+     * @see https://core.telegram.org/bots/api#removemyprofilephoto
+     */
+    public function removeMyProfilePhoto(): FailResult|true
+    {
+        return $this->call(new RemoveMyProfilePhoto());
+    }
+
     /**
      * @see https://core.telegram.org/bots/api#removechatverification
      */
@@ -2956,6 +2981,14 @@ public function setMyName(?string $name = null, ?string $languageCode = null): F
         return $this->call(new SetMyName($name, $languageCode));
     }
 
+    /**
+     * @see https://core.telegram.org/bots/api#setmyprofilephoto
+     */
+    public function setMyProfilePhoto(InputProfilePhoto $photo): FailResult|true
+    {
+        return $this->call(new SetMyProfilePhoto($photo));
+    }
+
     /**
      * @see https://core.telegram.org/bots/api#setmyshortdescription
      */

src/Type/ChatFullInfo.php

@@ -73,5 +73,6 @@ public function __construct(
         public ?UserRating $rating = null,
         public ?UniqueGiftColors $uniqueGiftColors = null,
         public ?int $paidMessageStarCount = null,
+        public ?Audio $firstProfileAudio = null,
     ) {}
 }

src/Type/ChatOwnerChanged.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Type;
+
+/**
+ * @see https://core.telegram.org/bots/api#chatownerchanged
+ *
+ * @api
+ */
+final readonly class ChatOwnerChanged
+{
+    public function __construct(
+        public User $newOwner,
+    ) {}
+}

src/Type/ChatOwnerLeft.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Type;
+
+/**
+ * @see https://core.telegram.org/bots/api#chatownerleft
+ *
+ * @api
+ */
+final readonly class ChatOwnerLeft
+{
+    public function __construct(
+        public ?User $newOwner = null,
+    ) {}
+}

src/Type/InlineKeyboardButton.php

@@ -25,13 +25,17 @@ public function __construct(
         public ?CallbackGame $callbackGame = null,
         public ?bool $pay = null,
         public ?CopyTextButton $copyText = null,
+        public ?string $iconCustomEmojiId = null,
+        public ?string $style = null,
     ) {}
 
     public function toRequestArray(): array
     {
         return array_filter(
             [
                 'text' => $this->text,
+                'icon_custom_emoji_id' => $this->iconCustomEmojiId,
+                'style' => $this->style,
                 'url' => $this->url,
                 'callback_data' => $this->callbackData,
                 'web_app' => $this->webApp?->toRequestArray(),