系列文章一准备工作二Day 1飞书基础环境搭建三Day 2飞书Bot开发配置四Day 3Gitee和TRAE集成五Day 4多维表格和自动化工作流六Day 5完整场景实操验证七FAQ与附录文章目录3 Day 2飞书Bot开发配置3.1 什么是飞书Bot3.2 注册飞书开放平台账号3.3 创建企业自建应用3.4 添加Bot能力3.5 配置应用权限3.6 配置事件订阅3.7 获取App ID和App Secret3.8 发布应用3.9 测试Bot是否正常工作3.10 Day 2 完成清单3 Day 2飞书Bot开发配置Day 2的目标是创建一个企业自建的飞书Bot让它能够收发消息、读写文档、操作多维表格。这个Bot将是整个AI-Native组织的核心AI成员。3.1 什么是飞书Bot飞书Bot机器人是运行在飞书平台上的自动化程序它可以接收消息当用户在群聊或私聊中Bot时Bot可以接收到消息内容发送消息Bot可以主动向群聊或个人发送文本、富文本、卡片消息操作文档Bot可以读取、创建、编辑飞书文档操作多维表格Bot可以增删改查多维表格中的记录管理知识库Bot可以读取知识库中的文档内容调用APIBot可以通过飞书开放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_a5xxxxxxxxxxxxxxApp 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-XPOST\https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_WEBHOOK_URL\-HContent-Type: application/json\-d{ msg_type: text, content: { text: Hello from AI-Native Bot! 测试消息发送成功。 } }✅检查点确认以下事项Bot已成功添加到[团队名]-AI-Bot通知群在群中Bot能够被系统识别Bot名称变为蓝色可点击Webhook测试消息能够在群聊中显示如果配置了Webhook3.10 Day 2 完成清单飞书开放平台账号已注册企业自建应用已创建并命名Bot能力已启用6个权限scope已全部开通并审批通过事件订阅已配置长连接 im.message.receive_v1App ID和App Secret已安全保存应用已发布版本1.0.0Bot已添加到测试群聊基本消息功能测试通过