Use this method to send a dice, which will have a random value from 1 to 6. On success, the sent Message is returned. (Yes, we're aware of the 'proper' singular of die. But it's awkward, and we decided to help it change. One dice at a time!)


Name Type Description
chat_id Union[int, str] Unique identifier for the target chat or username of the target channel (in the format @channelusername)
emoji Optional[str] Optional. Emoji on which the dice throw animation is based. Currently, must be one of '' or ''. Defauts to ''
disable_notification Optional[bool] Optional. Sends the message silently. Users will receive a notification with no sound.
reply_to_message_id Optional[int] Optional. If the message is a reply, ID of the original message
reply_markup Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] Optional. Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.


Type: Message

Description: On success, the sent Message is returned.


As bot method

result: Message = await bot.send_dice(...)

Method as object


  • from aiogram.methods import SendDice
  • from aiogram.api.methods import SendDice
  • from aiogram.api.methods.send_dice import SendDice

In handlers with current bot

result: Message = await SendDice(...)

With specific bot

result: Message = await bot(SendDice(...))

As reply into Webhook in handler

return SendDice(...)