From 5a33f3de356750d30edaf35fd978ab275f06fdbc Mon Sep 17 00:00:00 2001 From: yangjunzhou Date: Thu, 30 Jul 2026 19:50:09 +0800 Subject: [PATCH] docs(im): explain querying topic replies by time --- skills/lark-im/references/lark-im-chat-messages-list.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/skills/lark-im/references/lark-im-chat-messages-list.md b/skills/lark-im/references/lark-im-chat-messages-list.md index d0f5af1856..d85ff23f4f 100644 --- a/skills/lark-im/references/lark-im-chat-messages-list.md +++ b/skills/lark-im/references/lark-im-chat-messages-list.md @@ -6,6 +6,8 @@ Fetch the message list for a conversation. Supports both group chats and direct By default the response carries a `reactions` block (counts + details from `im.reactions.batch_query`) on every message that has reactions, and `update_time` on messages that were actually edited. Thread replies expanded via auto-`thread_replies` participate in the same batched enrichment. Pass `--no-reactions` to skip the extra round-trip. Pass `--download-resources` to additionally download message resources (image/file/audio/video/media + post-embedded, excluding stickers) into `./lark-im-resources/` and attach a `resources` block — off by default. See [message enrichment](lark-im-message-enrichment.md) for the full contract. +> Time-range queries do not select thread replies independently. To detect new replies, use message subscriptions, or query the raw Messages API with `only_thread_root_messages=false` (native topic chats only). + This skill maps to the shortcut: `lark-cli im +chat-messages-list` (internally calls `GET /open-apis/im/v1/messages`, and automatically resolves the p2p chat_id when needed). ## Commands @@ -116,7 +118,7 @@ You can also fall back to the generic API: ```bash lark-cli api GET /open-apis/im/v1/messages \ - --params 'container_id_type=chat&container_id=oc_xxx&page_size=50&page_token=' + --params '{"container_id_type":"chat","container_id":"oc_xxx","page_size":"50","page_token":""}' ``` ## Common Errors and Troubleshooting