POST /sendDice – Photon Telegram Bot API

Telegram Bot API

Changed on Jun 14, 2026

Use this method to send an animated emoji that will display a random value. On success, the sent Message is returned.

post/sendDice

Request

Base URL: https://api.telegram.org/bot<bot_token>
URL: https://api.telegram.org/bot<bot_token>/sendDice
Auth: none declared

Request body

business_connection_idstring

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

message_thread_idinteger

Unique identifier for the target message thread (topic) of a forum; for forum supergroups and private chats of bots with forum topic mode enabled only

direct_messages_topic_idinteger

Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat

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 “”.

disable_notificationboolean

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

protect_contentboolean

Protects the contents of the sent message from forwarding

allow_paid_broadcastboolean

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_idstring

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

Response

Telegram API response

oktrue required

Changes

Jun 14, 2026e4c250383b33 Revision changes
- info
  added the new optional request property //////////// (media type: application/json)
- info
  added the new optional request property //////////// (media type: application/x-www-form-urlencoded)
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///////// to the response with the status

Operation history