跳转到主要内容

一、创建并配置应用

  1. 创建企业自建应用
    • 登录飞书开发者后台
    • 点击”创建企业自建应用”,填写应用名称”MyCoder”及描述,完成创建
  2. 添加机器人能力
    • 在应用详情页的应用能力 > 添加应用能力中,找到机器人卡片并点击添加
    • 参考机器人能力文档完成基础配置
  3. 申请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 (获取通讯录用户基本信息)
  4. 订阅接收消息事件
    • 事件与回调 > 事件配置页面:
      • 选择将事件发送至 开发者服务器(暂仅支持此方式)填写创建应用时的 Webhook Url
      • 添加接收消息事件im.message.receive_v1
    • 事件与回调 > 回调配置页面,填写创建应用时的 Webhook Url
      • 启用订阅方式:将回调发送至 开发者服务器
      • 添加回调 卡片回传交互(card.action.trigger)

二、发布应用

  1. 配置可用范围
    • 应用发布 > 版本管理与发布页面创建版本
    • 设置应用可用范围(如指定部门或全员可见),参考配置应用可用范围
  2. 发布上线
    • 提交版本审核,等待企业管理员审批通过
    • 测试环境可使用测试企业功能免审核发布

三、配置通知用户

当任务在后端自动运行时如果有需要通知用户的情况,可以在集成提供商页面编辑通知用户,选择需要通知的用户后保存即可。 将所使用的飞书集成设为激活,并配置通知用户 当系统需要通知用户消息时,飞书集成会自动发送消息通知用户。然后用户便可以在通知消息后回复消息,飞书集成会将用户的回复消息发送到后端,后端可以根据用户的回复消息进行相应的处理。

三、测试机器人

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

关键文档参考

通过以上步骤,即可搭建一个能够自动接收通知消息的机器人应用。