sendDice

发送一个带随机结果的动画表情消息，例如骰子、飞镖、篮球、足球、老虎机或保龄球。

请求

POST /:token/sendDice

参数

参数	类型	必填	描述
chat_id	Integer/String	是	目标聊天的唯一标识符或用户名
business_connection_id	String	否	商业连接的唯一标识符，用于代表商业帐户发送消息
message_thread_id	Integer	否	目标消息线程（话题）的唯一标识符，仅用于论坛超级群或开启论坛话题模式的 Bot 私聊
direct_messages_topic_id	Integer	否	直连消息话题 ID；发送到直连消息聊天时必填
emoji	String	否	动画表情，可选 `🎲`、`🎯`、`🏀`、`⚽`、`🎰`、`🎳`，默认 `🎲`
disable_notification	Boolean	否	静默发送消息，用户将收到无声通知
protect_content	Boolean	否	保护消息内容不被转发和保存
allow_paid_broadcast	Boolean	否	允许以每条 0.1 Telegram Stars 的费用突破广播限制，最高每秒 1000 条消息
message_effect_id	String	否	消息特效的唯一标识符，仅用于私聊
suggested_post_parameters	Object	否	建议帖参数，JSON 序列化对象，仅用于直连消息聊天
reply_parameters	Object	否	回复参数，描述要回复的消息
reply_markup	Object	否	自定义键盘、内联键盘、移除键盘或强制回复标记，JSON 序列化对象

随机值范围

emoji	类型	value 范围
`🎲`	骰子	1-6
`🎯`	飞镖	1-6
`🎳`	保龄球	1-6
`🏀`	篮球	1-5
`⚽`	足球	1-5
`🎰`	老虎機	1-64

响应

返回发送成功的 Message 对象，其中包含 dice 字段。

json

{
  "ok": true,
  "result": {
    "message_id": 102,
    "from": {
      "id": 123456789,
      "is_bot": true,
      "first_name": "MyBot",
      "username": "my_bot"
    },
    "chat": {
      "id": 987654321,
      "first_name": "User",
      "username": "user123",
      "type": "private"
    },
    "date": 1700000000,
    "dice": {
      "emoji": "🎲",
      "value": 4
    }
  }
}

错误码

错误码	描述
400	请求参数错误，如缺少 chat_id、emoji 不支持或 reply_markup 格式错误
401	Token 无效或已过期
403	Bot 被该用户封禁或无权向该聊天发送消息
404	聊天不存在
429	请求过于频繁，触发发送频率限制
500	服务器内部错误

示例

发送默认骰子

bash

curl -X POST "https://api.safew.bot/<token>/sendDice" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 987654321
  }'

发送篮球动画

bash

curl -X POST "https://api.safew.bot/<token>/sendDice" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 987654321,
    "emoji": "🏀",
    "disable_notification": true
  }'

带内联键盘的小游戏

bash

curl -X POST "https://api.safew.bot/<token>/sendDice" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 987654321,
    "emoji": "🎯",
    "reply_markup": {
      "inline_keyboard": [
        [
          {"text": "再来一次", "callback_data": "dice_retry"},
          {"text": "查看规则", "callback_data": "dice_rules"}
        ]
      ]
    }
  }'

sendDice ​

请求 ​

参数 ​

随机值范围 ​

响应 ​

错误码 ​

示例 ​

发送默认骰子 ​

发送篮球动画 ​

带内联键盘的小游戏 ​

相关应用 ​

sendDice

请求

参数

随机值范围

响应

错误码

示例

发送默认骰子

发送篮球动画

带内联键盘的小游戏

相关应用