feishu-message

飞书消息工具

用于读取飞书消息的单一工具 feishu_message——通过 ID 获取单条消息，或列出聊天中的近期消息。

操作

获取单条消息

{
  "action": "get",
  "message_id": "om_xxx"
}

返回：

{
  "ok": true,
  "action": "get",
  "found": true,
  "message_id": "om_xxx",
  "msg_type": "text",
  "content": "Hello world",
  "sender_id": "ou_xxx",
  "sender_type": "user",
  "chat_id": "oc_xxx",
  "create_time": "1710000000000",
  "update_time": "1710000000000",
  "mentions": []
}

列出近期消息

列出聊天（私聊或群聊）中的近期消息，默认按时间从新到旧排序。 省略 chat_id 以使用当前对话的聊天：

{
  "action": "list"
}

自定义页面大小、排序方式和时间范围：

{
  "action": "list",
  "chat_id": "oc_xxx",
  "page_size": 20,
  "sort_type": "ByCreateTimeAsc",
  "start_time": "1710000000",
  "end_time": "1710086400"
}

返回：

{
  "ok": true,
  "action": "list",
  "chat_id": "oc_xxx",
  "total": 10,
  "messages": [
    {
      "message_id": "om_xxx",
      "msg_type": "text",
      "content_preview": "Hello world",
      "sender_id": "ou_xxx",
      "sender_type": "user",
      "create_time": "1710000000000",
      "chat_id": "oc_xxx"
    }
  ]
}

参数

参数	必填	描述
action	是	get 或 list
message_id	get：是	飞书消息 ID（例如，om_xxx）
chat_id	list：可选	聊天 ID（例如，oc_xxx）。省略以使用当前聊天。
page_size	list：可选	消息数量（默认值：10，最大值：50）
sort_type	list：可选	ByCreateTimeDesc（默认值）或 ByCreateTimeAsc
start_time	list：可选	Unix 时间戳，单位为秒（例如，"1710000000"）。省略时不设下限。
end_time	list：可选	Unix 时间戳，单位为秒（例如，"1710086400"）。省略时不设上限。

配置

channels:
  feishu:
    tools:
      message: true  # default: true

权限

• im:message 或 im:message:readonly — 读取单条消息或私聊消息
• im:message.group_at_msg:readonly — 读取群聊中的所有消息（而非仅 @ 机器人的消息）