门禁刷卡上监控大屏：Surveillance Station 用 Webhook 收第三方事件全流程
监控系统也该「收」事件，不只是录像
很多公司的门禁系统和监控系统是两套世界：门禁刷卡记录在门禁软件里，监控录像在 Surveillance Station 里，出了事要两边对时间翻记录。其实在 Surveillance Station 9.1.4 及以上版本里，第三方系统（警报系统、门禁系统等）的事件数据可以直接通过 Webhook 推进来，推入之后能做三件事：在监控中心实时显示事件信息、把事件存成书签并关联到对应时间点的录制文件、把警报直接送到监控中心。
先分清方向：之前介绍过 Surveillance Station 通过 Webhook 把自家数据发出去给第三方系统，以及接 IFTTT 做智能家居联动；本文讲的是反方向——接收第三方系统推进来的外部事件，路径完全不同。
第一步：配出 Webhook URL
- 进入操作规则，单击添加；
- 信息页面中，规则类型选已触发；
- 事件页面中，事件源选 Webhook，系统随即生成一个 Webhook URL；
- 为这个 Webhook 事件指定唯一令牌——用自动生成的或自定义的都行，关键是第三方系统发请求时令牌必须与这里一致，对不上就建立不了连接；
- 触发类型在一次性和间隔之间选一种，单击高级 Webhook 成分按钮，可添加 text1、text2、text3、time 这几个可选成分，用于携带事件的具体内容（比如谁在哪台门禁机上开了门）。
两种触发类型的差别要理解透：
- 一次性：事件一发生就发送一次 URL，如
https://{NAS_IP:PORT}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Webhook&method="Incoming"&version=1&token="UserDefinedToken"&text1="Access control event"&text2="Device 01"&text3="John Doe unlocked the door"&time=...； - 间隔：事件开始时发
status="active"的 URL，事件结束时再发status="inactive"的 URL。适合「门被强行打开且一直没关」这类有持续状态的事件。
- 单击下一步，快速把添加书签或触发警报操作与 Webhook 事件配对；需要的话还能继续添加更多操作，最后在计划页面设定这条规则的生效时段。
第二步：配「添加书签」操作
书签是把事件钉在录像时间轴上的记号。配对后可自定义的项：
- 设备：选与事件关联的摄像机；
- 持续时间：以秒为单位。若触发类型是「间隔」，书签持续时间由事件时间决定，事件没结束书签会一直延长；
- 名称与描述：默认用规则名称，可单击添加成分把 webhook 的 text1、text2、text3 塞进来，让每条书签自带「设备 01 / 张三刷卡开门」这样的明细；
- 其他选项：勾选在监控中心频道上显示书签信息，事件就能在监控中心实时呈现；还可开启自动锁定书签防止误删。
第三步：配「向监控中心发送警报」操作
- 设备：与事件配对的摄像机；
- 持续时间：警报在监控中心停留的秒数；
- 仅当指定值存在于 webhook 的数据中时才触发：这是个实用开关——比如只在 text2 里出现「设备 01」时才报警，其余门禁事件只记书签不弹警报，避免大屏被刷屏。设置完成后，这条警报还会进入监控中心的警报设置里统一管理。
验证与三个坑
配置完成后，让第三方系统向该 URL 发一条测试请求（令牌、成分都对齐），然后到监控中心看书签频道与警报列表有没有实时出现。三个官方提醒的坑：一是系统生成的 Webhook URL 基于当前登录 URL，第三方系统在外面访问不到这个地址就收不到事件，跨网时先确认外部可达性；二是间隔型事件如果始终收不到 inactive 状态，系统可能报错；三是别忽略计划页面——规则不生效时先查是不是没到生效时段。
门禁、警报与监控三套系统打通这件事，诚鑫致达科技在安防项目里做过多次——令牌对齐、URL 可达、成分命名这三处是最常见的返工点，动手前把这篇过一遍能省不少排查时间。