系列文章一准备工作二Day 1飞书基础环境搭建三Day 2飞书Bot开发配置四Day 3Gitee和TRAE集成五Day 4多维表格和自动化工作流六Day 5完整场景实操验证七FAQ与附录文章目录7 常见问题FAQQ1Bot添加到群聊后没有响应怎么办Q2权限申请后一直显示审批中怎么办Q3多维表格自动化规则没有触发怎么办Q4TRAE Work自动化任务执行失败怎么调试Q5Gitee Webhook推送后飞书群没收到消息怎么办Q6如何让Bot在群里自动回复消息附录附录A常用API参考附录B快捷键速查教程完成7 常见问题FAQQ1Bot添加到群聊后没有响应怎么办A请按照以下步骤排查确认应用已经发布成功在开放平台查看应用版本状态确认Bot已被添加到群聊群设置 → 群机器人中可见确认事件订阅已配置且权限已开通确认在群中发送消息时正确地了Bot后出现蓝色高亮如果是使用Webhook方式确认Webhook URL正确且未过期Q2权限申请后一直显示审批中怎么办A部分敏感权限如消息发送、用户信息读取需要飞书管理员审批。请在飞书管理后台admin.feishu.cn中登录管理员账号进入工作台→应用审核或权限管理找到待审批的权限申请点击通过如果你自己就是管理员通常审批是即时通过的。如果仍显示审批中请等待几分钟或刷新页面。Q3多维表格自动化规则没有触发怎么办A常见原因和解决方法规则未启用进入自动化页面检查规则的开关是否为开启状态筛选条件不匹配确认新增/修改的记录数据满足自动化规则的筛选条件消息发送权限不足确认Bot有发送消息到目标群聊的权限定时任务未到时间定时触发的规则只有在设定时间才会执行Q4TRAE Work自动化任务执行失败怎么调试A调试步骤在TRAE Work中查看任务的执行日志定位失败步骤常见失败原因API凭证过期、网络连接问题、参数格式错误可以先在飞书开放平台的API调试工具中手动调用API确认凭证是否有效检查Message模板中的变量值是否正确替换如果Gitee API调用失败确认Personal Access Token未过期且有正确的权限Q5Gitee Webhook推送后飞书群没收到消息怎么办A这是因为Gitee标准Webhook和飞书自定义机器人Webhook的数据格式不兼容。解决方法方法一通过TRAE Work创建一个Webhook接收任务接收Gitee的标准Webhook数据转换为飞书消息格式后发送方法二编写一个简单的中间服务如Cloudflare Worker接收Gitee Webhook并转发到飞书方法三在Gitee中配置邮件通知通过飞书的邮件集成实现通知较复杂Q6如何让Bot在群里自动回复消息A要实现Bot的自动回复需要在Bot应用中配置事件订阅im.message.receive_v1使用长连接方式编写一个服务程序Python/Node.js等通过飞书SDK监听消息事件当收到Bot的消息时解析消息内容根据内容生成回复调用消息发送API发送回复或者使用TRAE Work的事件驱动能力来处理消息事件最简单的方式是在TRAE Work中配置一个事件监听任务让TRAE Work的AI自动处理Bot的消息。附录附录A常用API参考API名称用途请求方式URL获取Tenant Access Token获取应用访问凭证POST/open-apis/auth/v3/tenant_access_token/internal发送消息以Bot身份发送消息到群聊或个人POST/open-apis/im/v1/messages?receive_id_typechat_id获取多维表格列表列出多维表格中的所有数据表GET/open-apis/bitable/v1/apps/{app_token}/tables获取记录列表读取数据表中的记录GET/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records新增记录向数据表中添加新记录POST/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records更新记录修改数据表中的记录PUT/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id}读取文档内容获取飞书文档的原始内容GET/open-apis/docx/v1/documents/{document_id}/raw_content获取知识库节点浏览知识库中的文档节点GET/open-apis/wiki/v2/spaces/get_nodeWebhook发送消息通过自定义机器人Webhook发送消息POST/open-apis/bot/v2/hook/{webhook_id}Gitee 获取PR列表获取仓库的Pull Request列表GEThttps://gitee.com/api/v5/repos/{owner}/{repo}/pulls提示所有飞书API的完整域名是https://open.feishu.cn。更多API详情请参考飞书开放平台官方文档https://open.feishu.cn/document。附录B快捷键速查快捷键功能适用场景Ctrl N新建文档/消息飞书全局Ctrl K快速搜索飞书全局Ctrl Shift M静音/取消静音飞书会议Ctrl /查看快捷键列表飞书全局Ctrl Enter发送消息飞书聊天Shift Enter消息中换行飞书聊天Ctrl B加粗飞书文档编辑Ctrl I斜体飞书文档编辑Ctrl E创建多维表格飞书全局Tab缩进飞书文档编辑Shift Tab取消缩进飞书文档编辑教程完成你已经完成了飞书AI-Native组织配置的全部5天课程。现在你拥有了一个完整的AI驱动组织运营体系包括标准化的群聊结构、知识库、多维表格、飞书Bot、自动化工作流和文档模板。记住AI-Native组织不是一蹴而就的。持续优化你的自动化规则、扩展新的工作流场景、让AI参与更多的业务环节你的组织将越来越高效。持续学习持续迭代让AI成为你最可靠的协作者。