# 通知与推送

跟完这篇，你的手机会在门口有人时响一声，事件也能发到你已经在用的钉钉 / 企业微信 / 飞书群里；你还能自己决定哪些事该响、哪些事只记录、几点之后不要吵。最后一节是「有事件但没收到通知」的排查顺序，照着查一般三步内能定位。

> **ℹ️ 开始之前**
>
> 已经添加至少一台摄像头，并且在「事件中心」里看得到事件。手机上装好云瞰 App（iPhone 与安卓都支持）。推送本身不需要 Pro 授权，能推哪些事件取决于你开启了哪些检测能力。

## 一、让手机收到第一条推送

云瞰安装完成时已经建好了一组默认通知规则——目标检测、进入区域、离开区域、跌倒、婴儿哭声、手势识别、人脸识别、包裹到达与包裹被取走，各一条。你不需要先去写规则，要做的只是把手机和账号绑上。

1. **用你的账号登录 App**

   **去哪里**：手机上打开云瞰 App。
   **做什么**：填服务器地址，用网页后台的同一套账号密码登录，登录后停留几秒。
   **怎么算成功**：网页后台 → 平台配置 → 我的账号 → 我的设备，列表里出现这台手机，「最近在线」显示的是刚刚。

2. **允许系统通知**

   **去哪里**：手机的系统设置 → 应用 → 云瞰 → 通知。
   **做什么**：确认通知开关是开的，允许横幅与声音。
   **怎么算成功**：系统设置里云瞰的通知状态是「允许」。

3. **发一条测试推送**

   **去哪里**：网页后台 → 平台配置 → 用户管理，点开你自己这个账号。
   **做什么**：点「发送测试推送」。
   **怎么算成功**：页面提示「已发送测试推送到 N 台设备」，手机弹出一条带「测试」字样的通知。

> **💡 测试推送为什么一定收得到**
>
> 测试推送会绕过免打扰时段和临时静音，它只验证一件事：手机与服务器之间的推送通道通不通。所以「测试收得到、真事件收不到」说明问题一定在下面几道关里，而不在网络或 App 上。

## 验证

走到一台摄像头前，站够两三秒再走开。一分钟内手机应该收到一条通知，同时「事件中心」里能找到同一条事件。两个都有＝配好了；事件有、通知没有＝直接跳到本文最后一节。

## 二、推送要过几道关

一条事件从被检测到落在你手机上，要依次通过下面这些关口，任何一关不通就不会响。知道这个顺序，排查时就不用瞎试。

1. **有规则命中**：只有「智能联动」里的规则会发手机通知。默认规则被删掉不会自动补回来。
2. **规则的冷却时间已过**：同一条规则在冷却时间内只推一次，避免同一件事刷屏。
3. **事件分级不是「低」**：调成「低」的事件只入库，手机、网页弹窗都不会有动静，**自动化规则也不会被触发**（喊话、渠道消息、Webhook 一并不执行）。
4. **你在这条规则的接收人里**：规则不指定接收人时＝发给所有家人。
5. **你不在免打扰或临时静音里**：个人设置优先于全局设置；规则还可以单独声明不受免打扰限制。
6. **你的推送偏好没把它过滤掉**：可以只订阅某几台摄像头、某几类事件。
7. **你的账号有这台摄像头的查看权限**：管理员默认全部有权限。
8. **手机系统允许云瞰发通知**。

> **ℹ️ 网页弹窗是另一条通道**
>
> 网页后台和 HDMI 大屏上的事件弹窗走的是另一条实时通道：它不受免打扰时段影响，但同样会被「低」等级挡下。所以「电脑上弹了、手机没响」通常是免打扰或个人推送偏好在起作用，不是推送坏了。

## 三、免打扰时段

免打扰分三层，从粗到细：

| 设置在哪 | 作用范围 | 什么时候用 |
| --- | --- | --- |
| 平台配置 → 通知 → 免打扰开始 / 免打扰结束 | 全家默认 | 统一的作息时间，比如 23:00–07:00 |
| 平台配置 → 我的账号 → 推送偏好 → 我的免打扰时段 | 只影响你自己，覆盖全局；留空＝跟随全局 | 家里作息不一致时 |
| 平台配置 → 我的账号 → 推送偏好 → 静音 1 小时 / 今晚不打扰 | 只影响你自己，到点自动恢复 | 临时不想被打扰 |

1. **设全家的免打扰**

   **去哪里**：平台配置 → 通知。
   **做什么**：填「免打扰开始」和「免打扰结束」，HH:MM 24 小时制，点「保存设置」。
   **怎么算成功**：刷新页面后两个输入框里仍是你填的时间。

2. **设自己的免打扰**

   **去哪里**：平台配置 → 我的账号 → 推送偏好。
   **做什么**：填「我的免打扰时段」，点「保存偏好」。
   **怎么算成功**：页面提示「偏好已保存」。留空则跟随全家的设置。

3. **临时安静一会**

   **去哪里**：同一页。
   **做什么**：点「静音 1 小时」或「今晚不打扰」。
   **怎么算成功**：上方显示「你正在临时静音中，⋯⋯之前不会收到任何推送」。想提前恢复点「解除静音」。

> **⚠️ 免打扰不会自动拦下通知规则**
>
> 「智能联动」里每条规则都有一个「受免打扰时段限制」开关，**默认是关的**——意思是这条规则像传感器一样任何时候都触发，免打扰时段照样推送。安装时自带的那组默认规则也是关的。所以设完免打扰时段之后，还要去把你希望夜里安静的那几条规则勾上这个开关，免打扰对它们才真正生效。跌倒这类规则建议保持不勾：半夜摔倒正是最需要被叫醒的时候。

如果嫌逐条规则去勾麻烦，还有更省事的一条路：把噪声大的事件类型整体降级——见下一节。

## 四、事件分级：哪些推手机、哪些只记录

家里最吵的通常是「移动侦测」「离开区域」「区域无人」这类事件。与其一条条去删规则，不如给事件类型定个等级。

1. **打开分级设置**

   **去哪里**：平台配置 → 通知。
   **做什么**：展开「事件分级（按事件类型调整推送强度）」。
   **怎么算成功**：出现「默认推送等级」和「按事件类型覆盖」两块。

2. **把噪声事件降到低**

   **做什么**：在「按事件类型覆盖」里，把「移动侦测」「离开区域」「区域无人」选成「低（只入库）」。
   **怎么算成功**：保存后刷新页面，这几项仍然是「低」。

3. **把关键事件留在高**

   **做什么**：确认「人脸识别」「跌倒检测」「包裹送达」是「高（推所有通道）」或者跟随默认。
   **怎么算成功**：事件中心里这几类事件依旧带通知。

| 等级 | 手机通知 | 网页 / 大屏弹窗 | 适合哪些事件 |
| --- | --- | --- | --- |
| 高（推所有通道） | 推，免打扰时段也推 | 弹 | 跌倒、陌生人、包裹这类你一定想立刻知道的 |
| 中（受免打扰） | 推，但免打扰时段内不推 | 弹 | 一般的人、车、宠物事件 |
| 低（只入库） | 不推 | 不弹 | 移动侦测、离开区域这类量大又不重要的 |

> **💡 降级是一道总闸，不只是静音**
>
> 调成「低」的事件照样检测、照样入库、照样能在事件中心筛选和回放，只是不再打扰你。但要注意它是一道**总闸**：低档事件不会进入自动化，所以靠这类事件触发的喊话、群消息、Webhook 也会一起停掉——只想让手机安静的话，用免打扰时段或个人推送偏好更合适。真要省算力，得去「平台配置 → 检测」里关掉对应的检测能力。

## 五、给家人各自设不同的推送

每个家庭成员用自己的账号登录 App，就能各自决定收什么。管理员只需要把账号建好、把该看的摄像头授权给他。

1. **建一个家人账号**

   **去哪里**：平台配置 → 用户管理。
   **做什么**：新建账号，选好角色，勾上他能看的摄像头。
   **怎么算成功**：用户列表里出现这个人。

2. **让他在 App 上登录一次**

   **做什么**：他用自己的账号在手机 App 上登录。
   **怎么算成功**：在「用户管理」里点开他，能看到已绑定的设备。

3. **各自调整推送偏好**

   **去哪里**：他自己登录网页后台 → 平台配置 → 我的账号 → 推送偏好。
   **做什么**：「订阅哪些摄像头」只勾他关心的那几台；「接收哪些事件」只勾他关心的类型，比如只要「人脸识别」和「跌倒」。
   **怎么算成功**：保存后提示「偏好已保存」。两项都不勾＝接收全部。

4. **验证**

   **去哪里**：平台配置 → 用户管理 → 点开他。
   **做什么**：点「发送测试推送」。
   **怎么算成功**：他的手机收到测试通知。

> **ℹ️ 规则也能指定接收人**
>
> 「智能联动」的通知动作里可以指定接收人，不指定＝发给所有家人。指定之后仍会按每个人自己的推送偏好和免打扰再过滤一次——两层是叠加关系，不是覆盖关系。

## 六、发到钉钉 / 企业微信 / 飞书等群里

除了手机 App，云瞰还能把事件发到你已经在用的群里或第三方推送 App——钉钉、企业微信、飞书、Bark、Server酱、Telegram、Discord、Slack、Synology Chat、VoceChat，以及企业自建应用形式的飞书应用 / 企业微信应用 / 钉钉应用。凭证在「平台配置 → 通知 → 通知渠道」里配一次，之后所有规则直接选用，换密钥也只改这一处。

1. **添加一个渠道**

   **去哪里**：平台配置 → 通知，往下拉到「通知渠道」。
   **做什么**：点「添加渠道」，选一种类型。
   **怎么算成功**：出现这种类型的表单，每个字段下面都写着凭证去哪里拿，旁边还有「查看官方文档」的链接。

2. **填凭证**

   **做什么**：给渠道起个自己认得出的名字（例如「客厅钉钉群」），按字段提示填。折叠在「高级选项」里的可以先不管。
   **怎么算成功**：必填项填完，「保存」能点。

3. **测试**

   **做什么**：保存后在渠道列表里点「测试」。
   **怎么算成功**：提示「测试消息已发出」，对应的群或 App 收到一条消息。
   **失败了**：点「查看详情」，能看到 HTTP 状态码和对方返回的原文——密钥填错、加签没配、IP 不在白名单，这三类在这里一眼就能看出来。

4. **在规则里用它**

   **去哪里**：智能联动 → 打开一条规则或新建一条 → 添加动作。
   **做什么**：选「发到通知渠道」，在「选择渠道」里挑刚才那条；需要的话再填标题和消息文案、勾上「附带事件快照」或「@所有人」。
   **怎么算成功**：保存规则后点规则上的「测试」，群里收到消息。

各家凭证去哪里拿、能不能附图，速查如下。表单里每个字段下面都有同样的提示，这里是让你先挑一个最省事的。

| 渠道 | 凭证从哪里拿 | 事件快照 | 要注意的 |
| --- | --- | --- | --- |
| 企业微信群机器人 | 群右上角 → 群机器人 → 添加机器人，复制 Webhook 地址 | 随消息发送 | 支持 @所有人 |
| 钉钉群机器人 | 群设置 → 群机器人 → 添加「自定义机器人」，复制 Webhook 地址 | 以链接附上 | 安全设置选「加签」就把密钥填进「加签密钥」；选「自定义关键词」则留空密钥，但消息文案里必须含那个关键词 |
| 飞书群机器人 | 群设置 → 群机器人 → 添加「自定义机器人」 | 不支持 | 群机器人发不了图，要附图请改用「飞书应用」 |
| Bark | Bark App 首页复制形如 https://api.day.app/你的Key 的地址 | 作为推送图标 | iPhone 专用，不需要服务器 |
| Server酱 | 用微信扫码登录 sct.ftqq.com，复制 SendKey | 以链接附上 | 推到你自己的微信，不需要企业资质；免费版每天有条数限制 |
| Telegram | 找 @BotFather 发 /newbot 拿 Token；chat_id 先给机器人发一句话，再点表单里的「查找 chat_id」 | 随消息发送 | 国内需要代理 |
| Discord | 服务器设置 → 整合 → Webhook → 新建 | 作为附件 | 国内需要代理 |
| Slack | api.slack.com 建一个 App → 开启 Incoming Webhooks → 添加到频道 | 以链接附上 | Slack 的服务器要能访问云瞰的公网地址 |
| Synology Chat | Chat → 整合 → 传入 Webhook | NAS 按链接取图 | 建议填内网 http 地址，省掉证书问题 |
| VoceChat | 管理后台建机器人拿 API Key，再填频道 ID | 以链接附上 | 机器人要先加入那个频道 |
| 飞书应用 | 开发者后台建「企业自建应用」，拿 App ID / App Secret | 随消息发送 | 能发到群也能发给个人；机器人要先拉进群。海外 Lark 要把接口地址切成 open.larksuite.com |
| 企业微信应用 | 管理后台拿企业 ID、应用 Secret、AgentId | 随消息发送 | 能直接推到成员的个人微信；2022 年后新建的应用要配「企业可信 IP」，家庭宽带 IP 会变，需要一个固定 IP 的中转 |
| 钉钉应用 | 开发者后台建「企业内部应用」，拿 AppKey / AppSecret | 随消息发送 | 能发单聊也能发群；要在开发管理里填服务器出口 IP |

> **ℹ️ 先挑哪一个**
>
> 家里人都在用微信、又不想折腾企业资质，选「Server酱」最省事，一个 SendKey 就通。已经有企业微信或钉钉的，群机器人只要复制一个 Webhook 地址，两分钟配完。用 iPhone 且想要独立的告警声，选 Bark。要把消息推到每个家人的个人微信，用「企业微信应用」。

> **⚠️ 附图能不能成，取决于渠道**
>
> 上表的「事件快照」一列有两种：**随消息发送**的，图片直接传过去，收消息的人不需要能访问云瞰；**以链接附上**的，则要求对方（人或对方服务器）能打开云瞰的地址，链接 30 分钟内有效。只在局域网访问、没配公网域名时，后一类只能收到文字。动作编辑器里勾「附带事件快照」时，下面那行小字会告诉你当前这个渠道属于哪一种。

> **💡 文案里放了 AI 画面描述会先等一会再发**
>
> 消息文案里用了 `{{summary}}`（AI 画面描述）时，这条渠道消息会先等描述生成再发——本地模式最长约 15 秒，云端模式最长约 2 分钟，超时就不带描述照发。原因是群消息发出去就改不了，不像手机通知能原地变详细。要求即时送达就别放这个变量；编辑器里用了它会有一行提示。

> **ℹ️ 关于推到个人微信**
>
> 早期版本提供过直接挂到个人微信的渠道，但它要求你最近刚跟机器人说过话才推得动，隔一阵不聊推送就失败，现在不再提供新建（已经建好的照常能用）。想把事件推到微信里，用「Server酱」（推到自己的微信）或「企业微信应用」（推到成员的个人微信）更稳。

## 七、让通知里直接看到画面

默认的通知只有一行文字。打开下面几项之后，不用点开就知道发生了什么。三项都在「平台配置 → 通知」里。

1. **通知里显示画面**

   **做什么**：打开「通知里显示画面」。
   **怎么算成功**：下一条事件通知带上检测目标的特写。
   **注意**：安卓要显示图片需要配好公网 HTTPS 域名，只在局域网访问时安卓收不到图，iPhone 不受影响。

2. **安卓：折叠着也能看到图**

   **做什么**：打开「在通知里直接显示画面和 AI 描述」。
   **怎么算成功**：安卓通知折叠着就有缩略图，展开是大图。iPhone 一直是完整效果，不受这个开关影响。

3. **AI 描述写好后更新通知**

   **做什么**：打开「AI 摘要写好后更新通知」。
   **怎么算成功**：通知过几秒自己从「门口有人」变成更具体的一句话，不会再响一次，也不会多出一条。
   **前提**：先在「平台配置 → AI 摘要」里开启画面描述。

> **💡 AI 描述是几秒之后才有的**
>
> 事件通知是立刻发出的，画面描述要晚几秒才生成（用云端模型时更久）。所以正常表现是先收到一条简短通知，那条通知随后自己变详细，而不是等描述写完才推。

## 八、有事件但没收到通知

按下面的顺序查，每一步都有明确的「看哪里」。绝大多数情况在前三步就能定位。

1. **先确认通道本身是通的**

   平台配置 → 用户管理 → 点开自己 → 「发送测试推送」。收得到＝通道没问题，继续往下查；收不到＝先看「我的账号 → 我的设备」里有没有这台手机、手机系统的通知权限是不是关着，必要时在 App 里退出重新登录一次。

2. **确认事件真的产生了**

   去事件中心找那个时间点。没有事件＝这是检测的问题，不是推送的问题，去看《AI 检测》那一篇。

3. **群里 / 第三方 App 没收到**

   平台配置 → 通知 → 通知渠道，先看那条渠道的「上次结果」：显示失败就点「测试」，再点「查看详情」看对方返回了什么。也要确认渠道是「已启用」，以及规则里选的确实是这条渠道——渠道被删掉后，规则里会提示重新选择。

4. **看这类事件的分级**

   平台配置 → 通知 → 事件分级。被设成「低（只入库）」的事件不会推送，网页也不会弹。

5. **看有没有规则管这类事件**

   智能联动，找触发条件里包含这个事件类型的规则。默认规则被删掉不会自动补回来，重建一条即可。

6. **看规则的冷却时间**

   打开那条规则看冷却时间。如果刚刚已经推过一条同类通知，冷却时间内不会再推。规则的执行历史里不记录被冷却和免打扰跳过的次数，所以「历史是空的」不代表规则没工作。

7. **看免打扰和临时静音**

   平台配置 → 我的账号 → 推送偏好，确认没在临时静音中，以及免打扰时段是不是刚好覆盖了这个时间点。

8. **看自己的推送偏好**

   同一页，「订阅哪些摄像头」和「接收哪些事件」一旦勾了范围，范围外的一律不推。

9. **看摄像头权限**

   平台配置 → 用户管理，确认这个账号有这台摄像头的查看权限。没有权限的摄像头，它的事件不会推给这个人。

> **⚠️ 陌生人事件单独有个开关**
>
> 「平台配置 → 通知 → 陌生人来访推送」关掉之后，不认识的人只会出现在事件中心，不会推手机。排查陌生人相关的漏推先看这里。

## 相关教程

- [自动化](/docs/automation)——写规则、加条件、配机器人渠道
- [AI 检测](/docs/detection)——事件从哪来、怎么减少误报
- [客户端](/docs/clients)——手机端与网页端各自适合做什么
- [排错](/docs/troubleshooting)——装不上、连不上、看不到画面

---

来源:https://yun-kan.com/zh-CN/docs/notifications