工作流
触发 n8n、Make、Zapier、Pipedream 或任意工作流 URL,将路由的变量作为扁平的 JSON 字段发送,并在 dcision 下附带决策——经过签名,并在后台重试。
工作流目的地会启动你在无代码或低代码工具中构建的自动化。Dcision 将路由的变量 POST 到工作流的触发 URL——以扁平的 JSON 字段发送,这正是这些工具一键即可映射的形式——并在后台投递,带有重试。
配置
{
"key": "sales_crm",
"type": "workflow",
"when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
"params": {
"message": { "from": "state.message", "required": true },
"company_size": { "from": "state.company_size" },
"lead_score": { "from": "composites.lead_score" },
"team": { "value": "inbound" }
},
"workflow": { "platform": "n8n", "url": "{{secrets.N8N_LEADS_WEBHOOK}}", "name": "New sales lead" }
}| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
platform | string | custom | n8n、make、zapier、pipedream 或 custom。它为目的地打上标签,并在编辑器中提示 URL 格式;所有平台的请求都相同。 |
url | string | — | 工作流的触发 URL:https://…,或保存完整 URL 的 {{secrets.NAME}}。最多 2,048 个字符,可包含变量。 |
name | string | — | 可选,最多 120 个字符。作为 dcision.workflow 发送。 |
在编辑器中,工作流的 params 称为工作流变量。
| 平台 | 需要创建的触发器 |
|---|---|
| n8n | 一个 Webhook 节点,方法为 POST;使用其生产 URL。 |
| Make | 一个 Custom webhook 模块。 |
| Zapier | 一个 Webhooks by Zapier → Catch Hook 触发器。 |
| Pipedream | 一个 HTTP / Webhook 触发器。 |
| 自定义 | 任何接受 JSON POST 的 https 端点。 |
触发 URL 实际上就是机密——任何拿到它的人都可以启动你的工作流。请将其保存为工作区密钥,并像上面那样用 {{secrets.NAME}} 作为 URL。
请求
{
"message": "We need pricing for 500 users and want to start next month.",
"company_size": 500,
"lead_score": 0.8414,
"team": "inbound",
"dcision": {
"decision": "lead-qualification",
"decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
"version": 4,
"execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
"result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
"confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
"action": "continue",
"action_reason": { "type": "default" },
"destination": "sales_crm",
"workflow": "New sales lead",
"delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w",
"livemode": true
}
}- 每个 param 都是一个顶层字段;决策本身位于
dcision下。名为dcision的 param 会被该对象替换——请换一个名称。 dcision.workflow是目的地的name(没有则为null),dcision.version在 Playground 中为null,而dcision.livemode对测试密钥和 Playground 为false。- state 本身从不发送——只发送你映射的 params。
请求带有 Content-Type: application/json、包含 Dcision-Signature 的 Dcision 请求头,以及设为投递 ID 的 Idempotency-Key。大多数无代码触发器无法验证 HMAC 签名——请改为对 URL 保密。当你的工作流可以运行代码时,请像 webhook 那样验证签名。
投递
工作流至少投递一次,在约七小时内进行六次尝试:请尽快返回 2xx,让工作流异步运行。针对同一次投递启动两次的运行带有相同的 dcision.delivery_id——在重复会造成损害时(例如在创建 CRM 记录之前)请据此去重。