SSE 触发

SSE（Server-Sent Events）触发器连接服务端 SSE 端点，按事件类型匹配后触发工作流。

概述

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

服务端推送的 SSE 事件格式如下：

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

快速上手

1. 拖入「SSE 触发」节点到画布
2. 填写 SSE 端点 URL，如 https://api.example.com/sse
3. 填写「事件类型」——对应 SSE 协议中 event: 字段的值，如 task_notify、message、order_sync
4. 配置执行方式和接收数据变量名
5. 服务端推送匹配事件后，工作流自动启动

参数参考

参数	类型	默认值	说明
SSE URL	文本	—	SSE 端点地址，必填
事件类型	文本	—	匹配 SSE 协议 event: 字段的值，如 message，必填
执行方式	下拉选择	—	必填。打开新标签页 / 匹配已打开的页面
执行页面 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}} 等字段。

常见问题

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

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

原因：服务端地址不可达，或端点未按 SSE 规范响应（需返回 Content-Type: text/event-stream）。

解决：在浏览器开发者工具 Network 面板中查看 SSE 连接状态，确认服务端响应头正确。