📖 系列文章
文章目录
3 Day 2：飞书Bot开发配置
Day 2的目标是创建一个企业自建的飞书Bot，让它能够收发消息、读写文档、操作多维表格。这个Bot将是整个AI-Native组织的核心AI成员。
3.1 什么是飞书Bot
飞书Bot（机器人）是运行在飞书平台上的自动化程序，它可以：
- 接收消息：当用户在群聊或私聊中@Bot时，Bot可以接收到消息内容
- 发送消息：Bot可以主动向群聊或个人发送文本、富文本、卡片消息
- 操作文档：Bot可以读取、创建、编辑飞书文档
- 操作多维表格：Bot可以增删改查多维表格中的记录
- 管理知识库：Bot可以读取知识库中的文档内容
- 调用API：Bot可以通过飞书开放API完成几乎所有飞书平台支持的操作
在我们的AI-Native组织中，Bot将承担以下核心职责：
- 每日自动生成项目早报并推送到群聊
- 接收Gitee的Webhook通知并转发到代码通知群
- 自动监控多维表格中的数据变化并发送提醒
- 响应群聊中的简单指令（如查询任务状态、生成报表等）
3.2 注册飞书开放平台账号
步骤1：访问飞书开放平台
打开浏览器，访问 https://open.feishu.cn，使用你的飞书账号登录。
步骤2：进入开发者后台
登录成功后，点击页面右上角的"进入开发者后台"按钮。如果是首次访问，系统会提示你创建一个开发者团队（或使用现有团队）。
步骤3：确认开发者身份
在开发者后台中，确认你的身份是"管理员"或"开发者"。如果不是，需要在飞书管理后台中申请相应权限。
💡 提示：
飞书开放平台的开发者后台就是管理所有自建应用的统一入口。
你创建的Bot、配置的权限、查看的API调试工具，都在这里操作。
3.3 创建企业自建应用
步骤1：创建应用
在开发者后台首页，点击"创建企业自建应用"按钮。
- 应用名称：
[团队名]-AI助手（例如"xx科技-AI助手"） - 应用描述：
团队AI-Native组织的智能协作者，负责信息推送、数据同步和自动化工作流 - 图标：选择一个机器人图标或上传自定义图标
步骤2：查看应用基本信息
创建成功后，你会进入应用的"凭证与基础信息"页面。在这里你可以看到：
- App ID：应用的唯一标识（后续配置TRAE Work需要用到）
- App Secret：应用的密钥（请妥善保管，不要泄露）
⚠️ 注意：
App Secret 是极其敏感的信息！
不要将它提交到代码仓库、不要分享给无关人员、不要在公开的文档中展示。
如果怀疑Secret泄露，请立即在开放平台中重置。
3.4 添加Bot能力
在应用管理页面左侧导航栏中，找到"添加应用能力"→"机器人"，点击"添加"按钮来开启机器人能力。
3.5 配置应用权限
Bot需要获得相应权限才能操作飞书的各种功能。在应用管理页面左侧导航栏中，找到"权限管理"，按照以下表格逐一搜索并开通所需权限：
| 权限类别 | 权限Scope | 权限说明 | 使用场景 |
|---|---|---|---|
| 消息 | im:message:send_as_bot | 以机器人身份发送消息 | Bot向群聊发送日报、通知等 |
| 文档 | docx:document:readonly | 读取飞书文档内容 | 读取知识库中的文档 |
docx:document:create | 创建飞书文档 | 自动创建会议纪要等文档 | |
docx:document:write_only | 编辑飞书文档内容 | 向文档中写入数据 | |
| 多维表格 | bitable:app | 查看、评论、编辑和管理多维表格 | 读写敏捷项目管理和CRM表格 |
| 知识库 | wiki:wiki:readonly | 只读访问知识库 | 读取知识库中的文档内容 |
| 用户信息 | contact:user.base:readonly | 读取用户基本信息 | 获取@Bot的用户身份信息 |
步骤3：搜索和开通权限
在"权限管理"页面的搜索框中，逐一输入上述scope名称或描述关键字，找到对应权限后点击"开通"按钮：
- 在搜索框中输入
im:message，找到消息相关权限，点击开通 - 搜索
docx:document，找到文档相关权限，点击开通 - 搜索
bitable，找到多维表格权限，点击开通 - 搜索
wiki，找到知识库权限，点击开通 - 搜索
contact:user，找到用户信息权限，点击开通
⚠️ 注意：
1、权限开通后，部分权限需要管理员审批才能生效。
如果你不是飞书管理员，请联系管理员审批权限。审批通过后，权限才会真正生效。
2、完整权限列表可在链接（BOT完整权限）中下载，直接批量导入即可。
3.6 配置事件订阅
事件订阅让Bot能够实时感知飞书中发生的事情（如收到消息）。我们需要配置Bot使用长连接方式接收事件。
步骤1：启用长连接
在应用管理页面左侧导航栏中，找到"事件与回调"→"事件配置"：
- 选择使用长连接接收事件（推荐方式，无需公网IP，无需配置Webhook地址）
- 点击"添加事件"按钮
步骤2：添加消息事件
在事件列表中搜索并添加以下事件：
im.message.receive_v1—— 接收消息事件（当有人在群聊中@Bot或私聊Bot时触发）
💡 提示：
长连接方式的优势是不需要公网服务器，Bot通过飞书开放的WebSocket长连接实时接收事件。
这对于个人开发者和中小团队非常友好，无需配置Nginx、域名和SSL证书。
3.7 获取App ID和App Secret
步骤1：获取凭证
在应用管理页面，点击左侧导航栏的"凭证与基础信息"：
- App ID：以
cli_开头的字符串，例如cli_a5xxxxxxxxxxxxxx - App Secret：一串字母数字组合，例如
abc123def456ghi789
步骤2：安全保存凭证
请将这两个值安全地保存起来。建议：
- 保存在密码管理器中（如1Password、Bitwarden）
- 或保存在本地加密文件中
- 不要保存到代码仓库或公开文档中
⚠️ 注意：
App ID 和 App Secret 在后续章节（TRAE Work配置、自动化工作流）中会频繁使用，请确保你能够随时找到它们。
3.8 发布应用
步骤1：创建版本
在应用管理页面左侧导航栏中，找到"版本管理与发布"：
- 点击"创建版本"按钮
- 版本号：
1.0.0 - 更新说明：
初始版本：支持消息收发、文档读写、多维表格操作 - 点击"保存"
步骤2：申请发布
创建版本后，点击"申请发布"。根据你的组织设置：
- 如果需要管理员审批，请通知管理员审批
- 如果不需要审批，应用会立即发布上线
步骤3：确认发布成功
在飞书客户端的消息页面，搜索你的Bot名称。如果能够搜索到，说明Bot已成功发布。
3.9 测试Bot是否正常工作
步骤1：添加Bot到群聊
打开昨天创建的"[团队名]-AI-Bot通知"群聊，点击群设置（右上角"…“）→"群机器人"→"添加机器人”，搜索并添加你的Bot。
步骤2：测试消息
在群聊中输入 @[你的Bot名称] 你好，然后发送。由于我们还没有编写Bot的回复逻辑，Bot不会自动回复，但你可以在飞书开放平台的"事件订阅"页面看到事件已收到（如果开启了长连接调试）。
步骤3：使用Webhook测试消息发送
如果你已经配置了自定义机器人Webhook（在"机器人"配置页面可以找到），可以使用以下curl命令测试Bot能否发送消息：
curl -X POST \
'https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_WEBHOOK_URL' \
-H 'Content-Type: application/json' \
-d '{
"msg_type": "text",
"content": {
"text": "Hello from AI-Native Bot! 测试消息发送成功。"
}
}'
✅ 检查点：
确认以下事项：
- Bot已成功添加到"[团队名]-AI-Bot通知"群
- 在群中@Bot能够被系统识别（Bot名称变为蓝色可点击）
- Webhook测试消息能够在群聊中显示（如果配置了Webhook）
3.10 Day 2 完成清单
- 飞书开放平台账号已注册
- 企业自建应用已创建并命名
- Bot能力已启用
- 6个权限scope已全部开通并审批通过
- 事件订阅已配置（长连接 +
im.message.receive_v1） - App ID 和 App Secret 已安全保存
- 应用已发布（版本1.0.0）
- Bot已添加到测试群聊
- 基本消息功能测试通过
332
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
