WebSocket 触发

WebSocket 触发器建立长连接接收服务端消息，按 event 字段匹配后触发工作流。

概述

连接 WebSocket 服务器后，插件持续监听服务端推送的 JSON 消息。当 event 字段与配置的「触发事件」匹配时，工作流自动启动，data 字段自动 JSON 解析后存入指定变量。配置面板会实时显示当前连接状态（已连接/未连接）。

服务端推送的消息必须为以下 JSON 格式：

{
  "event": "task_notify",
  "data": {
    "url": "https://example.com/order/12345",
    "orderId": "12345"
  }
}

快速上手

1. 拖入「WebSocket 触发」节点到画布
2. 填写 WebSocket 服务器 URL，如 wss://ws.example.com
3. 填写「触发事件」——对应服务端消息中的 event 字段值，如 task_notify
4. 配置执行方式和接收数据变量名
5. 服务端发送匹配消息后，工作流自动启动

参数参考

参数	类型	默认值	说明
服务器 URL	文本	—	WebSocket 地址，必填。格式：ws:// 或 wss://
触发事件	文本	—	匹配服务端消息 event 字段的值，必填
执行方式	下拉选择	—	必填。打开新标签页 / 匹配已打开的页面
执行页面 URL	文本	—	新建标签页模式时必填
匹配模式	文本	—	匹配模式时必填，参见 URL 匹配模式
接收数据	文本	—	存储 data 字段解析结果的变量名
激活标签页	开关	false	触发时是否自动切换到对应标签页

执行方式

触发器支持两种执行方式，决定工作流在哪个页面上运行：

方式	说明	需配置
打开新标签页	新建一个浏览器标签页，加载指定 URL 后执行	执行页面 URL（必填）
匹配已打开的页面	在已打开的标签页中按 URL 匹配，匹配到后在该页面执行	匹配模式（Chrome match patterns 格式，参见 URL 匹配模式）

执行页面 URL 支持通过 {{变量名}} 引用接收到的数据（详见变量名），实现动态指定目标页面。匹配模式固定不变，不支持变量。

接收参数并实现动态 URL

当触发器收到数据时，数据会按 JSON 解析后存入「接收数据」配置的变量名中（如 data）。之后在流程任意位置通过 {{ }} 表达式引用。

典型用法：收到数据中包含 url 字段时，可在「执行页面 URL」中通过变量动态指定目标页面。

收到的数据示例：

{
  "url": "https://shop.example.com/order/12345",
  "orderId": "12345"
}

触发器配置：

接收数据：data
执行页面 URL：{{data.url}}

流程运行时，「打开网页」或其他节点中也可以引用 {{data.orderId}} 等字段。

常见问题

连接状态一直显示"未连接"

现象：配置了服务器 URL，但面板上一直显示红色的「未连接」。

原因：服务端地址不可达，或 URL 格式不正确。

解决：先用在线 WebSocket 测试工具验证服务端是否可达；确认 URL 以 ws:// 或 wss:// 开头。