Webhook：有进展，告诉我。
比如构建完成、自动化任务结束，或设备状态变化。让这些服务主动发一条消息，在锁屏和灵动岛上看到进展。
它和 RSS 有什么不同？
RSS 是灵动大陆定期去网站看看有没有新文章。Webhook 则是别的服务发生变化时，主动把消息发给灵动大陆。
例如，网站构建到一半时显示进度，完成后更新结果；或者自己设置的自动化执行完毕，发来一条状态。灵动大陆负责接收和展示，实际任务仍由原来的服务运行。
先亲手试一次
- 01
打开首页的「Webhook 市场」
在「卡片 → 事件连接」里，打开 Webhook 市场。选一个场景，先看看它需要什么，再点「按这个指南配置连接」。
- 02
给连接起名，创建专属地址
比如「我的构建」或「家里的自动化」。点「创建专属地址」，得到只属于这条连接的发送地址。按 App 提示完成必要登录与权限设置。
- 03
点「发送接入验证：开始」
App 会发送一条明确标注为「接入验证」的真实请求。回到桌面或锁屏，查看卡片是否出现。请先允许系统实时活动。
- 04
再试「更新」和「结束」
回到连接详情，继续发送更新与结束，观察同一张卡片的变化。这样先认识整套流程，再接入自己的服务。
怎么让它真正自动更新？
- 01
复制连接的专属发送地址
在这条连接的详情中点「复制地址」，把它保存到你使用的自动化或服务的私密配置里。
- 02
设置什么时候发送
例如每次构建开始、进度变化、成功或失败时发送。你的服务需要能发送 HTTP POST 请求，并按灵动大陆要求提供 JSON 内容。
- 03
使用 App 里的发送格式
打开连接详情的「查看发送格式与接入步骤」，使用当前版本的示例。平台默认的 Webhook 内容不一定兼容，通常需要转换字段；只粘贴地址不一定能直接接通。
- 04
运行一次真实任务，核对手机
在连接详情查看事件记录，再去手机上确认显示效果。服务端收到、Apple 接收推送、设备真正显示，是三个不同的环节。
这条地址，请只留给自己
拿到地址的人就能向这条连接发送事件。把地址放在自动化工具的私密变量或服务端密钥配置里，避免贴进公开仓库、日志或分享截图。怀疑地址泄露时，在 App 中重新生成，旧地址就会失效。
这份教程不会读取或收集你的发送地址。需要反馈问题时，描述现象和错误即可，不要提交完整地址。
看不懂技术细节，也可以先弄清这些
我平时只看文章，需要 Webhook 吗？
如果只是关注网站更新，从 RSS 市场开始就足够。Webhook 更适合已经有自动化工具、构建服务或可上报状态的设备的人。
创建了地址，为什么什么也没发生？
创建连接相当于准备好了收信地址。你还需要发送接入验证，或者配置外部服务主动发送事件；App 不会自动连接电脑或读取设备。
测试请求收到，但灵动岛没出现？
先检查系统是否允许实时活动、机型是否支持灵动岛，再查看连接详情的投递记录。有时 Apple 已接收推送，设备仍可能没有显示；按记录提示排查，并在锁屏查看。
可以直接粘到 GitHub 的 Webhooks 里吗？
先看市场里对应的指南。不同平台发送的原始 JSON 格式不同，通常需要 GitHub Actions 脚本、自动化流程或中间服务转换成灵动大陆的事件格式。
技术人员需要注意什么？
当前事件格式为 v2，以 App 连接详情生成的示例为准。同一次任务使用相同 instanceId，sequence 逐次增加；每个新事件用独立 eventId。重试同一事件保留原标识与原内容。开始、更新、结束都要发送完整状态，并使用真实的采集时间与有效期。
卡片会永久挂在那里吗？
不会。事件有有效期，卡片还受到 iOS 实时活动时限约束。没有新状态会标记过期；任务完成或失败时，应由服务发送明确的结束事件。