Bot API 7.4: Stars, effects, etc

[coder2020official]

May 28, 2024
Bot API 7.4

• Added support for payments in Telegram Stars by introducing the new currency “XTR”.
• The parameter provider_token of the methods sendInvoice and createInvoiceLink must be omitted for payments in Telegram Stars.
• The field provider_token in the class InputInvoiceMessageContent must be omitted for payments in Telegram Stars.
• Added the method refundStarPayment.
• Added the field effect_id to the class Message.
• Added the parameter message_effect_id to the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, and sendMediaGroup.
• Added the field show_caption_above_media to the classes Message, InputMediaAnimation, InputMediaPhoto, InputMediaVideo, InlineQueryResultGif, InlineQueryResultMpeg4Gif, InlineQueryResultPhoto, InlineQueryResultVideo, InlineQueryResultCachedGif, InlineQueryResultCachedMpeg4Gif, InlineQueryResultCachedPhoto, and InlineQueryResultCachedVideo.
• Added the parameter show_caption_above_media to the methods sendAnimation, sendPhoto, sendVideo, copyMessage, and editMessageCaption.
• Added support for “expandable_blockquote” entities in received messages.
• Added support for “expandable_blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.
• Allowed to explicitly specify “expandable_blockquote” entities in formatted texts.

[coder2020official]

@Badiboy need your opinion on 2 unchecked points, which are related to provider_token
it is made optional only for Telegram Stars; We have to maintain backward compatibility without changing position of parameter. What do you suggest?
I am not sure on whether they accept empty string too. I asked a question from the dev. If so - we could ask users to pass an empty string to use Stars

[coder2020official]

I am sort of done on the rest, though not sure on how correct my implementation was; I might have hurried at some points

[Badiboy]

Got it, will take a look.

[coder2020official]

Dev said passing empty string for provider_token is fine

[Badiboy]

Dev said passing empty string for provider_token is fine

It is obviously mentioned in announcement )

[coder2020official]

I mean, it says omitted, which would mean not passing provider_token
Dev said we can still pass empty string for provider_token

[Badiboy]

it says omitted,

It says LEFT EMPTY. Not ommited.

[coder2020official]

[Badiboy]

Lol, we read different sources )

[Badiboy]

@coder2020official , could you please clarify, why you used post here?

[Badiboy]

it is made optional only for Telegram Stars; We have to maintain backward compatibility without changing position of parameter. What do you suggest?

I propose to allow users to pass NONE to this parameter (obviously) and add check
if "provider_token" is not None:
in helper.
This will allow to ommit this parameter in request and keep possibility to send empty string if needed.

[Badiboy]

if self.show_caption_above_media:
to
if self.show_caption_above_media is not None:

Here and everywhere.

[Badiboy]

Except "post" question and left comment LGTM.

[coder2020official]

If we make provider_token optional, backward compatibility will be gone

[Badiboy]

If we make provider_token optional, backward compatibility will be gone

I said nothing about "make optional". I said "allow to pass NONE" :)

[coder2020official]

So I just change API helper as you said? And adjust the provider_token to Union[str, None]?

[Badiboy]

So I just change API helper as you said? And adjust the provider_token to Union[str, None]?

Yep, I don't see other ways.

[coder2020official]

@Badiboy I think I'm done

[Badiboy]

@coder2020official Release?

[coder2020official]

No, there is one issue that needs to be closed before that;