110 lines
2.8 KiB
Markdown
110 lines
2.8 KiB
Markdown
# 飞书应用权限配置
|
||
|
||
## 权限配置
|
||
|
||
请在飞书开放平台配置以下权限：
|
||
|
||
```json
|
||
{
|
||
"scopes": {
|
||
"tenant": [
|
||
"im:chat",
|
||
"aily:file:read",
|
||
"aily:file:write",
|
||
"cardkit:card:read",
|
||
"cardkit:card:write",
|
||
"cardkit:template:read",
|
||
"corehr:file:download",
|
||
"event:ip_list",
|
||
"im:app_feed_card:write",
|
||
"im:chat.access_event.bot_p2p_chat:read",
|
||
"im:message",
|
||
"im:message.p2p_msg:readonly",
|
||
"im:message:readonly",
|
||
"im:resource"
|
||
],
|
||
"user": [
|
||
"aily:file:read",
|
||
"aily:file:write",
|
||
"im:chat.access_event.bot_p2p_chat:read",
|
||
"im:message.p2p_msg:get_as_user"
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
## 配置步骤
|
||
|
||
### 1. 打开飞书开放平台
|
||
|
||
访问：https://open.feishu.cn/app/cli_a92ce47b02381bcc/auth
|
||
|
||
### 2. 添加权限
|
||
|
||
#### 租户权限（tenant）
|
||
在"权限管理"页面，搜索并添加以下权限：
|
||
|
||
| 权限代码 | 说明 |
|
||
|---------|------|
|
||
| `im:chat` | 发送消息 |
|
||
| `aily:file:read` | 读取文件 |
|
||
| `aily:file:write` | 写入文件 |
|
||
| `cardkit:card:read` | 读取卡片 |
|
||
| `cardkit:card:write` | 写入卡片 |
|
||
| `cardkit:template:read` | 读取卡片模板 |
|
||
| `corehr:file:download` | 下载文件 |
|
||
| `event:ip_list` | 查看 IP 列表 |
|
||
| `im:app_feed_card:write` | 发送应用消息卡片 |
|
||
| `im:chat.access_event.bot_p2p_chat:read` | 读取机器人私聊事件 |
|
||
| `im:message` | 发送消息 |
|
||
| `im:message.p2p_msg:readonly` | 读取私聊消息 |
|
||
| `im:message:readonly` | 读取消息 |
|
||
| `im:resource` | 访问消息中的资源（文件） |
|
||
|
||
#### 用户权限（user）
|
||
在"用户权限"页面，搜索并添加以下权限：
|
||
|
||
| 权限代码 | 说明 |
|
||
|---------|------|
|
||
| `aily:file:read` | 读取文件 |
|
||
| `aily:file:write` | 写入文件 |
|
||
| `im:chat.access_event.bot_p2p_chat:read` | 读取机器人私聊事件 |
|
||
| `im:message.p2p_msg:get_as_user` | 以用户身份获取私聊消息 |
|
||
|
||
### 3. 提交审核
|
||
|
||
部分权限需要管理员审核：
|
||
1. 点击"申请权限"
|
||
2. 填写申请理由（例如：用于七牛云文件上传功能）
|
||
3. 提交等待审核（通常很快）
|
||
|
||
### 4. 发布版本
|
||
|
||
权限配置完成后：
|
||
1. 点击"版本管理"
|
||
2. 点击"发布"
|
||
3. 确认发布
|
||
|
||
---
|
||
|
||
## 权限说明
|
||
|
||
### 核心权限
|
||
- `im:message` + `im:message:readonly` - 发送和接收消息
|
||
- `im:resource` - **关键权限**：下载用户上传的文件
|
||
- `im:message.p2p_msg:readonly` - 读取私聊消息
|
||
|
||
### 卡片权限
|
||
- `cardkit:*` - 发送交互式卡片
|
||
|
||
### 文件权限
|
||
- `aily:file:read` + `aily:file:write` - 文件读写
|
||
|
||
---
|
||
|
||
## 验证权限
|
||
|
||
配置完成后，在飞书开放平台的"权限管理"页面应该看到所有权限状态为"已申请"或"已授权"。
|
||
|
||
如有问题，请查看：https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN
|