Menu
飞书消息与群管理。发送消息、建群、置顶、加急、撤回、群菜单/Tab/公告。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
飞书多维表格操作。记录 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"
}
}