send_paid_media¶

template<class Agent> api_result<message_t, Agent&&> send_paid_media(Agent &&agent, send_paid_media_args_t args)¶

template<class Agent, class F> void send_paid_media(Agent &&agent, send_paid_media_args_t args, F &&callback)¶

agent is any object satisfying agent concept.

callback is any callable object accepting expected<message_t>.

Use this method to send paid media. On success, the sent Message is returned.

struct send_paid_media_args_t¶

Arguments that should be passed to send_paid_media().

variant_t<integer_t, string_t> chat_id¶

Unique identifier for the target chat or username of the target channel (in the format @channelusername). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat’s balance. Otherwise, they will be credited to the bot’s balance.

integer_t star_count¶

The number of Telegram Stars that must be paid to buy access to the media; 1-2500

array_t<input_paid_media_t> media¶

A JSON-serialized array describing the media to be sent; up to 10 items

optional_t<string_t> payload¶

Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes.

optional_t<string_t> caption¶

Media caption, 0-1024 characters after entities parsing

optional_t<string_t> parse_mode¶

Mode for parsing entities in the media caption. See formatting options for more details.

optional_t<array_t<message_entity_t>> caption_entities¶

A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode

optional_t<boolean_t> show_caption_above_media¶

Pass True, if the caption must be shown above the message media

optional_t<boolean_t> disable_notification¶

Sends the message silently. Users will receive a notification with no sound.

optional_t<boolean_t> protect_content¶

Protects the contents of the sent message from forwarding and saving

optional_t<boolean_t> allow_paid_broadcast¶

Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot’s balance

optional_t<reply_parameters_t> reply_parameters¶

Description of the message to reply to

optional_t<variant_t<inline_keyboard_markup_t, reply_keyboard_markup_t, reply_keyboard_remove_t, force_reply_t>> reply_markup¶

Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user

optional_t<string_t> business_connection_id¶

Unique identifier of the business connection on behalf of which the message will be sent