sendDice¶
Returns: Message
- class aiogram.methods.send_dice.SendDice(*, chat_id: int | str, business_connection_id: str | None = None, message_thread_id: int | None = None, emoji: str | None = None, disable_notification: bool | None = None, protect_content: bool | ~aiogram.client.default.Default | None = <Default('protect_content')>, allow_paid_broadcast: bool | None = None, message_effect_id: str | None = None, reply_parameters: ~aiogram.types.reply_parameters.ReplyParameters | None = None, reply_markup: ~aiogram.types.inline_keyboard_markup.InlineKeyboardMarkup | ~aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup | ~aiogram.types.reply_keyboard_remove.ReplyKeyboardRemove | ~aiogram.types.force_reply.ForceReply | None = None, allow_sending_without_reply: bool | None = None, reply_to_message_id: int | None = None, **extra_data: ~typing.Any)[source]¶
Use this method to send an animated emoji that will display a random value. On success, the sent
aiogram.types.message.Message
is returned.Source: https://core.telegram.org/bots/api#senddice
- chat_id: int | str¶
Unique identifier for the target chat or username of the target channel (in the format
@channelusername
)
- business_connection_id: str | None¶
Unique identifier of the business connection on behalf of which the message will be sent
- message_thread_id: int | None¶
Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
- emoji: str | None¶
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 ‘🎲’
- disable_notification: bool | None¶
Sends the message silently. Users will receive a notification with no sound.
- protect_content: bool | Default | None¶
Protects the contents of the sent message from forwarding
- model_post_init(context: Any, /) None ¶
We need to both initialize private attributes and call the user-defined model_post_init method.
- allow_paid_broadcast: bool | None¶
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
- message_effect_id: str | None¶
Unique identifier of the message effect to be added to the message; for private chats only
- reply_parameters: ReplyParameters | None¶
Description of the message to reply to
- reply_markup: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None¶
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
- allow_sending_without_reply: bool | None¶
Pass
True
if the message should be sent even if the specified replied-to message is not foundDeprecated since version API:7.0: https://core.telegram.org/bots/api-changelog#december-29-2023
- reply_to_message_id: int | None¶
If the message is a reply, ID of the original message
Deprecated since version API:7.0: https://core.telegram.org/bots/api-changelog#december-29-2023
Usage¶
As bot method¶
result: Message = await bot.send_dice(...)
Method as object¶
Imports:
from aiogram.methods.send_dice import SendDice
alias:
from aiogram.methods import SendDice
With specific bot¶
result: Message = await bot(SendDice(...))
As reply into Webhook in handler¶
return SendDice(...)
As shortcut from received object¶
aiogram.types.chat_join_request.ChatJoinRequest.answer_dice()
aiogram.types.chat_join_request.ChatJoinRequest.answer_dice_pm()
aiogram.types.chat_member_updated.ChatMemberUpdated.answer_dice()
aiogram.types.inaccessible_message.InaccessibleMessage.answer_dice()
aiogram.types.inaccessible_message.InaccessibleMessage.reply_dice()