工作流

触发 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" }
}
字段类型默认值说明
platformstringcustomn8n、make、zapier、pipedream 或 custom。它为目的地打上标签,并在编辑器中提示 URL 格式;所有平台的请求都相同。
urlstring—工作流的触发 URL:https://…,或保存完整 URL 的 {{secrets.NAME}}。最多 2,048 个字符,可包含变量。
namestring—可选,最多 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。

请求

POST body
{
  "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 记录之前)请据此去重。

本页内容