Webvizio 钩子连接器

解决什么问题

当你需要把 Webvizio 的事件通知推送到自有服务时，通常得手动对接 Webhook API、管理认证凭证，并写一套独立的同步脚本。这个技能通过 OOMOL 连接的 oo CLI 封装了这些机械劳动，让你可以直接用标准 JSON 载荷创建或删除 REST Hook 订阅，无需处理原始 token。

工作原理与核心能力

该技能暴露了 2 个针对 Webvizio 状态的操作（Actions），凭证由 OOMOL 服务端注入。

• create_rest_hook_subscription：为某个 Webvizio REST Hook 事件订阅回调 URL。配置成功后，Webvizio 会将该事件的出站通知发送到你的服务。
• delete_rest_hook_subscription：通过对应的 Webvizio webhook ID 取消事件订阅。

调用逻辑遵循“先查契约，再执行”的模式：先通过 oo connector schema 获取权威的输入输出 schema，构造对应的 JSON 载荷执行。响应数据会存放在 data 字段，执行 ID 位于 meta.executionId 中。只有在命令因认证或连接问题实际报错时，才需要补充一次性的环境配置（如登录或连接应用）。

适用边界与注意点

这套方案的运行依赖 oo CLI 和 OOMOL 的后台凭证注入，不适用于脱离该环境的独立部署。在操作层面，请注意区分动作性质：

• 安全动作：查询类（如 get、list、search）可直接运行。
• 需确认动作：创建、更新或发送类动作会改变 Webvizio 状态，运行前必须与用户确认载荷内容及预期效果。
• 破坏性动作：删除或移除操作具有不可逆性，务必确认目标对象并获得明确批准后再执行。