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" }
}| Campo | Tipo | Predeterminado | Descripción |
|---|---|---|---|
platform | string | custom | n8n, 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. |
url | string | — | La URL del disparador del workflow: https://…, o {{secrets.NAME}} con la URL completa. Hasta 2,048 caracteres, con variables. |
name | string | — | Opcional, hasta 120 caracteres. Se envía como dcision.workflow. |
En el editor, los params de un workflow se llaman Variables del workflow.
| Plataforma | Disparador que hay que crear |
|---|---|
| n8n | Un nodo Webhook, método POST; usa su URL de producción. |
| Make | Un módulo Custom webhook. |
| Zapier | Un disparador Webhooks by Zapier → Catch Hook. |
| Pipedream | Un disparador HTTP / Webhook. |
| Custom | Cualquier 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
{
"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 llamadodcisionsería reemplazado por ese objeto: elige otro nombre. dcision.workflowes elnamedel destino (nullsi no tiene),dcision.versionesnullen el Playground ydcision.livemodeesfalsepara 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.
Agentes
Entrega un resultado a tu propio endpoint de agente con las instrucciones y herramientas de la ruta — espera su respuesta en la respuesta, o delega en segundo plano con reintentos.
Webhooks
Recibe el evento firmado decision.completed en tu URL — el envoltorio, sus headers, verificar Dcision-Signature con y sin los SDKs, bodies sin procesar en Express y Next.js, rotación y deduplicación.