8e1462a6db
- 移除不准确的权限代码（im:resource） - 使用实际导出的权限：im:message, im:message:readonly, aily:file:read, aily:file:write
2.8 KiB
2.8 KiB
飞书权限配置指南
📋 正确的权限配置
在飞书开放平台创建应用后，需要配置以下权限：
必选权限
| 权限代码 | 说明 |
|---|---|
im:message |
发送消息 |
im:message:readonly |
读取消息 |
aily:file:read |
读取文件 |
aily:file:write |
写入文件 |
权限配置示例
{
"scopes": {
"tenant": [
"im:message",
"im:message:readonly",
"aily:file:read",
"aily:file:write"
],
"user": [
"aily:file:read",
"aily:file:write"
]
}
}
⚠️ 注意事项
权限说明
im:message- 允许机器人发送消息到聊天im:message:readonly- 允许机器人读取接收到的消息aily:file:read- 允许机器人读取和下载文件aily:file:write- 允许机器人上传文件
为什么需要这些权限？
- 接收飞书消息需要
im:message+im:message:readonly - 下载用户上传的文件需要
aily:file:read - （本应用不需要
aily:file:write，因为文件是上传到七牛云，不是飞书云空间）
🔧 配置步骤
1. 进入权限管理
- 访问 飞书开放平台
- 进入你的应用管理页面
- 点击左侧菜单"权限管理"
2. 添加权限
点击"添加权限"，搜索并添加：
-
im:message
- 搜索"消息"
- 勾选"发送消息"和"读取消息"
- 点击"确定"
-
im:resource
- 搜索"资源"
- 勾选"访问消息中的资源"
- 点击"确定"
3. 提交审核
部分权限需要管理员审核：
- 点击"申请权限"
- 填写申请理由（例如：用于文件上传功能）
- 提交等待审核（通常很快）
📝 权限说明
im:message
作用： 允许机器人发送和接收消息
包含能力：
- 接收用户发送给机器人的消息
- 接收群组中 @ 机器人的消息
- 向用户发送消息
- 向群组发送消息
- 接收文件消息（文件作为一种消息类型）
im:resource
作用： 允许机器人访问消息中的资源
包含能力：
- 下载消息中的文件
- 下载消息中的图片
- 下载消息中的视频
- 访问其他附件资源
✅ 验证权限
配置完成后，在应用管理页面的"权限管理"中应该看到：
✅ im:message - 已申请
✅ im:resource - 已申请
如果显示"审核中"，需要等待管理员审核通过。
🔗 相关文档
🍙 祝你配置顺利！