send_dice

template<class Agent>
api_result<message_t, Agent&&> send_dice(Agent &&agent, send_dice_args_t args)

template<class Agent, class F>
void send_dice(Agent &&agent, send_dice_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 an animated emoji that will display a random value. On success, the sent Message is returned.

struct send_dice_args_t

Arguments that should be passed to send_dice().

variant_t<integer_t, string_t> chat_id

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

optional_t<integer_t> message_thread_id

Unique identifier for the target message thread (topic) of the forum; for forum supergroups only

optional_t<string_t> emoji

Emoji on which the dice throw animation is based. Currently, must be one of “🎲”, “🎯”, “🏀”, “⚽”, “🎳”, or “🎰”. Dice can have values 1-6 for “🎲”, “🎯” and “🎳”, values 1-5 for “🏀” and “⚽”, and values 1-64 for “🎰”. Defaults to “🎲”

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

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<string_t> message_effect_id

Unique identifier of the message effect to be added to the message; for private chats only

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