消息推送
现行消息接口
向指定私聊或群聊发送:
POST /openapi/bot/sendMessage
必填字段:
chat_idchat_type(group | private)content
可选字段:
parse_mode(默认richtext)
付费发送与能量查询
- 付费发送 v2:每条成功消息 0.12 能量,每 Bot 每滚动 60 秒最多准入 100 条,消息参数沿用原发送接口,必须提供 API Key、nonce、13 位 Unix 毫秒时间戳及签名。
- 查询能量余额:
GET /openapi/bot/energy,需要 API Key、nonce、13 位 Unix 毫秒时间戳及签名。 - 明确发送失败(例如 Bot 未入群)返回
ok=false;不要只检查 HTTP 状态码。超时后直接重试可能造成重复发送和扣费。
向所有已加入的群批量发送
使用 POST /openapi/bot/batchSendMessageToGroups,只需提供 content,可选 parse_mode、title 和 reply_markup,无需指定 chat_id 或 chat_type。内容最多 2000 UTF-8 字节,每群消耗 0.1 能量;异步投递的成功响应不代表所有群均已收到。成功响应还返回预计条数、能量、当前余额、预计分钟数和摘要。完整字段及错误说明见接口文档。