跳到主要内容

消息推送

现行消息接口​

向指定私聊或群聊发送:

  • POST /openapi/bot/sendMessage

必填字段:

  • chat_id
  • chat_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 能量;异步投递的成功响应不代表所有群均已收到。成功响应还返回预计条数、能量、当前余额、预计分钟数和摘要。完整字段及错误说明见接口文档。

参考文档​