Skip to content

通知管理 ​

CueCast 可以按执行事件将结果推送到飞书、钉钉、企业微信群聊,或发送邮件给当前组织下已绑定邮箱的成员。通知规则统一在当前项目的「通知管理」中设置。

img.png

入口 ​

  1. 进入「设置」
  2. 打开「通知管理」

img_3.png

通知类型 ​

点击「添加通知」后,可以选择:

类型说明
Webhook推送到飞书、钉钉或企业微信群机器人
邮箱发送到当前组织下所有已绑定邮箱的成员

配置 Webhook ​

  1. 点击「添加通知」
  2. 填写通知名称,在下拉框中选择一个或多个通知事件
  3. 为所选事件统一选择「全部结果」或「仅失败或异常」
  4. 选择 Webhook、平台类型(飞书 / 钉钉 / 企业微信),填写 Webhook URL
  5. 按需填写备注,便于在发送记录中识别接收目标
  6. 保存

配置邮箱通知 ​

  1. 点击「添加通知」
  2. 填写通知名称,在下拉框中选择一个或多个通知事件及统一发送条件
  3. 选择邮箱
  4. 保存

邮箱通知会发送给当前组织下所有已绑定邮箱的成员。后续版本可扩展为选择指定成员。

通知事件 ​

一条通知配置可以同时选择多个事件,所选事件共用一个发送条件。未选择的事件不会发送到该目标。编辑早期配置时,如果所选事件的条件不同,需重新选择统一条件后才能保存。

事件触发范围
单条用例执行独立运行一条用例后的结果
批量用例执行一次批量执行的汇总结果,不按每条用例重复发送
执行计划非定时的执行计划结果,不按计划中的用例重复发送
定时任务运行计划或指定用例的定时任务结果;未触发、超时等异常也可通知

「仅失败或异常」包含用例失败、运行失败、超时和定时任务未触发;主动取消不算失败或异常。一个项目可以添加多条通知配置,分别选择事件与接收目标。已有配置会保留执行计划通知,同时订阅定时任务结果;单条和批量用例需要按需勾选。

启用单条和批量用例通知前,请更新到包含 Run ID 上报能力的扩展包,以便准确识别批量和计划内的子用例,避免重复通知。

查看发送记录 ​

在「通知管理」切换到「发送记录」,可按通知、事件、发送状态和发送日期范围筛选;也可在某条通知上点击「发送记录」直接查看它的记录。记录按当前项目分页,每页 20 条。列表依次展示事件 / 执行目标、通知 / 发送方式、发送时间、执行结果与发送状态。邮件通知展示实际发送时解析出的收件邮箱,Webhook 通知展示平台类型和配置备注;详情可查看完整收件邮箱、尝试次数、失败或跳过原因,并打开对应执行结果。邮件服务器只接受部分收件人时,记录标记为「部分发送」,并列出已接受和被拒收的邮箱;为避免已接受者收到重复邮件,该次发送不会整体重试。历史记录若未保存收件邮箱,会明确提示,不能从当前组织成员信息推断当时的收件人。

「发送时间」在全部或部分发送成功时取完成时间,在发送失败或等待重试时取最近一次失败的时间。尚未发送、正在发送或已跳过的记录没有发送时间;设置发送日期范围后,这些记录不会出现在结果中。早期失败记录未保存失败完成时间时,可能显示最近一次发送尝试的开始时间。

「已发送」表示邮件服务器接受所有收件人或 Webhook 返回成功的 HTTP 状态,不代表收件人已经阅读。「部分发送」表示邮件服务器只接受部分收件人。发送失败会自动重试,重试结束后仍失败才显示「发送失败」。未选择的事件不会产生发送记录,「测试连接」也不会产生执行通知记录。删除通知配置会同时删除它的发送记录。

邮箱通知需要后端配置 SMTP。未配置时,发送记录会显示「邮件服务尚未配置」并在重试后标记为发送失败;本地开发环境也不会将仅打印到控制台的模拟邮件标为「已发送」。

邮件和 Webhook 中的「查看结果」链接使用后端的 PUBLIC_APP_URL(未配置时使用 APP_BASE_URL)。该地址需要指向同一套 CueCast 数据,并可从收件人的设备访问;本地配置为 localhost 时,只能在运行前端的电脑上打开。用其他浏览器打开链接,登录后会返回原结果页。批量执行通知会定位到「计划与批量」中的对应批次。

获取各平台的 Webhook URL ​

飞书 ​

  1. 打开飞书客户端,进入目标群聊
  2. 点击右上角 ... → 设置 → 群机器人
  3. 点击 添加机器人 → 自定义机器人
  4. 填写机器人名称(如「回演 CueCast」)
  5. 复制 Webhook URL

安全设置

当前支持无安全设置的自定义机器人。如果群聊开启了安全设置(签名校验),需要在 CueCast 后续版本中配置对应的签名密钥。

钉钉 ​

  1. 打开钉钉客户端,进入目标群聊
  2. 点击右上角 ... → 群设置 → 智能群助手
  3. 点击 添加机器人 → 自定义(通过 Webhook 接入)
  4. 填写机器人名称,完成安全设置
  5. 复制 Webhook URL

安全设置

钉钉支持三种安全方式,当前仅支持 自定义关键词 模式。请在安全设置中添加关键词 回演 CueCast。

企业微信 ​

  1. 打开企业微信客户端,进入目标群聊
  2. 点击右上角 ... → 群机器人
  3. 点击 添加机器人
  4. 填写机器人名称
  5. 复制 Webhook URL

启用 / 禁用 / 删除 ​

在通知管理页中可以:

  • 点击「编辑」调整名称、通知事件和发送条件,也可更换 Webhook URL
  • 点击状态按钮启用 / 禁用状态
  • 点击删除按钮删除通知

消息内容 ​

执行结束或定时任务未触发后,通知消息包含:

字段说明
项目信息执行所属项目
执行目标用例、批次、计划或定时任务名称
执行状态通过、失败、已取消、超时或未触发
通过率有执行结果时展示通过用例数 / 总用例数
耗时有执行耗时时展示
时间执行完成时间(东八区)
失败用例最多展示前 5 条失败用例,含分组、错误信息
查看结果配置公开应用地址后可直接打开报告或调度记录

注意事项 ​

  • Webhook URL 经 AES-256-GCM 加密存储,保存后仅展示首尾字符脱敏预览
  • 消息发送为异步处理,不阻塞执行结果保存和页面刷新
  • 单个项目支持配置多个通知
  • 消息发送超时时间为 20 秒;失败后最多重试两次,不影响执行结果保存

回演 CueCast 产品文档