feishu-chat-history

Feishu チャット履歴

Feishu グループチャットからメッセージ履歴を取得し、要約するかユーザーに提示します。

使用する場面

• グループで何が話し合われたかをユーザーが尋ねた場合
• 最近のメッセージの要約や確認をユーザーが求めた場合
• ユーザーが chat_id を指定した場合、またはグループ内でその履歴について尋ねた場合

メッセージの取得方法

Python 経由で Feishu IM API を直接使用します。詳しくは references/api.md を参照してください。

簡単な手順：

1. 設定から認証情報を読み取ります → channels.feishu.appId / appSecret
2. POST /auth/v3/tenant_access_token/internal で tenant_access_token を取得します
3. GET /im/v1/messages?container_id_type=chat&container_id={chat_id}&page_size=50 でメッセージを取得します

chat_id の特定

• ユーザーが現在のグループチャットについて尋ねている場合は、受信メタデータの chat_id を使用します（chat:oc_xxxxx → chat: プレフィックスを削除して生の ID を取得します）
• ユーザーが別のグループを指定した場合は、chat_id を尋ねます

結果の提示

各メッセージを解析し、見やすく要約して提示します：

• 関連がない限り、msg_type=system（参加／退出イベント）は除外します
• msg_type=text：.body.content を JSON として解析し、text フィールドを取得します
• msg_type=interactive：elements 配列からテキストノードを抽出します
• msg_type=image：[图片] として記載します
• 送信者名（mentions または既知のボットの app_ids から取得）、タイムスタンプ、内容を含めます
• root_id がある場合はスレッドごとにまとめます
• 最後に、話し合われたトピックを人が読みやすい形で要約します

ページネーション

has_more=true の場合は、page_token を使用して次のページを取得します。デフォルトでは 1 ページ（50 件）を取得します。さらに取得するかユーザーに確認してください。