mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 02:45:58 +00:00
48 lines
2.0 KiB
Markdown
48 lines
2.0 KiB
Markdown
---
|
||
id: approve.notify.concept
|
||
title: 审批通知与「审批助手」机器人
|
||
type: concept
|
||
feature: approve
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- 审批机器人
|
||
- 审批通知
|
||
- 审批助手
|
||
- approval-alert
|
||
- 怎么收到审批提醒
|
||
- 审批卡片
|
||
related_tools: []
|
||
related_pages: [application, messenger]
|
||
prerequisites:
|
||
- 应用市场已安装 approve 插件
|
||
- 当前账号未屏蔽「审批助手」机器人会话
|
||
negative:
|
||
- 不支持改成第三方 webhook 推送
|
||
- 不支持邮件 / 短信 / APP 推送渠道（只发应用内聊天）
|
||
- 不支持自定义模板文案
|
||
- 机器人不能被「@」也不能直接对话指令
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 审批通知与「审批助手」机器人
|
||
|
||
## 定义
|
||
审批的所有通知都通过系统机器人「审批助手」（userid `approval-alert`）的 1 对 1 私聊推送，消息类型 `template`（卡片）。卡片含标题、关键字段、缩略图（请假类带图片时），底部「查看详情」跳进审批详情。
|
||
|
||
## 何时发卡片
|
||
后端 `approveMsg()` 按 `type` 投递：
|
||
|
||
| type | 触发 | 收件人 | 标题样例 |
|
||
|---|---|---|---|
|
||
| `approve_reviewer` | 到我作审批人节点 | 待审批人 | {发起人} 提交的「{模板}」待你审批 |
|
||
| `approve_notifier` | 到我所在 notifier 节点 | 抄送人 | 抄送 {发起人} 提交的「{模板}」记录 |
|
||
| `approve_comment_notifier` | 我参与的审批被加全文评论 | 其他相关方 | {评论人} 评论了 {发起人} 的「{模板}」审批 |
|
||
| `approve_submitter` | 我发起的被通过/拒绝 | 发起人 | 您发起的「{模板}」已通过 / 被 {审批人} 拒绝 |
|
||
|
||
## 卡片更新机制
|
||
审批人同意/拒绝、发起人撤销时不发新卡，而用 `msg_id` 反查原卡片调 `change-{msg_id}` 原地更新（绿-通过/红-拒绝/灰-撤回），避免聊天里堆几十条。
|
||
|
||
## 未读徽标
|
||
`approve_reviewer` 推送时附带 WebSocket 事件 `approve/unread`，「审批」入口和 Tab「待办」名后的数字立即 +1，处理后 -1。数量接口 `approve/process/doto`。
|