跳到主要内容

摘要推送

最近更新 2026/10/02

功能简介​

备注

摘要推送用于在仪表盘查看态将当前仪表盘的摘要内容发送给指定接收人或机器人渠道。用户可以配置定时推送,也可以在需要时立即推送一次。

摘要推送支持:

  • 定时推送:按星期和整点时间周期性推送。
  • 立即推送:手动触发一次推送任务。
  • 多渠道推送:邮件、企业微信机器人、钉钉机器人、飞书机器人、Slack、自定义渠道。
  • 推送标题:支持自定义标题和标题占位符。
  • 权限控制:如果仪表盘中存在权限控制器,可为推送选择对应的权限控制取值。

入口​

  1. 进入仪表盘首页
  2. 点击顶部工具栏的更多操作。
  3. 选择「推送设置」。只有仪表盘中含有「总结摘要」页、且当前用户是该仪表盘的所有者或管理员时,才会出现「推送设置」。
  4. 右侧打开「摘要推送」抽屉。

页面结构​

摘要推送抽屉主要包含三块内容:

  • 摘要推送:展示当前仪表盘名称、定时推送开关和推送渠道。
  • 推送内容:配置推送标题。
  • 权限控制:当仪表盘内存在权限控制器时展示,用于选择本次推送使用的权限控制值。

底部操作包含:

  • 保存:保存当前推送配置。
  • 立即推送:立即创建一次推送任务。
  • 取消:关闭抽屉,不保存本次修改。

配置定时推送​

  1. 打开「定时推送」开关。

  2. 选择推送日期:

    • 可选择周一至周日中的任意一天或多天。
    • 默认可配置为全周推送。
  3. 选择推送时间:

    • 时间以整点为单位。
    • 可选范围为 00:00 至 23:00。
  4. 系统会在时间选择区域下方展示下一次预计推送时间。

  5. 补全推送渠道信息。

  6. 点击「保存」。

关闭「定时推送」后,页面会显示暂无定时推送计划。此时点击「保存」会保存为不启用定时推送的配置。

配置推送渠道​

至少需要一个有效渠道才能进行定时推送或立即推送。可用渠道以当前项目配置为准。

邮件​

  1. 在推送渠道中选择「邮件」。
  2. 选择收件人。
  3. 可搜索已有项目成员。
  4. 如项目支持 SMTP 配置,也可以手动添加邮箱地址。

注意:

  • 当前用户未绑定个人邮箱时,邮件选择框不可用,需要先绑定邮箱。
  • 收件人上限为 1000 个。
  • 手动输入邮箱时,需要填写有效邮箱地址。

企业微信机器人​

  1. 选择「企业微信机器人」。
  2. 填写企业微信机器人的 Webhook 地址。
  3. 可点击配置方法按钮查看企业微信机器人配置说明。

钉钉机器人​

  1. 选择「钉钉机器人」。
  2. 填写钉钉机器人的 Webhook 地址。
  3. 可点击配置方法按钮查看钉钉机器人配置说明。

飞书机器人​

  1. 选择「飞书机器人」。
  2. 填写飞书机器人的 Webhook 地址。
  3. 可点击配置方法按钮查看飞书机器人配置说明。

新增和删除渠道​

  • 点击「新增推送渠道」可以增加一个未使用的渠道。
  • 同一个渠道下可新增多个 Webhook 地址,最多 5 个。
  • 点击删除按钮可以删除某个 Webhook 地址;当该渠道只剩一个地址时,删除会移除整个渠道。

配置推送标题​

在「推送内容」中填写推送标题

  • 标题最多 80 个字符
  • 不填写时使用默认标题
  • 标题支持占位符,系统会在推送时替换为实际内容
  • 可通过标题旁的说明提示查看支持的占位符规则

配置权限控制​

当仪表盘内存在权限控制器,且权限控制器已配置可选值时,抽屉底部会显示「权限控制」区域。

使用方式:

  1. 找到对应权限控制器名称。
  2. 在下拉框中选择本次推送要使用的值。
  3. 支持多选。
  4. 保存后,后续定时推送会使用当前保存的权限控制值。

说明:

  • 如果之前已经保存过权限控制值,重新打开抽屉时会优先展示上次保存的值。
  • 如果没有保存过,则默认使用权限控制器当前配置中的可选值。
  • 没有权限控制器时,该区域不会展示。

立即推送​

立即推送用于手动发送一次摘要。

  1. 打开「摘要推送」抽屉
  2. 确认推送渠道信息完整
  3. 如有需要,调整推送标题和权限控制值
  4. 点击「立即推送」
  5. 推送任务创建成功后,页面提示推送说明,按钮短暂显示「推送中」
  6. Toast提示:仪表盘推送开始计算,你可以去任务列表查看进度

在「摘要推送」抽屉中确认推送渠道信息完整,如有需要,调整推送标题:

点击抽屉底部的「立即推送」:

注意:

  • 立即推送会校验渠道信息
  • 如果渠道信息缺失或 Webhook 配置有误,不会创建推送任务
  • 立即推送不会代替「保存」按钮保存定时推送配置;需要长期生效的配置仍需点击「保存」

保存配置​

点击「保存」后,系统会保存当前摘要推送配置。

保存内容包括:

  • 是否启用定时推送
  • 推送日期和推送时间
  • 推送渠道及对应配置
  • 推送标题
  • 权限控制取值

保存成功后,抽屉关闭并提示保存成功

常见提示​

渠道信息缺失校验​

出现该提示通常表示:

  • 推送渠道 邮件收件人不能为空
  • 推送渠道 Webhook 地址不能为空
  • 选择了某个渠道,但该渠道下没有有效配置

处理方式:补全对应渠道信息后再次保存或立即推送。

推送渠道有误​

出现该提示通常表示:

  • 某个 Webhook 地址为空。
  • 同一渠道下存在重复 Webhook 地址。

处理方式:检查并修改对应 Webhook 地址。

推送时间缺失​

出现该提示通常表示已开启定时推送,但没有选择推送日期或推送时间。

处理方式:选择至少一个星期日期,并选择一个推送整点时间。

邮箱重复​

手动添加邮箱时,如果邮箱已经存在,会提示邮箱重复。

处理方式:不要重复添加同一个邮箱。

有效的 email 地址​

手动添加邮箱格式不正确时会出现该提示。

处理方式:检查邮箱格式后重新输入。

飞书推送效果:​

邮件推送效果:​

提示

使用建议​

  • 定时推送前,先使用「立即推送」测试一次渠道是否可用。
  • 给机器人渠道配置多个 Webhook 时,建议使用清晰的渠道命名或备注在外部管理,避免重复配置。
  • 如果仪表盘使用权限控制,保存前确认权限控制取值是否符合目标接收人的查看范围。
  • 推送标题建议保留能识别仪表盘和日期的信息,便于接收人检索历史推送。
这篇文档对你有帮助吗?