manuallatest产品手册 / 看板推送-飞书自建应用机器人推送配置说明
看板推送-飞书自建应用机器人推送配置说明
在进行看板立即推送或看板定时推送时,如果选择使用飞书机器人推送,需要提供一个支持上传图片的飞书应用,并提供应用相关信息:
i)企业自建应用App ID
ii)企业自建应用App Secret
以及一个用于推送的机器人,并提供:
iii) 推送机器人Webhook地址
为获取以上 i)APP ID和 ii)APP Secret 的信息,需联系公司飞书管理员或前往飞书开发后台获取应用详情,如暂无支持推送的相关应用,需创建企业自建应用,请先与管理员确认是否有相关权限。如果已有相关应用信息,可在获取APP ID和APP Secret 后直接进行步骤二。
步骤一、创建应用
流程参考下文,预计需要10-15分钟。
第一步:创建企业自建应用
(预计需要3分钟)
- 从飞书工作台或点击链接https://open.feishu.cn/app/并登录飞书后,进入飞书开放平台。选择「创建企业自建应用」。
- 为自建应用命名。建议以“ThinkingAI 推送”作为应用名称;“ThinkingAI AE 系统的推送消息,支持图片、文字、链接等形式。”作为应用描述;建议使用下图数数科技logo作为应用图标。点击「确认创建」完成创建。
界面预览:
第二步:开启机器人推送
(预计需要5分钟)
- 在「添加应用能力」中添加「机器人」,并进入配置。
- 开启图片推送权限。日报默认会推送看板图片,需开启相关权限以确保日报正常推送。在权限管理-API权限中,搜索名称为“im:resource”的权限,勾选该权限后点击“确认开通”。
第三步:发布应用
(预计需要5-10分钟,需企业管理员响应)
- 在「应用发布」中找到「版本管理与发布」,并创建版本
- 发布应用时,应赋予相应的应用版本号便于管理,选择“创建版本”后填入必要信息。
建议将“1.0.0”作为应用版本号;“支持看板图文与链接推送”作为更新说明。
- 该应用发布后默认仅创建者可使用,可按需调整为“所有员工”。确认了应用的能力和权限后,点击「保存」,并申请发布
- 待企业管理员审核成功之后,应用状态将由“待上线”变更为“已启用”,自建应用的当前版本就发布成功了。
变为:
第四步:获取App ID与App Secret
(预计需要2分钟)
- 进入应用详情,从菜单中进入“凭证与基础信息”页面,找到“应用凭证”。
- 复制App ID,填入推送设置中。App ID不会发生变化。
- 点击显示App Secret,复制填入推送设置中。
多个看板推送任务可共用App ID和App Secret信息,无需重复创建应用。
步骤二、使用自定义机器人进行推送
下列步骤为设置自定义机器人的可用流程之一,其他配置方式请参考飞书官方文档:Webhook地址的获取流程。
第一步:在群组中添加自定义机器人
飞书支持在“群聊”或“话题群”中添加自定义机器人。
- 【可选】创建话题群:在飞书“+”添加中,选择“创建群组”。
- 在群组【设置】中添加【群机器人】,选择【自定义机器人】
第二步:机器人推送设置
- 获取Webhook地址
- 复制该webhook地址,并填入看板推送设置
- 【可选】自定义机器人安全设置。为避免无关推送使用本webhook地址,可以设置“关键词”。设置关键词后,日报推送的文字内容中必须含有该关键词,才能成功推送。可在看板推送-【推送正文】中编辑推送的文字内容。
飞书应用与机器人配置完成,后续请注意
- 如需对应用进行其他开发,可参考飞书应用开发流程与工具介绍。
- 以上流程创建的企业自建应用支持推送多个看板,无需重复创建应用,多个看板推送任务可共用App ID和App Secret信息。
- 请勿频繁重置App Secret。重置App Secret将导致 AE 系统无法获得app_access_token,已有的推送规则会失效。如果已经重置了App Secret,需手动在AE 系统的看板推送规则下填入新的App Secret。
这篇文档对你有帮助吗?

