Menu
飞书消息与群管理。发送消息、建群、置顶、加急、撤回、群菜单/Tab/公告。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
飞书多维表格操作。记录 CRUD、字段管理、视图、权限、公式、关联。
飞书日历。创建日程、查询日程、更新日程。
飞书审批。创建审批实例、查询审批状态。
飞书交互卡片。构建和发送带按钮/选择器的消息卡片。
飞书组织架构与 ID 转换。搜索成员、部门管理、ID 互转（OpenID/UserID/UnionID）。
飞书文档写入。Markdown 转 Block、创建文档块、处理并发，支持 Mermaid 绘图块。
| name | feishu-im |
| description | 飞书消息与群管理。发送消息、建群、置顶、加急、撤回、群菜单/Tab/公告。 |
| required_permissions | ["im:message","im:chat:create","im:chat.members:write_only"] |
通过 IM API 发送消息、管理群聊和配置群功能。
Base URL: https://open.feishu.cn/open-apis/im/v1
从 feishu_skills 根目录执行共享脚本：
TOKEN="$(./scripts/get_feishu_token.sh)"
请求头统一使用 Authorization: Bearer ${TOKEN}。
如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：
TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"
环境变量:
FEISHU_APP_IDFEISHU_APP_SECRET本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）
| API | 端点 | 说明 |
|---|---|---|
| 发送消息 | POST /messages?receive_id_type=open_id | 支持文本/卡片/图片/文件 |
| 批量发送 | POST /messages/batch_send | 最多 200 人 |
| 回复消息 | POST /messages/{message_id}/reply | - |
| 撤回消息 | DELETE /messages/{message_id} | 24 小时内 |
| 加急消息 | PATCH /messages/{message_id}/urgent_app | - |
| 置顶消息 | POST /pins | - |
| 添加表情 | POST /messages/{message_id}/reactions | - |
发送文本消息:
{
"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: 备注| API | 端点 | 说明 |
|---|---|---|
| 创建群聊 | POST /chats | - |
| 获取群信息 | GET /chats/{chat_id} | - |
| 更新群信息 | PUT /chats/{chat_id} | 修改群名/描述/头像 |
| 解散群聊 | DELETE /chats/{chat_id} | - |
| 搜索群聊 | GET /chats/search | - |
创建群聊:
{
"name": "项目群",
"description": "项目讨论",
"user_id_list": ["ou_xxx", "ou_yyy"]
}
| API | 端点 | 说明 |
|---|---|---|
| 获取成员列表 | GET /chats/{chat_id}/members | - |
| 添加成员 | POST /chats/{chat_id}/members | 最多 50 人/次 |
| 移除成员 | DELETE /chats/{chat_id}/members | - |
| 转让群主 | PUT /chats/{chat_id}/owner | - |
| API | 端点 | 说明 |
|---|---|---|
| 群公告 | PATCH /chats/{chat_id}/announcement | - |
| 群置顶 | POST /chats/{chat_id}/top_notice/put_top_notice | - |
| 群菜单 | POST /chats/{chat_id}/menu_tree | - |
| 群 Tab | POST /chats/{chat_id}/chat_tabs | - |
设置群公告:
{
"content": "群公告内容",
"i18n_contents": {
"zh_cn": "中文公告",
"en_us": "English Announcement"
}
}