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

入口
- 进入「设置」
- 打开「通知管理」

通知类型
点击「添加通知」后,可以选择:
| 类型 | 说明 |
|---|---|
| Webhook | 推送到飞书、钉钉或企业微信群机器人 |
| 邮箱 | 发送到当前组织下所有已绑定邮箱的成员 |
配置 Webhook
- 点击「添加通知」
- 填写通知名称,在下拉框中选择一个或多个通知事件
- 为所选事件统一选择「全部结果」或「仅失败或异常」
- 选择 Webhook、平台类型(飞书 / 钉钉 / 企业微信),填写 Webhook URL
- 按需填写备注,便于在发送记录中识别接收目标
- 保存
配置邮箱通知
- 点击「添加通知」
- 填写通知名称,在下拉框中选择一个或多个通知事件及统一发送条件
- 选择邮箱
- 保存
邮箱通知会发送给当前组织下所有已绑定邮箱的成员。后续版本可扩展为选择指定成员。
通知事件
一条通知配置可以同时选择多个事件,所选事件共用一个发送条件。未选择的事件不会发送到该目标。编辑早期配置时,如果所选事件的条件不同,需重新选择统一条件后才能保存。
| 事件 | 触发范围 |
|---|---|
| 单条用例执行 | 独立运行一条用例后的结果 |
| 批量用例执行 | 一次批量执行的汇总结果,不按每条用例重复发送 |
| 执行计划 | 非定时的执行计划结果,不按计划中的用例重复发送 |
| 定时任务 | 运行计划或指定用例的定时任务结果;未触发、超时等异常也可通知 |
「仅失败或异常」包含用例失败、运行失败、超时和定时任务未触发;主动取消不算失败或异常。一个项目可以添加多条通知配置,分别选择事件与接收目标。已有配置会保留执行计划通知,同时订阅定时任务结果;单条和批量用例需要按需勾选。
启用单条和批量用例通知前,请更新到包含 Run ID 上报能力的扩展包,以便准确识别批量和计划内的子用例,避免重复通知。
查看发送记录
在「通知管理」切换到「发送记录」,可按通知、事件、发送状态和发送日期范围筛选;也可在某条通知上点击「发送记录」直接查看它的记录。记录按当前项目分页,每页 20 条。列表依次展示事件 / 执行目标、通知 / 发送方式、发送时间、执行结果与发送状态。邮件通知展示实际发送时解析出的收件邮箱,Webhook 通知展示平台类型和配置备注;详情可查看完整收件邮箱、尝试次数、失败或跳过原因,并打开对应执行结果。邮件服务器只接受部分收件人时,记录标记为「部分发送」,并列出已接受和被拒收的邮箱;为避免已接受者收到重复邮件,该次发送不会整体重试。历史记录若未保存收件邮箱,会明确提示,不能从当前组织成员信息推断当时的收件人。
「发送时间」在全部或部分发送成功时取完成时间,在发送失败或等待重试时取最近一次失败的时间。尚未发送、正在发送或已跳过的记录没有发送时间;设置发送日期范围后,这些记录不会出现在结果中。早期失败记录未保存失败完成时间时,可能显示最近一次发送尝试的开始时间。
「已发送」表示邮件服务器接受所有收件人或 Webhook 返回成功的 HTTP 状态,不代表收件人已经阅读。「部分发送」表示邮件服务器只接受部分收件人。发送失败会自动重试,重试结束后仍失败才显示「发送失败」。未选择的事件不会产生发送记录,「测试连接」也不会产生执行通知记录。删除通知配置会同时删除它的发送记录。
邮箱通知需要后端配置 SMTP。未配置时,发送记录会显示「邮件服务尚未配置」并在重试后标记为发送失败;本地开发环境也不会将仅打印到控制台的模拟邮件标为「已发送」。
邮件和 Webhook 中的「查看结果」链接使用后端的 PUBLIC_APP_URL(未配置时使用 APP_BASE_URL)。该地址需要指向同一套 CueCast 数据,并可从收件人的设备访问;本地配置为 localhost 时,只能在运行前端的电脑上打开。用其他浏览器打开链接,登录后会返回原结果页。批量执行通知会定位到「计划与批量」中的对应批次。
获取各平台的 Webhook URL
飞书
- 打开飞书客户端,进入目标群聊
- 点击右上角
...→ 设置 → 群机器人 - 点击 添加机器人 → 自定义机器人
- 填写机器人名称(如「回演 CueCast」)
- 复制 Webhook URL
安全设置
当前支持无安全设置的自定义机器人。如果群聊开启了安全设置(签名校验),需要在 CueCast 后续版本中配置对应的签名密钥。
钉钉
- 打开钉钉客户端,进入目标群聊
- 点击右上角
...→ 群设置 → 智能群助手 - 点击 添加机器人 → 自定义(通过 Webhook 接入)
- 填写机器人名称,完成安全设置
- 复制 Webhook URL
安全设置
钉钉支持三种安全方式,当前仅支持 自定义关键词 模式。请在安全设置中添加关键词 回演 CueCast。
企业微信
- 打开企业微信客户端,进入目标群聊
- 点击右上角
...→ 群机器人 - 点击 添加机器人
- 填写机器人名称
- 复制 Webhook URL
启用 / 禁用 / 删除
在通知管理页中可以:
- 点击「编辑」调整名称、通知事件和发送条件,也可更换 Webhook URL
- 点击状态按钮启用 / 禁用状态
- 点击删除按钮删除通知
消息内容
执行结束或定时任务未触发后,通知消息包含:
| 字段 | 说明 |
|---|---|
| 项目信息 | 执行所属项目 |
| 执行目标 | 用例、批次、计划或定时任务名称 |
| 执行状态 | 通过、失败、已取消、超时或未触发 |
| 通过率 | 有执行结果时展示通过用例数 / 总用例数 |
| 耗时 | 有执行耗时时展示 |
| 时间 | 执行完成时间(东八区) |
| 失败用例 | 最多展示前 5 条失败用例,含分组、错误信息 |
| 查看结果 | 配置公开应用地址后可直接打开报告或调度记录 |
注意事项
- Webhook URL 经 AES-256-GCM 加密存储,保存后仅展示首尾字符脱敏预览
- 消息发送为异步处理,不阻塞执行结果保存和页面刷新
- 单个项目支持配置多个通知
- 消息发送超时时间为 20 秒;失败后最多重试两次,不影响执行结果保存
