bot api update

Author: watzon

src/tourmaline/client/api.cr

@@ -20,7 +20,7 @@ module Tourmaline
         })
       end
 
-      # 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.
       # If you'd like to make sure that the webhook was set by you, you can specify secret data in the parameter secret_token. If specified, the request will contain a header "X-Telegram-Bot-Api-Secret-Token" with the secret token as content.
       def set_webhook(
         url : String,
@@ -165,6 +165,7 @@ module Tourmaline
         caption : String | ::Nil = nil,
         parse_mode : ParseMode = default_parse_mode,
         caption_entities : Array(Tourmaline::MessageEntity) | ::Nil = nil,
+        show_caption_above_media : Bool | ::Nil = nil,
         disable_notification : Bool | ::Nil = nil,
         protect_content : Bool | ::Nil = nil,
         allow_paid_broadcast : Bool | ::Nil = nil,
@@ -354,6 +355,8 @@ module Tourmaline
         width : Int32 | Int64 | ::Nil = nil,
         height : Int32 | Int64 | ::Nil = nil,
         thumbnail : ::File | String | ::Nil = nil,
+        cover : ::File | String | ::Nil = nil,
+        start_timestamp : Int32 | Int64 | ::Nil = nil,
         caption : String | ::Nil = nil,
         parse_mode : ParseMode = default_parse_mode,
         caption_entities : Array(Tourmaline::MessageEntity) | ::Nil = nil,
@@ -765,6 +768,29 @@ module Tourmaline
         })
       end
 
+      # Use this method to send a checklist on behalf of a connected business account. On success, the sent Message is returned.
+      def send_checklist(
+        business_connection_id : String,
+        chat_id : Int32 | Int64,
+        checklist : Tourmaline::InputChecklist,
+        disable_notification : Bool | ::Nil = nil,
+        protect_content : Bool | ::Nil = nil,
+        message_effect_id : String | ::Nil = nil,
+        reply_parameters : Tourmaline::ReplyParameters | ::Nil = nil,
+        reply_markup : Tourmaline::InlineKeyboardMarkup | ::Nil = nil
+      )
+        request(Tourmaline::Message, "sendChecklist", {
+          business_connection_id: business_connection_id,
+          chat_id:                chat_id,
+          checklist:              checklist.to_json,
+          disable_notification:   disable_notification,
+          protect_content:        protect_content,
+          message_effect_id:      message_effect_id,
+          reply_parameters:       reply_parameters.try(&.to_json),
+          reply_markup:           reply_markup.try(&.to_json),
+        })
+      end
+
       # Use this method to send an animated emoji that will display a random value. On success, the sent Message is returned.
       def send_dice(
         chat_id : Int32 | Int64 | String,
@@ -812,7 +838,7 @@ module Tourmaline
         })
       end
 
-      # Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Returns True on success.
+      # Use this method to change the chosen reactions on a message. Service messages of some types can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
       def set_message_reaction(
         chat_id : Int32 | Int64 | String,
         message_id : Int32 | Int64,
@@ -840,6 +866,19 @@ module Tourmaline
         })
       end
 
+      # Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess. Returns True on success.
+      def set_user_emoji_status(
+        user_id : Int32 | Int64,
+        emoji_status_custom_emoji_id : String | ::Nil = nil,
+        emoji_status_expiration_date : Int32 | Int64 | ::Nil = nil
+      )
+        request(Bool, "setUserEmojiStatus", {
+          user_id:                      user_id,
+          emoji_status_custom_emoji_id: emoji_status_custom_emoji_id,
+          emoji_status_expiration_date: emoji_status_expiration_date,
+        })
+      end
+
       # Use this method to get basic information about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>, where <file_path> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling getFile again.
       # Note: This function may not preserve the original file name and MIME type. You should save the file's MIME type and name (if available) when the File object is received.
       def get_file(
@@ -2332,6 +2371,25 @@ module Tourmaline
         })
       end
 
+      # Stores a message that can be sent by a user of a Mini App. Returns a PreparedInlineMessage object.
+      def save_prepared_inline_message(
+        user_id : Int32 | Int64,
+        result : Tourmaline::InlineQueryResult,
+        allow_user_chats : Bool | ::Nil = nil,
+        allow_bot_chats : Bool | ::Nil = nil,
+        allow_group_chats : Bool | ::Nil = nil,
+        allow_channel_chats : Bool | ::Nil = nil
+      )
+        request(Tourmaline::PreparedInlineMessage, "savePreparedInlineMessage", {
+          user_id:             user_id,
+          result:              result.to_json,
+          allow_user_chats:    allow_user_chats,
+          allow_bot_chats:     allow_bot_chats,
+          allow_group_chats:   allow_group_chats,
+          allow_channel_chats: allow_channel_chats,
+        })
+      end
+
       # Use this method to send invoices. On success, the sent Message is returned.
       def send_invoice(
         chat_id : Int32 | Int64 | String,
@@ -2408,6 +2466,9 @@ module Tourmaline
         payload : String,
         currency : String,
         prices : Array(Tourmaline::LabeledPrice),
+        business_connection_id : String | ::Nil = nil,
+        provider_token : String | ::Nil = nil,
+        subscription_period : Int32 | Int64 | ::Nil = nil,
         max_tip_amount : Int32 | Int64 | ::Nil = nil,
         suggested_tip_amounts : Array(Int32 | Int64) | ::Nil = nil,
         provider_data : String | ::Nil = nil,
@@ -2429,6 +2490,9 @@ module Tourmaline
           payload:                       payload,
           currency:                      currency,
           prices:                        prices.to_json,
+          business_connection_id:        business_connection_id,
+          provider_token:                provider_token,
+          subscription_period:           subscription_period,
           max_tip_amount:                max_tip_amount,
           suggested_tip_amounts:         suggested_tip_amounts.try(&.to_json),
           provider_data:                 provider_data.try(&.to_json),
@@ -2474,6 +2538,46 @@ module Tourmaline
         })
       end
 
+      # A method to get the current Telegram Stars balance of the bot. Requires no parameters. On success, returns a StarAmount object.
+      def get_my_star_balance
+        request(Tourmaline::StarAmount, "getMyStarBalance")
+      end
+
+      # Returns the bot's Telegram Star transactions in chronological order. On success, returns a StarTransactions object.
+      def get_star_transactions(
+        offset : Int32 | Int64 | ::Nil = nil,
+        limit : Int32 | Int64 | ::Nil = nil
+      )
+        request(Tourmaline::StarTransactions, "getStarTransactions", {
+          offset: offset,
+          limit:  limit,
+        })
+      end
+
+      # Refunds a successful payment in Telegram Stars. Returns True on success.
+      def refund_star_payment(
+        user_id : Int32 | Int64,
+        telegram_payment_charge_id : String
+      )
+        request(Bool, "refundStarPayment", {
+          user_id:                    user_id,
+          telegram_payment_charge_id: telegram_payment_charge_id,
+        })
+      end
+
+      # Allows the bot to cancel or re-enable extension of a subscription paid in Telegram Stars. Returns True on success.
+      def edit_user_star_subscription(
+        user_id : Int32 | Int64,
+        telegram_payment_charge_id : String,
+        is_canceled : Bool
+      )
+        request(Bool, "editUserStarSubscription", {
+          user_id:                    user_id,
+          telegram_payment_charge_id: telegram_payment_charge_id,
+          is_canceled:                is_canceled,
+        })
+      end
+
       # Informs a user that some of the Telegram Passport elements they provided contains errors. The user will not be able to re-submit their Passport to you until the errors are fixed (the contents of the field for which you returned the error must change). Returns True on success.
       # Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues.
       def set_passport_data_errors(