Workflows

Dispara n8n, Make, Zapier, Pipedream o cualquier URL de workflow con las variables de la ruta como campos JSON planos, más la decisión en dcision, firmado y reintentado en segundo plano.

Un destino workflow inicia una automatización que construiste en una herramienta no-code o low-code. Dcision envía por POST las variables de la ruta a la URL del disparador del workflow —como campos JSON planos, la forma que estas herramientas mapean con un clic— y lo entrega en segundo plano, con reintentos.

Configúralo

{
  "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" }
}
CampoTipoPredeterminadoDescripción
platformstringcustomn8n, make, zapier, pipedream o custom. Etiqueta el destino y sugiere el formato de la URL en el editor; la solicitud es la misma para todos.
urlstring—La URL del disparador del workflow: https://…, o {{secrets.NAME}} con la URL completa. Hasta 2,048 caracteres, con variables.
namestring—Opcional, hasta 120 caracteres. Se envía como dcision.workflow.

En el editor, los params de un workflow se llaman Variables del workflow.

PlataformaDisparador que hay que crear
n8nUn nodo Webhook, método POST; usa su URL de producción.
MakeUn módulo Custom webhook.
ZapierUn disparador Webhooks by Zapier → Catch Hook.
PipedreamUn disparador HTTP / Webhook.
CustomCualquier endpoint https que acepte un POST JSON.

En la práctica, las URLs de los disparadores son secretos: cualquiera que tenga una puede iniciar tu workflow. Guárdala como secreto del workspace y usa {{secrets.NAME}} como URL, como arriba.

La solicitud

Body del POST
{
  "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
  }
}
  • Cada param es un campo de nivel superior; la decisión en sí está bajo dcision. Un param llamado dcision sería reemplazado por ese objeto: elige otro nombre.
  • dcision.workflow es el name del destino (null si no tiene), dcision.version es null en el Playground y dcision.livemode es false para las claves de prueba y el Playground.
  • El estado nunca se envía como tal: solo los params que mapeas.

La solicitud lleva Content-Type: application/json, los headers de Dcision con su Dcision-Signature, y Idempotency-Key con el ID de la entrega. La mayoría de los disparadores no-code no pueden verificar una firma HMAC: en su lugar, mantén la URL en secreto. Cuando tu workflow pueda ejecutar código, verifica la firma como en un webhook.

Entrega

Los workflows se entregan al menos una vez, con seis intentos en unas siete horas: responde 2xx rápido y deja que el workflow se ejecute de forma asíncrona. Una ejecución iniciada dos veces para la misma entrega lleva el mismo dcision.delivery_id: deduplica según él cuando un duplicado pueda causar problemas, por ejemplo antes de crear un registro en el CRM.

En esta página