4.8 KiB
4.8 KiB
由壹点通知消息规范
统一机器人已经说明“由壹点发出的”，每条消息不再重复品牌名。项目名称解决“消息来自哪里”，业务标题、时间和首屏内容解决“发生了什么、用户现在要做什么”。所有接入项目必须遵守本规范。
1. 标题规则
最终标题由通知中心统一拼接：
【项目名称】业务标题
例如：
【固定资产】资产报废待审批【素材库】新的考核调研待填写【产品开发】任务即将到期
业务项目只提交业务标题，例如：
新的考核调研待填写资产报废待审批产品任务即将到期
通知中心根据 projectCode 生成 【项目名称】，业务项目不能自行拼接。禁止：
- 自己添加
【项目名称】、机器人名称或其它来源前缀。 - 使用“通知”“消息提醒”“统一消息测试”等无法表达任务的空泛标题。
- 在标题中堆积人员、日期、编号等详细字段。
- 使用多个 emoji 或连续感叹号制造紧迫感。
2. 内容结构
通知中心会把卡片正文首行统一生成为：
### 【项目名称】业务标题
业务项目不要再提交自己的 Markdown 首行标题。为兼容旧项目，通知中心只会移除正文开头已有的三级 Markdown 标题（###），再生成统一首行；其它级别标题按正文原样保留。
消息第一屏按以下顺序组织：
- 项目名称和业务主题，由通知中心统一生成。
- 申请时间、处理时间或截止时间。
- 最重要的业务对象和相关人员。
- 原因、结果或异常说明。
- 一句必要的行动提示。
业务项目推荐提交：
**截止时间：** 2026年7月31日 18:00
**调研：** 2026年7月 · 跨部门协同
**评价对象：** 无邪
> 请在截止时间前完成评分。
通知中心最终渲染为：
### 【素材库】新的考核调研待填写
**截止时间：** 2026年7月31日 18:00
**调研：** 2026年7月 · 跨部门协同
**评价对象：** 无邪
> 请在截止时间前完成评分。
每个字段之间必须保留一个空行。不要只使用单换行；钉钉会把连续字段合并成一段，明显降低阅读性。
不要写成一整段：
你有一份新的考核调研需要填写。调研：2026年7月……对象……截止……
3. 状态用语
优先使用用户可以立即理解的动作词：
| 场景 | 推荐状态 |
|---|---|
| 需要填写 | 待你填写 |
| 需要审批 | 待你审批 |
| 任务完成 | 处理完成 |
| 操作失败 | 处理失败 |
| 即将到期 | 即将到期 |
| 仅告知 | 结果已更新 |
不要使用仅开发人员能理解的内部状态码，例如 pending、processed、job failed。
4. 按钮规则
按钮必须描述点击后的动作：
立即填写立即审批查看结果查看任务处理异常
避免使用没有方向的“点击这里”“打开系统”“查看详情”，除非确实无法给出更具体的动作。
每条通知只保留一个主要按钮。通知不是业务页面，不在消息中堆叠多个操作入口。
5. 信息取舍
消息中只放帮助用户判断和行动的信息：
- 保留：业务对象、发起人、截止时间、核心结果、失败原因。
- 省略：数据库 ID、内部状态码、部署版本、调试说明、完整操作日志。
- 禁止：项目密钥、访问令牌、身份证号、完整手机号、敏感人事信息和无需展示的内部备注。
如果内容较长，消息只展示摘要，完整信息通过白名单内的业务页面查看。
6. 时间和名称
- 面向中国员工统一使用北京时间。
- 用户可见时间推荐
2026年7月31日 18:00，不要显示秒和时区偏移。 - 人员名称使用公司花名或业务系统已确认的展示名，但投递对象必须使用钉钉
userId。 - 不在消息里用邮箱、手机号或内部 ID 代替人员名称。
7. 示例
考核调研
标题：新的考核调研待填写
内容：
**截止时间：** 2026年7月31日 18:00
**调研：** 2026年7月 · 工作配合度
**评价对象：** 无邪
> 请在截止时间前完成评分。
按钮：立即填写
最终显示标题：【素材库】新的考核调研待填写
最终卡片首行：### 【素材库】新的考核调研待填写
固定资产
标题：资产报废待审批
内容：
**申请时间：** 2026年7月16日 14:30
**资产：** 摄影灯 A-102
**申请人：** 无邪
**报废原因：** 设备损坏，无法继续维修
> 请核对资产及配件明细后处理。
按钮：立即审批
最终显示标题：【固定资产】资产报废待审批
最终卡片首行：### 【固定资产】资产报废待审批