一、创建并配置应用
-
创建企业自建应用
- 登录飞书开发者后台
- 点击”创建企业自建应用”,填写应用名称”MyCoder”及描述,完成创建
-
添加机器人能力
- 在应用详情页的应用能力 > 添加应用能力中,找到机器人卡片并点击添加
- 参考机器人能力文档完成基础配置
-
申请API权限
- 在开发配置 > 权限管理页面,为应用开通以下权限:
im:message.p2p_msg:readonly(读取用户发给机器人的单聊消息)im:message.group_at_msg:readonly(接收群聊中@机器人消息事件)im:message:send_as_bot(以应用身份发送消息)contact:contact.base:readonly(获取通讯录基本信息)contact:user.base:readonly(获取通讯录用户基本信息)
- 在开发配置 > 权限管理页面,为应用开通以下权限:
-
订阅接收消息事件
- 在事件与回调 > 事件配置页面:
- 选择将事件发送至 开发者服务器(暂仅支持此方式)填写创建应用时的
Webhook Url
- 添加接收消息事件(
im.message.receive_v1)
- 选择将事件发送至 开发者服务器(暂仅支持此方式)填写创建应用时的
- 在事件与回调 > 回调配置页面,填写创建应用时的
Webhook Url- 启用订阅方式:将回调发送至 开发者服务器
- 添加回调 卡片回传交互(
card.action.trigger)
- 在事件与回调 > 事件配置页面:
二、发布应用
-
配置可用范围
- 在应用发布 > 版本管理与发布页面创建版本
- 设置应用可用范围(如指定部门或全员可见),参考配置应用可用范围
-
发布上线
- 提交版本审核,等待企业管理员审批通过
- 测试环境可使用测试企业功能免审核发布
三、配置通知用户
当任务在后端自动运行时如果有需要通知用户的情况,可以在集成提供商页面编辑通知用户,选择需要通知的用户后保存即可。

三、测试机器人
-
添加机器人到群聊
- 在飞书客户端群设置中搜索”MyCoder”机器人并添加
-
运行编码任务或审查任务
- 触发后端自动运行的编码任务或审查任务,确保飞书集成能够发送通知消息给用户
-
回复通知消息
- 单聊:直接向机器人发来的通知消息回复
- 群聊:@机器人并发送消息,验证回复功能