浏览文档目录

API

编辑 / 撤回 / 转发

修改或撤回机器人自己发出的消息,以及转发/复制。

鉴权: Authorization: Bearer sbot_…

POST/api/v1/bots/editMessage
Bot Token

editMessage编辑机器人自发消息

仅支持编辑本机器人发出的文本消息;成功后触发 `edited_message` Update。

  • 必填:message_id (或 messageId)、text (或 content)
  • 仅限本机器人发送的消息;其他消息返回 403
  • 编辑成功后消息 metadata.isEdited=true,客户端会显示“已编辑”标记
POST/api/v1/bots/deleteMessage
Bot Token

deleteMessage删除(撤回)机器人自发消息

仅支持删除由本机器人发送的消息;触发 `message_deleted` Update。

  • 必填:message_id (或 messageId)
  • 仅限本机器人发送的消息;其他消息返回 403
  • 删除后下游会广播 message.deleted,客户端从历史中移除
POST/api/v1/bots/editMessageReplyMarkup
Bot Token

editMessageReplyMarkup仅编辑 InlineKeyboard

替换某条本机器人消息的 `reply_markup`;不改正文与多媒体。传 `null` 表示清空按钮。

  • 必填:message_id
  • reply_markup 为 null 等价于「清空按钮」;提供新键盘则按 8×8 / text 1–64 / callback_data ≤ 64 字节 / url 必须 http(s):// / action 仅支持 user_profile 或 public_group 校验
  • public_group 只能指向存在且未解散的公开群;群在消息发出后改为私有时,客户端也会拒绝跳转
  • 仅限本机器人发送的消息;其他消息返回 403
POST/api/v1/bots/forwardMessage
Bot Token

forwardMessage

将一条历史消息以「转发」形式发到目标会话;机器人需是源 / 目标双会话的活跃成员。

  • 必填:from_chat_id、chat_id (目标)、message_id
  • 可选:caption
  • 返回:转发后的消息对象
POST/api/v1/bots/copyMessage
Bot Token

copyMessage

与 `forwardMessage` 同步对齐,但不带「转发自」标记。

  • 必填:from_chat_id、chat_id、message_id
  • 可选:caption(覆盖复制后的说明/正文;与 forwardMessage 同语义)
  • 返回:复制后生成的消息对象(不写入 metadata.isForwarded)