Skip to content

通知模板 ​

模板决定变化通知的 标题与正文 格式。系统按任务类型与触发规则提供 内置模板,也可创建 自定义模板,支持 Mustache 变量与条件块。客户端入口:「我的」→ 通知模板,点击「管理模板」进行配置。

功能说明 ​

能力说明
内置模板按任务类型 + 规则类型自动匹配,创建任务时不选模板即生效
自定义模板可把内置模板「复制为我的」再改,或从零新建
变量替换如 taskName、url、diff、statusCode 等
条件块如 {{#if hasDiff}} … {{/if}},控制段落是否输出

操作步骤 ​

  1. 查看通知模板概览 ​

    在 「我的」 页面可看到内置模板数量与「我的模板」数量;尚无自定义模板时会提示通过「管理模板」克隆或新建。

    我的页面通知模板区域
  2. 管理模板:复制内置或新建 ​

    点击 「管理模板」 打开弹窗,浏览内置列表与变量说明;选中一个内置模板后点 「复制为我的」 即可在它的基础上改,也可以直接 新建,并指定适用的任务类型与规则类型。

    通知模板管理弹窗

可用变量 ​

在正文中用 Mustache 双花括号包裹变量名,例如 taskName 写作 {{taskName}}。模板编辑器里带有分类工具栏和补全,下面是完整清单。

所有任务类型通用 ​

变量说明
taskName任务名称
taskTypeLabel任务类型(中文)
url监控网址
detectedAt检测时间,格式 yyyy-MM-dd HH:mm:ss
triggeredRules触发的规则
ruleCount触发规则数
ruleDetail触发规则详情(首条)
ruleDetails触发规则详情(全部)
matchedValue规则匹配到的值
changeSummary变化摘要(兜底文案)
hasDiff本次是否有 diff,常用于条件块

变化内容 ​

变量适用类型说明
diff网站 / HTTP / RSS / 邮件差异详情,按渠道渲染成对应格式
diffUrl网站 / HTTP / RSS / 邮件完整差异详情页链接
elementContents网站全部监控元素内容
elementContentN网站第 N 个元素的内容,如 {{elementContent1}}
elementLabelN网站第 N 个元素的备注名
changedN网站第 N 个元素本次是否变化
oldValueN / newValueN网站第 N 个元素变化前 / 后的值

类型专属 ​

变量适用类型说明
statusCodeHTTPHTTP 状态码
responseBodyHTTP响应体,最长约 5 万字符
elapsedMsHTTP / Ping / 网站 / 脚本响应耗时(毫秒)
exitCode / scriptOutput / errorMessage脚本退出码 / 标准输出 / 错误信息
daysRemaining / expiryDate域名 / 证书剩余天数 / 到期日期
registrar域名注册商
issuer证书证书颁发者
avgLatencyMs / maxLatencyMsPing平均 / 最大延迟(毫秒)
packetLoss / reachablePing丢包率(%)/ 是否可达
rssContents / rssFieldContentsRSS完整响应内容 / 监控字段内容
newEmailCount邮件新邮件数量
emailSubject / emailFrom邮件首封新邮件的标题 / 发件人

全局变量 ​

你在「全局变量」里定义的变量用 {{global.变量名}} 引用,与内置变量互不冲突。详见 全局变量。

条件块与比较 ​

除了直接取值,模板还支持条件块:

text
{{#if hasDiff}}
本次变化:{{diff}}
{{else}}
本次未检出内容变化
{{/if}}
  • 支持 {{#if}} / {{else}} / {{/if}}
  • 条件里可以写比较表达式,如 {{#if daysRemaining <= 7}}
  • {{!-- 注释 --}} 不会输出到最终内容

在任务中选用 ​

创建或编辑任务、开启通知后,在 「通知模板」 下拉框选择自定义模板;不选则自动匹配内置模板。

删除自定义模板时,系统会自动把引用它的任务改回使用内置模板,不需要你逐个任务去改。

使用提示 ​

  • 变量是否可用取决于任务类型,用了不适用的变量会渲染成空
  • 各渠道有长度限制(例如企业微信纯文本约 2048 字节),重要信息建议放在标题或正文开头