8e1462a6db
- 移除不准确的权限代码（im:resource） - 使用实际导出的权限：im:message, im:message:readonly, aily:file:read, aily:file:write
132 lines
2.8 KiB
Markdown
132 lines
2.8 KiB
Markdown
# 飞书权限配置指南
|
|
|
|
## 📋 正确的权限配置
|
|
|
|
在飞书开放平台创建应用后，需要配置以下权限：
|
|
|
|
### 必选权限
|
|
|
|
| 权限代码 | 说明 |
|
|
|---------|------|
|
|
| `im:message` | 发送消息 |
|
|
| `im:message:readonly` | 读取消息 |
|
|
| `aily:file:read` | 读取文件 |
|
|
| `aily:file:write` | 写入文件 |
|
|
|
|
### 权限配置示例
|
|
|
|
```json
|
|
{
|
|
"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. 进入权限管理
|
|
|
|
1. 访问 [飞书开放平台](https://open.feishu.cn/)
|
|
2. 进入你的应用管理页面
|
|
3. 点击左侧菜单"权限管理"
|
|
|
|
### 2. 添加权限
|
|
|
|
点击"添加权限"，搜索并添加：
|
|
|
|
1. **im:message**
|
|
- 搜索"消息"
|
|
- 勾选"发送消息"和"读取消息"
|
|
- 点击"确定"
|
|
|
|
2. **im:resource**
|
|
- 搜索"资源"
|
|
- 勾选"访问消息中的资源"
|
|
- 点击"确定"
|
|
|
|
### 3. 提交审核
|
|
|
|
部分权限需要管理员审核：
|
|
- 点击"申请权限"
|
|
- 填写申请理由（例如：用于文件上传功能）
|
|
- 提交等待审核（通常很快）
|
|
|
|
---
|
|
|
|
## 📝 权限说明
|
|
|
|
### im:message
|
|
|
|
**作用：** 允许机器人发送和接收消息
|
|
|
|
**包含能力：**
|
|
- 接收用户发送给机器人的消息
|
|
- 接收群组中 @ 机器人的消息
|
|
- 向用户发送消息
|
|
- 向群组发送消息
|
|
- **接收文件消息**（文件作为一种消息类型）
|
|
|
|
### im:resource
|
|
|
|
**作用：** 允许机器人访问消息中的资源
|
|
|
|
**包含能力：**
|
|
- 下载消息中的文件
|
|
- 下载消息中的图片
|
|
- 下载消息中的视频
|
|
- 访问其他附件资源
|
|
|
|
---
|
|
|
|
## ✅ 验证权限
|
|
|
|
配置完成后，在应用管理页面的"权限管理"中应该看到：
|
|
|
|
```
|
|
✅ im:message - 已申请
|
|
✅ im:resource - 已申请
|
|
```
|
|
|
|
如果显示"审核中"，需要等待管理员审核通过。
|
|
|
|
---
|
|
|
|
## 🔗 相关文档
|
|
|
|
- [飞书开放平台 - 权限管理](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)
|
|
- [消息事件订阅](https://open.feishu.cn/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN)
|
|
- [资源访问 API](https://open.feishu.cn/document/ukTMukTMukTM/uQjNwUjLyYDM14iN2ATN)
|
|
|
|
---
|
|
|
|
**🍙 祝你配置顺利！**
|