[Skill 名] feishu-im

飛書メッセージとグループ管理

IM API を通じてメッセージの送信、グループチャットの管理、グループ機能の設定を行います。

ベース URL: https://open.feishu.cn/open-apis/im/v1

認証とトークンの取得

feishu_skills のルートディレクトリから共有スクリプトを実行します。

TOKEN="$(./scripts/get_feishu_token.sh)"

リクエストヘッダーは一律 Authorization: Bearer ${TOKEN} を使用します。

もしビジネスインターフェースがトークン無効、期限切れ、または 401 を返した場合、強制的に更新した後、元のリクエストを一度だけ再試行します。

TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

環境変数:

• FEISHU_APP_ID
• FEISHU_APP_SECRET

ローカルキャッシュ: ./.feishu_token_cache.json（期限切れでなければ直接再利用し、デフォルトでは5分前に更新します）

メッセージ操作

テキストメッセージの送信:

{
  "receive_id": "ou_xxx",
  "msg_type": "text",
  "content": "{\"text\":\"Hello\"}"
}

⚠️ content は文字列化された JSON である必要があります。

receive_id_type: open_id / user_id / email / chat_id

インタラクティブカード

カードの送信:

{
  "receive_id": "ou_xxx",
  "msg_type": "interactive",
  "content": "<card_json_string>"
}

カード構造:

{
  "config": {"wide_screen_mode": true},
  "header": {
    "title": {"tag": "plain_text", "content": "タイトル"},
    "template": "blue"
  },
  "elements": [
    {"tag": "div", "text": {"tag": "lark_md", "content": "**加粗**"}},
    {"tag": "action", "actions": [
      {"tag": "button", "text": {"tag": "plain_text", "content": "確認"}, "type": "primary"}
    ]}
  ]
}

よく使われる要素:

• div: テキストブロック（lark_md / plain_text をサポート）
• hr: 区切り線
• action: ボタン群
• img: 画像
• note: 備考

グループチャット管理

グループチャットの作成:

{
  "name": "プロジェクトグループ",
  "description": "プロジェクトの議論",
  "user_id_list": ["ou_xxx", "ou_yyy"]
}

グループメンバー管理

グループ機能設定

グループアナウンスの設定:

{
  "content": "グループアナウンスの内容",
  "i18n_contents": {
    "zh_cn": "中文公告",
    "en_us": "English Announcement"
  }
}

ベストプラクティス

1. 一括送信を優先する（API呼び出しを減らすため）
2. カードの content は文字列化する必要がある
3. グループメンバー操作は1回につき最大50人まで
4. メッセージの撤回は24時間以内