docs: 添加 Nginx 部署指南和飞书权限说明
新增: - NGINX.md: Nginx 反向代理部署指南(含 HTTPS 配置) - FEISHU_PERMISSIONS.md: 飞书权限配置指南 修正: - README.md: 更正飞书权限(im:file → im:message + im:resource) - 添加文档链接
This commit is contained in:
113
FEISHU_PERMISSIONS.md
Normal file
113
FEISHU_PERMISSIONS.md
Normal file
@@ -0,0 +1,113 @@
|
||||
# 飞书权限配置指南
|
||||
|
||||
## 📋 正确的权限配置
|
||||
|
||||
在飞书开放平台创建应用后,需要配置以下权限:
|
||||
|
||||
### 必选权限
|
||||
|
||||
| 权限代码 | 权限名称 | 用途 |
|
||||
|---------|---------|------|
|
||||
| `im:message` | 消息 | 发送和接收消息(包含文件消息) |
|
||||
| `im:resource` | 资源 | 访问消息中的资源(文件、图片等) |
|
||||
|
||||
### 可选权限
|
||||
|
||||
| 权限代码 | 权限名称 | 用途 |
|
||||
|---------|---------|------|
|
||||
| `contact:group:readonly` | 群组信息 | 读取群组信息 |
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 常见错误
|
||||
|
||||
### ❌ 错误的权限:`im:file`
|
||||
|
||||
**问题:** 飞书权限中**没有** `im:file` 这个权限代码!
|
||||
|
||||
**正确做法:** 使用 `im:message` + `im:resource` 组合来实现文件上传下载功能。
|
||||
|
||||
### 为什么没有 `im:file`?
|
||||
|
||||
飞书的权限设计中,文件被视为一种"资源"(resource),而不是独立的权限类型。文件消息通过 `im:message` 接收,文件内容通过 `im:resource` 访问。
|
||||
|
||||
---
|
||||
|
||||
## 🔧 配置步骤
|
||||
|
||||
### 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)
|
||||
|
||||
---
|
||||
|
||||
**🍙 祝你配置顺利!**
|
||||
Reference in New Issue
Block a user