Telegram Bot API 10.0

AGENTS.md

@@ -0,0 +1,5 @@
+# Agent Guidelines
+
+## Writing Tests
+
+- For `InputFile|string` parameters, the string must be a file ID, not a URL.

CHANGELOG.md

@@ -1,5 +1,34 @@
 # Telegram Bot API for PHP Change Log
 
+## 0.21 May 9, 2026
+
+- New #199: Add `supportsGuestQueries` field to `User` type.
+- New #199: Add `guestQueryId`, `guestBotCallerUser` and `guestBotCallerChat` fields to `Message` type.
+- New #199: Add `guestMessage` field to `Update` type.
+- New #199: Add `SentGuestMessage` type.
+- New #199: Add `AnswerGuestQuery` method.
+- New #199: Add `canReactToMessages` field to `ChatMemberRestricted` and `ChatPermissions` types.
+- New #199: Add `returnBots` parameter to `GetChatAdministrators` method.
+- New #199: Add `DeleteAllMessageReactions` method.
+- New #199: Add `DeleteMessageReaction` method.
+- New #199: Add `InputMediaSticker`, `InputMediaVenue`, `InputMediaLocation` and `InputMediaLivePhoto` types.
+- New #199: Add `PollMedia` and `LivePhoto` type.
+- New #199: Add `explanationMedia`, `media`, `membersOnly` and `countryCodes` fields to `Poll` type.
+- New #199: Add `media` field to `PollOption` type.
+- New #199: Add `InputPollMedia` and `InputPollOptionMedia` types.
+- New #199: Add `live_photo` field to `Message` and `ExternalReplyInfo` types.
+- New #199: Add `SendLivePhoto` method.
+- New #199: Add `PaidMediaLivePhoto` type.
+- New #199: Add `InputPaidMediaLivePhoto` type.
+- New #199: Add `explanationMedia`, `media`, `membersOnly` and `countryCodes` parameters to `SendPoll` method.
+- New #199: Add `media` field to `InputPollOption` type.
+- Enh #199: `SendMediaGroup` method now supports `InputMediaLivePhoto` type.
+- New #199: Add `BotAccessSettings` type.
+- New #199: Add `GetManagedBotAccessSettings` method.
+- New #199: Add `SetManagedBotAccessSettings` method.
+- New #199: Add `GetUserPersonalChatMessages` method.
+- Chg #199: `text` parameter in `SendMessageDraft` method is now optional.
+
 ## 0.20 April 26, 2026
 
 - Chg #197: `$data` parameter type in `TransportInterface::postWithFiles()` changed from `array<string, scalar>`

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.6 (April 3, 2026) is **fully supported**.
+✔️ Telegram Bot API 10.0 (May 8, 2026) is **fully supported**.
 
 ♻️ **Zero dependencies** — no third-party libraries, only native PHP.
 

src/Method/DeleteAllMessageReactions.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method;
+
+use Phptg\BotApi\ParseResult\ValueProcessor\TrueValue;
+use Phptg\BotApi\Transport\HttpMethod;
+use Phptg\BotApi\MethodInterface;
+
+/**
+ * @see https://core.telegram.org/bots/api#deleteallmessagereactions
+ *
+ * @template-implements MethodInterface<true>
+ */
+final readonly class DeleteAllMessageReactions implements MethodInterface
+{
+    public function __construct(
+        private int|string $chatId,
+        private ?int $userId = null,
+        private ?int $actorChatId = null,
+    ) {}
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::POST;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'deleteAllMessageReactions';
+    }
+
+    public function getData(): array
+    {
+        return array_filter(
+            [
+                'chat_id' => $this->chatId,
+                'user_id' => $this->userId,
+                'actor_chat_id' => $this->actorChatId,
+            ],
+            static fn(mixed $value): bool => $value !== null,
+        );
+    }
+
+    public function getResultType(): TrueValue
+    {
+        return new TrueValue();
+    }
+}

src/Method/DeleteMessageReaction.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method;
+
+use Phptg\BotApi\ParseResult\ValueProcessor\TrueValue;
+use Phptg\BotApi\Transport\HttpMethod;
+use Phptg\BotApi\MethodInterface;
+
+/**
+ * @see https://core.telegram.org/bots/api#deletemessagereaction
+ *
+ * @template-implements MethodInterface<true>
+ */
+final readonly class DeleteMessageReaction implements MethodInterface
+{
+    public function __construct(
+        private int|string $chatId,
+        private int $messageId,
+        private ?int $userId = null,
+        private ?int $actorChatId = null,
+    ) {}
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::POST;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'deleteMessageReaction';
+    }
+
+    public function getData(): array
+    {
+        return array_filter(
+            [
+                'chat_id' => $this->chatId,
+                'message_id' => $this->messageId,
+                'user_id' => $this->userId,
+                'actor_chat_id' => $this->actorChatId,
+            ],
+            static fn(mixed $value): bool => $value !== null,
+        );
+    }
+
+    public function getResultType(): TrueValue
+    {
+        return new TrueValue();
+    }
+}

src/Method/GetChatAdministrators.php

@@ -19,6 +19,7 @@
 {
     public function __construct(
         private int|string $chatId,
+        private ?bool $returnBots = null,
     ) {}
 
     public function getHttpMethod(): HttpMethod
@@ -33,7 +34,13 @@ public function getApiMethod(): string
 
     public function getData(): array
     {
-        return ['chat_id' => $this->chatId];
+        return array_filter(
+            [
+                'chat_id' => $this->chatId,
+                'return_bots' => $this->returnBots,
+            ],
+            static fn(mixed $value): bool => $value !== null,
+        );
     }
 
     public function getResultType(): ArrayMap

src/Method/GetManagedBotAccessSettings.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method;
+
+use Phptg\BotApi\ParseResult\ValueProcessor\ObjectValue;
+use Phptg\BotApi\Transport\HttpMethod;
+use Phptg\BotApi\MethodInterface;
+use Phptg\BotApi\Type\BotAccessSettings;
+
+/**
+ * @see https://core.telegram.org/bots/api#getmanagedbotaccesssettings
+ *
+ * @template-implements MethodInterface<BotAccessSettings>
+ */
+final readonly class GetManagedBotAccessSettings implements MethodInterface
+{
+    public function __construct(
+        private int $userId,
+    ) {}
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::GET;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'getManagedBotAccessSettings';
+    }
+
+    public function getData(): array
+    {
+        return ['user_id' => $this->userId];
+    }
+
+    public function getResultType(): ObjectValue
+    {
+        return new ObjectValue(BotAccessSettings::class);
+    }
+}

src/Method/GetUserPersonalChatMessages.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method;
+
+use Phptg\BotApi\ParseResult\ValueProcessor\ArrayOfObjectsValue;
+use Phptg\BotApi\Transport\HttpMethod;
+use Phptg\BotApi\MethodInterface;
+use Phptg\BotApi\Type\Message;
+
+/**
+ * @see https://core.telegram.org/bots/api#getuserpersonalchatmessages
+ *
+ * @template-implements MethodInterface<array<Message>>
+ */
+final readonly class GetUserPersonalChatMessages implements MethodInterface
+{
+    public function __construct(
+        private int $userId,
+        private int $limit,
+    ) {}
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::GET;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'getUserPersonalChatMessages';
+    }
+
+    public function getData(): array
+    {
+        return [
+            'user_id' => $this->userId,
+            'limit' => $this->limit,
+        ];
+    }
+
+    public function getResultType(): ArrayOfObjectsValue
+    {
+        return new ArrayOfObjectsValue(Message::class);
+    }
+}

src/Method/Inline/AnswerGuestQuery.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phptg\BotApi\Method\Inline;
+
+use Phptg\BotApi\ParseResult\ValueProcessor\ObjectValue;
+use Phptg\BotApi\Transport\HttpMethod;
+use Phptg\BotApi\MethodInterface;
+use Phptg\BotApi\Type\Inline\InlineQueryResult;
+use Phptg\BotApi\Type\SentGuestMessage;
+
+/**
+ * @see https://core.telegram.org/bots/api#answerguestquery
+ *
+ * @template-implements MethodInterface<SentGuestMessage>
+ */
+final readonly class AnswerGuestQuery implements MethodInterface
+{
+    public function __construct(
+        private string $guestQueryId,
+        private InlineQueryResult $result,
+    ) {}
+
+    public function getHttpMethod(): HttpMethod
+    {
+        return HttpMethod::POST;
+    }
+
+    public function getApiMethod(): string
+    {
+        return 'answerGuestQuery';
+    }
+
+    public function getData(): array
+    {
+        return [
+            'guest_query_id' => $this->guestQueryId,
+            'result' => $this->result->toRequestArray(),
+        ];
+    }
+
+    public function getResultType(): ObjectValue
+    {
+        return new ObjectValue(SentGuestMessage::class);
+    }
+}