跳到主要内容

看板推送-飞书自建应用机器人推送配置说明

最近更新 2026/10/05

在进行看板立即推送或看板定时推送时,如果选择使用飞书机器人推送,需要提供一个支持上传图片的飞书应用,并提供应用相关信息:

i)企业自建应用App ID

ii)企业自建应用App Secret

以及一个用于推送的机器人,并提供:

iii) 推送机器人Webhook地址

为获取以上 i)APP ID和 ii)APP Secret 的信息,需联系公司飞书管理员或前往飞书开发后台获取应用详情,如暂无支持推送的相关应用,需创建企业自建应用,请先与管理员确认是否有相关权限。如果已有相关应用信息,可在获取APP ID和APP Secret 后直接进行步骤二。

步骤一、创建应用​

流程参考下文,预计需要10-15分钟。

第一步:创建企业自建应用​

(预计需要3分钟)

  1. 从飞书工作台或点击链接https://open.feishu.cn/app/并登录飞书后,进入飞书开放平台。选择「创建企业自建应用」。
  1. 为自建应用命名。建议以“ThinkingAI 推送”作为应用名称;“ThinkingAI AE 系统的推送消息,支持图片、文字、链接等形式。”作为应用描述;建议使用下图数数科技logo作为应用图标。点击「确认创建」完成创建。

界面预览:

第二步:开启机器人推送​

(预计需要5分钟)

  1. 在「添加应用能力」中添加「机器人」,并进入配置。
  1. 开启图片推送权限。日报默认会推送看板图片,需开启相关权限以确保日报正常推送。在权限管理-API权限中,搜索名称为“im:resource”的权限,勾选该权限后点击“确认开通”。

第三步:发布应用​

(预计需要5-10分钟,需企业管理员响应)

  1. 在「应用发布」中找到「版本管理与发布」,并创建版本
  1. 发布应用时,应赋予相应的应用版本号便于管理,选择“创建版本”后填入必要信息。

建议将“1.0.0”作为应用版本号;“支持看板图文与链接推送”作为更新说明。

  1. 该应用发布后默认仅创建者可使用,可按需调整为“所有员工”。确认了应用的能力和权限后,点击「保存」,并申请发布
  1. 待企业管理员审核成功之后,应用状态将由“待上线”变更为“已启用”,自建应用的当前版本就发布成功了。

变为:

第四步:获取App ID与App Secret​

(预计需要2分钟)

  1. 进入应用详情,从菜单中进入“凭证与基础信息”页面,找到“应用凭证”。
  2. 复制App ID,填入推送设置中。App ID不会发生变化。
  3. 点击显示App Secret,复制填入推送设置中。

多个看板推送任务可共用App ID和App Secret信息,无需重复创建应用。

步骤二、使用自定义机器人进行推送​

下列步骤为设置自定义机器人的可用流程之一,其他配置方式请参考飞书官方文档:Webhook地址的获取流程。

第一步:在群组中添加自定义机器人​

飞书支持在“群聊”或“话题群”中添加自定义机器人。

  1. 【可选】创建话题群:在飞书“+”添加中,选择“创建群组”。
  1. 在群组【设置】中添加【群机器人】,选择【自定义机器人】

第二步:机器人推送设置​

  1. 获取Webhook地址
  1. 复制该webhook地址,并填入看板推送设置
  1. 【可选】自定义机器人安全设置。为避免无关推送使用本webhook地址,可以设置“关键词”。设置关键词后,日报推送的文字内容中必须含有该关键词,才能成功推送。可在看板推送-【推送正文】中编辑推送的文字内容。

飞书应用与机器人配置完成,后续请注意​

  1. 如需对应用进行其他开发,可参考飞书应用开发流程与工具介绍。
  2. 以上流程创建的企业自建应用支持推送多个看板,无需重复创建应用,多个看板推送任务可共用App ID和App Secret信息。
  3. 请勿频繁重置App Secret。重置App Secret将导致 AE 系统无法获得app_access_token,已有的推送规则会失效。如果已经重置了App Secret,需手动在AE 系统的看板推送规则下填入新的App Secret。
这篇文档对你有帮助吗?