feishu-chat-history

Feishu Chat History

Fetch message history from a Feishu group chat and summarize or present it to the user.

When to Use

• User asks what was discussed in a group
• User wants a summary or review of recent messages
• User provides a chat_id or is in a group and asks about its history

How to Fetch Messages

Use the Feishu IM API directly via Python. See references/api.md for full details.

Quick summary:

1. Read credentials from config → channels.feishu.appId / appSecret
2. Get tenant_access_token via POST /auth/v3/tenant_access_token/internal
3. Fetch messages via GET /im/v1/messages?container_id_type=chat&container_id={chat_id}&page_size=50

Identifying the chat_id

• If the user is asking about the current group chat, use the chat_id from the inbound metadata (chat:oc_xxxxx → strip the chat: prefix to get the raw ID)
• If the user provides a different group, ask for the chat_id

Presenting Results

Parse each message and present a clean summary:

• Filter out msg_type=system (join/leave events) unless relevant
• For msg_type=text: extract .body.content as JSON, get the text field
• For msg_type=interactive: extract text nodes from the elements array
• For msg_type=image: note as [图片]
• Include sender name (from mentions or known bot app_ids), timestamp, and content
• Group by thread if root_id is present
• End with a human-readable summary of topics discussed

Pagination

If has_more=true, fetch more pages using page_token. Default: fetch 1 page (50 messages). Ask user if they want more.