| name | feishu-messaging |
| description | 飞书消息发送与文档创建工作流。
触发场景：用户提到"发飞书消息"、"飞书文档"、"通知某人"、"发送到飞书"、"飞书通知"。
适用于：发送飞书消息、创建飞书文档、操作多维表格、管理知识库。
|
飞书消息与文档 Skill
概述
此 Skill 通过飞书开放平台 API 帮助用户发送消息、创建文档和管理飞书资源。
核心能力
| 功能 | 状态 | 所需权限 |
|---|
| 发送文本消息 | ✅ 可用 | im:message:send_as_bot |
| 发送富文本消息 | ✅ 可用 | im:message:send_as_bot |
| 发送卡片消息 | ✅ 可用 | im:message:send_as_bot |
| 获取群聊列表 | ✅ 可用 | im:chat:readonly |
| 获取群成员 | ⏳ 待授权 | im:chat.members:read |
| 创建飞书文档 | ⏳ 待授权 | docx:document |
| 创建多维表格 | ⏳ 待授权 | bitable:app |
| 创建知识库页面 | ⏳ 待授权 | wiki:wiki |
使用方法
发送消息给指定用户
给 [姓名] 发一条飞书消息，告诉他 [内容]
前置条件：需要获取用户的 open_id
获取用户 open_id 的方法
-
方法一：通过邮箱/手机号查询（需要 contact:user.id:readonly 权限）
用户邮箱：xxx@company.com
-
方法二：让用户主动发消息
- 用户在飞书中搜索机器人名称
- 发送任意消息
- 机器人获取到用户的 open_id
-
方法三：用户自行查看
- 用户在机器人对话中发送
/myid
- 或从飞书开放平台后台查看
已知用户 ID 记录
消息类型
1. 文本消息
mcp__feishu__im_v1_message_create(
params={"receive_id_type": "open_id"},
data={
"receive_id": "ou_xxx",
"msg_type": "text",
"content": '{"text": "Hello World"}'
}
)
2. 富文本消息（Post）
支持标题、粗体、链接、@用户等格式。
mcp__feishu__im_v1_message_create(
params={"receive_id_type": "open_id"},
data={
"receive_id": "ou_xxx",
"msg_type": "post",
"content": json.dumps({
"zh_cn": {
"title": "消息标题",
"content": [
[{"tag": "text", "text": "正文内容"}],
[{"tag": "text", "text": "粗体", "style": ["bold"]}],
[{"tag": "a", "text": "链接", "href": "https://example.com"}]
]
}
})
}
)
3. 卡片消息（Interactive）
最丰富的消息格式，支持分栏、按钮、图片等。
mcp__feishu__im_v1_message_create(
params={"receive_id_type": "open_id"},
data={
"receive_id": "ou_xxx",
"msg_type": "interactive",
"content": json.dumps({
"config": {"wide_screen_mode": True},
"header": {
"title": {"tag": "plain_text", "content": "卡片标题"},
"template": "blue"
},
"elements": [
{"tag": "markdown", "content": "**支持 Markdown**\n- 列表项1\n- 列表项2"},
{"tag": "hr"},
{"tag": "div", "text": {"tag": "lark_md", "content": "分栏内容"}}
]
})
}
)
标准操作流程
发送消息 SOP
1. 确认收件人
↓ 有 open_id → 直接发送
↓ 无 open_id → 获取 open_id（见上述方法）
2. 确认消息类型
↓ 简单文本 → text
↓ 需要格式 → post
↓ 丰富卡片 → interactive
3. 构造消息内容
↓ 根据类型构造 JSON
4. 发送消息
↓ 调用 im_v1_message_create
5. 确认送达
↓ 检查返回的 message_id
创建文档 SOP（待权限开通）
1. 确认文档类型
↓ 普通文档 → docx_builtin_import
↓ 多维表格 → bitable_v1_app_create
↓ 知识库页面 → wiki 相关 API
2. 准备内容
↓ Markdown 格式（会自动转换）
3. 创建文档
4. 分享权限（可选）
↓ 添加协作者
权限申请指南
飞书应用信息
权限申请链接
| 功能 | 权限 | 申请链接 |
|---|
| 查询用户ID | contact:user.id:readonly | 申请 |
| 读取群成员 | im:chat.members:read | 申请 |
| 读取消息 | im:message | 申请 |
| 创建文档 | docx:document | 申请 |
| 多维表格 | bitable:app | 申请 |
| 知识库 | wiki:wiki | 申请 |
一键申请全部
申请所有常用权限
常见问题
Q: 消息发送成功但用户没收到？
可能原因：
- 用户未与机器人建立联系 → 让用户先给机器人发消息
- open_id 不正确 → 确认 open_id 来源
- 跨租户 → 机器人无法给其他企业用户发消息
Q: 权限申请不了？
可能原因：
- 机器人版本正在审核中 → 等待审核通过
- 企业管理员限制 → 联系管理员开通
- 权限需要特殊审批 → 走企业内部流程
Q: 如何发送群消息？
使用 chat_id 代替 open_id：
params={"receive_id_type": "chat_id"},
data={"receive_id": "oc_xxx", ...}
消息模板
能力介绍卡片
{
"config": {"wide_screen_mode": true},
"header": {
"title": {"tag": "plain_text", "content": "🤖 Claude Code 能力介绍"},
"template": "blue"
},
"elements": [
{"tag": "markdown", "content": "Hi，我是 **Claude Code**，一个 AI 编程助手。"},
{"tag": "div", "text": {"tag": "lark_md", "content": "**💻 开发支持**\n• 代码编写、调试和重构\n• Bug 排查与修复"}
任务通知卡片
{
"config": {"wide_screen_mode": true},
"header": {
"title": {"tag": "plain_text", "content": "📋 任务通知"},
"template": "green"
},
"elements": [
{"tag": "div", "fields": [
{"is_short": true, "text": {"tag": "lark_md", "content": "**任务**\n部署上线"}},
注意事项
- 消息频率限制 - 单用户每分钟最多 5 条消息
- 内容长度限制 - 卡片消息 body 不超过 30KB
- 图片需先上传 - 使用
im/v1/images 上传后获取 image_key
- 敏感信息 - 不要在消息中包含密码、token 等敏感信息
相关资源
