SoChatSoChat

API

Edit / delete / forward

Edit or delete bot-sent messages; forward and copy.

Back to index

Auth: Authorization: Bearer sbot_…

POST/api/v1/bots/editMessage
Bot Token

editMessageEdit Bot Message

仅支持编辑由本机器人（同一 `system_user_id`）发送的文本消息；触发 `edited_message` Update。

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

deleteMessageDelete Bot Message

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

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

editMessageReplyMarkupEdit InlineKeyboard Only

替换某条本机器人消息的 `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

Forward a history message to target chat; bot must be active member in both source / target chats.

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

copyMessage

Sync with `forwardMessage`, but without "forwarded from" mark.

  • Required: from_chat_id, chat_id, message_id
  • Optional: caption (override text/caption on the copy; same semantics as forwardMessage)
  • Returns: the copied message object (metadata.isForwarded is not set)