diff --git a/src/Layers/Generated.php b/src/Layers/Generated.php index 3db1b48..1339908 100644 --- a/src/Layers/Generated.php +++ b/src/Layers/Generated.php @@ -85,7 +85,7 @@ public function getUpdates( } /** - * Use this method to specify a URL and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified URL, containing a JSON-serialized Update. In case of an unsuccessful request, we will give up after a reasonable amount of attempts. Returns True on success. + * Use this method to specify a URL and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified URL, containing a JSON-serialized Update. In case of an unsuccessful request (a request with response HTTP status code different from 2XY), we will repeat the request and give up after a reasonable amount of attempts. Returns True on success. * * @param string $url HTTPS URL to send updates to. Use an empty string to remove webhook integration * @param InputFile $certificate Upload your public key certificate so that the root certificate in use can be checked. See our self-signed guide for details. @@ -2242,8 +2242,8 @@ public function setStickerSetTitle(string $name, string $title): bool * * @param string $name Sticker set name * @param int $user_id User identifier of the sticker set owner - * @param string $format Format of the thumbnail, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, or “video” for a WEBM video - * @param InputFile|string $thumbnail A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animation-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail. + * @param string $format Format of the thumbnail, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, or “video” for a .WEBM video + * @param InputFile|string $thumbnail A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animation-requirements for animated sticker technical requirements), or a .WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail. * * @throws TelegramException */ @@ -2286,6 +2286,7 @@ public function deleteStickerSet(string $name): bool * * @param int $user_id Unique identifier of the target user that will receive the gift * @param string $gift_id Identifier of the gift + * @param bool $pay_for_upgrade Pass True to pay for the gift upgrade from the bot's balance, thereby making the upgrade free for the receiver * @param string $text Text that will be shown along with the gift; 0-255 characters * @param string $text_parse_mode Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored. * @param MessageEntity[] $text_entities A JSON-serialized list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored. @@ -2295,6 +2296,7 @@ public function deleteStickerSet(string $name): bool public function sendGift( int $user_id, string $gift_id, + ?bool $pay_for_upgrade = null, ?string $text = null, ?string $text_parse_mode = null, ?array $text_entities = null, @@ -2302,6 +2304,56 @@ public function sendGift( return $this->raw('sendGift', func_get_args()); } + /** + * Verifies a user on behalf of the organization which is represented by the bot. Returns True on success. + * + * @param int $user_id Unique identifier of the target user + * @param string $custom_description Custom description for the verification; 0-70 characters. Must be empty if the organization isn't allowed to provide a custom verification description. + * + * @throws TelegramException + */ + public function verifyUser(int $user_id, ?string $custom_description = null): bool + { + return $this->raw('verifyUser', func_get_args()); + } + + /** + * Verifies a chat on behalf of the organization which is represented by the bot. Returns True on success. + * + * @param int|string $chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername) + * @param string $custom_description Custom description for the verification; 0-70 characters. Must be empty if the organization isn't allowed to provide a custom verification description. + * + * @throws TelegramException + */ + public function verifyChat(int|string $chat_id, ?string $custom_description = null): bool + { + return $this->raw('verifyChat', func_get_args()); + } + + /** + * Removes verification from a user who is currently verified on behalf of the organization represented by the bot. Returns True on success. + * + * @param int $user_id Unique identifier of the target user + * + * @throws TelegramException + */ + public function removeUserVerification(int $user_id): bool + { + return $this->raw('removeUserVerification', func_get_args()); + } + + /** + * Removes verification from a chat that is currently verified on behalf of the organization represented by the bot. Returns True on success. + * + * @param int|string $chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername) + * + * @throws TelegramException + */ + public function removeChatVerification(int|string $chat_id): bool + { + return $this->raw('removeChatVerification', func_get_args()); + } + /** * Use this method to send answers to an inline query. On success, True is returned.No more than 50 results per query are allowed. * diff --git a/src/Telegram/BackgroundTypePattern.php b/src/Telegram/BackgroundTypePattern.php index 9c80f64..d638a07 100644 --- a/src/Telegram/BackgroundTypePattern.php +++ b/src/Telegram/BackgroundTypePattern.php @@ -7,7 +7,7 @@ namespace Telepath\Telegram; /** - * The background is a PNG or TGV (gzipped subset of SVG with MIME type “application/x-tgwallpattern”) pattern to be combined with the background fill chosen by the user. + * The background is a .PNG or .TGV (gzipped subset of SVG with MIME type “application/x-tgwallpattern”) pattern to be combined with the background fill chosen by the user. */ class BackgroundTypePattern extends BackgroundType { diff --git a/src/Telegram/Gift.php b/src/Telegram/Gift.php index 368abe4..d41cd67 100644 --- a/src/Telegram/Gift.php +++ b/src/Telegram/Gift.php @@ -22,6 +22,9 @@ class Gift extends Type /** The number of Telegram Stars that must be paid to send the sticker */ public int $star_count; + /** Optional. The number of Telegram Stars that must be paid to upgrade the gift to a unique one */ + public ?int $upgrade_star_count = null; + /** Optional. The total number of the gifts of this type that can be sent; for limited gifts only */ public ?int $total_count = null; @@ -32,6 +35,7 @@ class Gift extends Type * @param string $id Unique identifier of the gift * @param Sticker $sticker The sticker that represents the gift * @param int $star_count The number of Telegram Stars that must be paid to send the sticker + * @param int $upgrade_star_count Optional. The number of Telegram Stars that must be paid to upgrade the gift to a unique one * @param int $total_count Optional. The total number of the gifts of this type that can be sent; for limited gifts only * @param int $remaining_count Optional. The number of remaining gifts of this type that can be sent; for limited gifts only */ @@ -39,6 +43,7 @@ public static function make( string $id, Sticker $sticker, int $star_count, + ?int $upgrade_star_count = null, ?int $total_count = null, ?int $remaining_count = null, ): static { @@ -46,6 +51,7 @@ public static function make( 'id' => $id, 'sticker' => $sticker, 'star_count' => $star_count, + 'upgrade_star_count' => $upgrade_star_count, 'total_count' => $total_count, 'remaining_count' => $remaining_count, ]); diff --git a/src/Telegram/InlineQueryResultArticle.php b/src/Telegram/InlineQueryResultArticle.php index 5e8bb0f..209a07e 100644 --- a/src/Telegram/InlineQueryResultArticle.php +++ b/src/Telegram/InlineQueryResultArticle.php @@ -23,9 +23,6 @@ class InlineQueryResultArticle extends InlineQueryResult /** Optional. URL of the result */ public ?string $url = null; - /** Optional. Pass True if you don't want the URL to be shown in the message */ - public ?bool $hide_url = null; - /** Optional. Short description of the result */ public ?string $description = null; @@ -44,7 +41,6 @@ class InlineQueryResultArticle extends InlineQueryResult * @param InputMessageContent $input_message_content Content of the message to be sent * @param InlineKeyboardMarkup $reply_markup Optional. Inline keyboard attached to the message * @param string $url Optional. URL of the result - * @param bool $hide_url Optional. Pass True if you don't want the URL to be shown in the message * @param string $description Optional. Short description of the result * @param string $thumbnail_url Optional. Url of the thumbnail for the result * @param int $thumbnail_width Optional. Thumbnail width @@ -56,7 +52,6 @@ public static function make( InputMessageContent $input_message_content, ?InlineKeyboardMarkup $reply_markup = null, ?string $url = null, - ?bool $hide_url = null, ?string $description = null, ?string $thumbnail_url = null, ?int $thumbnail_width = null, @@ -68,7 +63,6 @@ public static function make( 'input_message_content' => $input_message_content, 'reply_markup' => $reply_markup, 'url' => $url, - 'hide_url' => $hide_url, 'description' => $description, 'thumbnail_url' => $thumbnail_url, 'thumbnail_width' => $thumbnail_width, diff --git a/src/Telegram/InlineQueryResultGif.php b/src/Telegram/InlineQueryResultGif.php index 21c6152..3cef206 100644 --- a/src/Telegram/InlineQueryResultGif.php +++ b/src/Telegram/InlineQueryResultGif.php @@ -14,7 +14,7 @@ class InlineQueryResultGif extends InlineQueryResult /** Type of the result, must be gif */ public string $type = 'gif'; - /** A valid URL for the GIF file. File size must not exceed 1MB */ + /** A valid URL for the GIF file */ public string $gif_url; /** URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result */ @@ -56,7 +56,7 @@ class InlineQueryResultGif extends InlineQueryResult /** * @param string $id Unique identifier for this result, 1-64 bytes - * @param string $gif_url A valid URL for the GIF file. File size must not exceed 1MB + * @param string $gif_url A valid URL for the GIF file * @param string $thumbnail_url URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result * @param int $gif_width Optional. Width of the GIF * @param int $gif_height Optional. Height of the GIF diff --git a/src/Telegram/InlineQueryResultMpeg4Gif.php b/src/Telegram/InlineQueryResultMpeg4Gif.php index 7af7483..6675574 100644 --- a/src/Telegram/InlineQueryResultMpeg4Gif.php +++ b/src/Telegram/InlineQueryResultMpeg4Gif.php @@ -14,7 +14,7 @@ class InlineQueryResultMpeg4Gif extends InlineQueryResult /** Type of the result, must be mpeg4_gif */ public string $type = 'mpeg4_gif'; - /** A valid URL for the MPEG4 file. File size must not exceed 1MB */ + /** A valid URL for the MPEG4 file */ public string $mpeg4_url; /** URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result */ @@ -56,7 +56,7 @@ class InlineQueryResultMpeg4Gif extends InlineQueryResult /** * @param string $id Unique identifier for this result, 1-64 bytes - * @param string $mpeg4_url A valid URL for the MPEG4 file. File size must not exceed 1MB + * @param string $mpeg4_url A valid URL for the MPEG4 file * @param string $thumbnail_url URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result * @param int $mpeg4_width Optional. Video width * @param int $mpeg4_height Optional. Video height diff --git a/src/Telegram/InputSticker.php b/src/Telegram/InputSticker.php index b44f8b4..543c050 100644 --- a/src/Telegram/InputSticker.php +++ b/src/Telegram/InputSticker.php @@ -17,7 +17,7 @@ class InputSticker extends Type /** The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, upload a new one using multipart/form-data, or pass “attach://” to upload a new one using multipart/form-data under name. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files » */ public InputFile|string $sticker; - /** Format of the added sticker, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, “video” for a WEBM video */ + /** Format of the added sticker, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, “video” for a .WEBM video */ public string $format; /** @@ -39,7 +39,7 @@ class InputSticker extends Type /** * @param InputFile|string $sticker The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, upload a new one using multipart/form-data, or pass “attach://” to upload a new one using multipart/form-data under name. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files » - * @param string $format Format of the added sticker, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, “video” for a WEBM video + * @param string $format Format of the added sticker, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, “video” for a .WEBM video * @param string[] $emoji_list List of 1-20 emoji associated with the sticker * @param MaskPosition $mask_position Optional. Position where the mask should be placed on faces. For “mask” stickers only. * @param string[] $keywords Optional. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For “regular” and “custom_emoji” stickers only.