📖系列文章

• （一）准备工作
• （二）Day 1：飞书基础环境搭建
• （三）Day 2：飞书Bot开发配置
• （四）Day 3：Gitee和TRAE集成
• （五）Day 4：多维表格和自动化工作流
• （六）Day 5：完整场景实操验证
• （七）FAQ与附录

7 常见问题FAQ

Q1：Bot添加到群聊后没有响应，怎么办？

A：请按照以下步骤排查：

1. 确认应用已经发布成功（在开放平台查看应用版本状态）
2. 确认Bot已被添加到群聊（群设置 → 群机器人中可见）
3. 确认事件订阅已配置且权限已开通
4. 确认在群中发送消息时正确地@了Bot（@后出现蓝色高亮）
5. 如果是使用Webhook方式，确认Webhook URL正确且未过期

Q2：权限申请后一直显示"审批中"，怎么办？

A：部分敏感权限（如消息发送、用户信息读取）需要飞书管理员审批。请：

1. 在飞书管理后台（admin.feishu.cn）中登录管理员账号
2. 进入"工作台"→"应用审核"或"权限管理"
3. 找到待审批的权限申请，点击"通过"

如果你自己就是管理员，通常审批是即时通过的。如果仍显示审批中，请等待几分钟或刷新页面。

Q3：多维表格自动化规则没有触发，怎么办？

A：常见原因和解决方法：

1. 规则未启用：进入自动化页面，检查规则的开关是否为"开启"状态
2. 筛选条件不匹配：确认新增/修改的记录数据满足自动化规则的筛选条件
3. 消息发送权限不足：确认Bot有发送消息到目标群聊的权限
4. 定时任务未到时间：定时触发的规则只有在设定时间才会执行

Q4：TRAE Work自动化任务执行失败，怎么调试？

A：调试步骤：

1. 在TRAE Work中查看任务的执行日志，定位失败步骤
2. 常见失败原因：API凭证过期、网络连接问题、参数格式错误
3. 可以先在飞书开放平台的"API调试"工具中手动调用API，确认凭证是否有效
4. 检查Message模板中的变量值是否正确替换
5. 如果Gitee API调用失败，确认Personal Access Token未过期且有正确的权限

Q5：Gitee Webhook推送后飞书群没收到消息，怎么办？

A：这是因为Gitee标准Webhook和飞书自定义机器人Webhook的数据格式不兼容。解决方法：

1. 方法一：通过TRAE Work创建一个Webhook接收任务，接收Gitee的标准Webhook数据，转换为飞书消息格式后发送
2. 方法二：编写一个简单的中间服务（如Cloudflare Worker），接收Gitee Webhook并转发到飞书
3. 方法三：在Gitee中配置邮件通知，通过飞书的邮件集成实现通知（较复杂）

Q6：如何让Bot在群里自动回复消息？

A：要实现Bot的自动回复，需要：

1. 在Bot应用中配置事件订阅（im.message.receive_v1），使用长连接方式
2. 编写一个服务程序（Python/Node.js等），通过飞书SDK监听消息事件
3. 当收到@Bot的消息时，解析消息内容，根据内容生成回复，调用消息发送API发送回复
4. 或者使用TRAE Work的事件驱动能力来处理消息事件

最简单的方式是在TRAE Work中配置一个事件监听任务，让TRAE Work的AI自动处理@Bot的消息。

附录

附录A：常用API参考

💡提示：
所有飞书API的完整域名是https://open.feishu.cn。
更多API详情请参考飞书开放平台官方文档：https://open.feishu.cn/document。

附录B：快捷键速查

教程完成！

你已经完成了飞书AI-Native组织配置的全部5天课程。现在你拥有了一个完整的AI驱动组织运营体系，包括标准化的群聊结构、知识库、多维表格、飞书Bot、自动化工作流和文档模板。

记住，AI-Native组织不是一蹴而就的。持续优化你的自动化规则、扩展新的工作流场景、让AI参与更多的业务环节，你的组织将越来越高效。

持续学习，持续迭代，让AI成为你最可靠的协作者。