Params y plantillas

Mapea valores en un destino — params desde un campo o un valor fijo, params obligatorios, variables {{…}} en URLs, headers, bodies y textos, y cómo cada lugar los codifica por ti.

Los destinos trabajan con dos herramientas: los params, los valores con nombre que lleva un destino, y las plantillas, las variables {{…}} que escribes en sus URLs, headers, bodies y textos.

Params

{
  "params": {
    "message": { "from": "state.message", "required": true },
    "route": { "from": "result.route" },
    "lead_score": { "from": "composites.lead_score" },
    "team": { "value": "inbound" }
  }
}

Un param toma su valor de un campo de la ejecución (from) o es un valor fijo (value): un string de hasta 500 caracteres, un número, true, false o null. Un destino tiene hasta 30 params, con nombres de letras, dígitos y _ — hasta 48 caracteres, sin empezar por un dígito.

Orígenes

fromValor
stateEl estado completo: un objeto, un string o un array.
state.<field>Un campo declarado en un esquema de estado de objeto.
result.<question>La respuesta: una opción, la etiqueta de un nivel o una probabilidad.
confidence.<question>La confianza de la respuesta, de 0 a 1.
scores.<question>El nivel ponderado de una pregunta score.
composites.<key>El valor de un compuesto.
actionLa acción final: continue, block, escalate o fallback.
decision.slugEl slug de la decisión.
decision.versionLa versión que respondió — null en el Playground, que ejecuta el borrador.
execution.idEl ID exec_… de la ejecución.

Los valores conservan su tipo JSON: confidence.route es un número, state un objeto. Un valor que no existe — un campo opcional que quien llama no envió, cualquier respuesta después de un fallback por error del motor — es null.

Params obligatorios

Marca un param como required cuando el destino no tiene sentido sin él — un lead de CRM sin e-mail. Cuando se resuelve como null o un string vacío, el destino no se dispara y la respuesta dice por qué:

{ "key": "create_lead", "type": "http", "status": "skipped", "reason": "missing_param", "param": "email" }

A dónde van los params

TipoLos params…
webhookse envían en el evento, bajo data.params.
workflowse envían como campos JSON de nivel superior — lo que n8n, Make y Zapier mapean directamente.
httpson el body JSON de las solicitudes POST, PUT y PATCH sin plantilla de body, y la query string de las solicitudes GET y DELETE cuya URL no los usa.
agentse envían en el body de la solicitud, bajo params.
functionse pasan a tu handler como primer argumento.
reply, llmsolo se usan mediante {{params.…}} en sus textos.

Usa params para todo lo que llegue a un tercero: un webhook o un workflow nunca recibe el propio estado, solo los params que mapeas — envía lo que necesita el receptor y nada más.

Plantillas

Escribe {{ y }} alrededor de una variable — se permiten espacios dentro: {{ params.awb }}.

VariableValor
{{params.<name>}}Un param de este destino.
{{state}}, {{state.<field>}}El estado, o un campo declarado de un estado de objeto.
{{result.<question>}}, {{confidence.<question>}}, {{scores.<question>}}Una respuesta, su confianza, un nivel ponderado.
{{composites.<key>}}El valor de un compuesto.
{{action}}, {{decision.slug}}, {{decision.version}}, {{execution.id}}La ejecución.
{{delivery.id}}El ID dlv_… de esta entrega — el mismo en cada intento.
{{secrets.<NAME>}}Un secreto del workspace.

El menú Insertar… del editor, junto a cada campo, lista las variables que puedes usar ahí.

La codificación es automática

Nunca escapas nada a mano: Dcision codifica cada valor para el lugar al que va.

DóndeCómo se insertan los valoresSecretos
URLs — webhook.url, http.url, agent.url, workflow.urlCodificados para URL. Un secreto se inserta tal cual, así que puede contener una URL completa.Permitidos
Valores de header — http.headers, agent.headersComo texto, con los saltos de línea reemplazados por espacios — un valor no puede agregar un header.Permitidos
http.bodyComo JSON — consulta más abajo.Permitidos
Textos — reply.text, reply.buttons, llm.instructions, llm.input, agent.instructionsComo texto, conservando los saltos de línea.No permitidos: el texto se devuelve a quien llama o se envía a un modelo.

Como texto, los strings se insertan tal cual, los números y booleanos se imprimen, los objetos y arrays se convierten en JSON y null se convierte en un string vacío.

Bodies JSON

Una plantilla de body http es JSON con variables, y la posición de una variable decide cómo se escribe:

  • Fuera de comillas, se convierte en un valor JSON — un string con sus comillas, un número, true, null, un objeto.
  • Dentro de comillas, se convierte en texto dentro de ese string, escapado según haga falta.

Para una decisión cuyo estado de objeto tiene los campos email y company_size, con un param email tomado de state.email:

Plantilla del body
{
  "email": {{params.email}},
  "company_size": {{state.company_size}},
  "summary": "Route {{result.route}} at {{confidence.route}} — lead score {{composites.lead_score}}",
  "lead": {{state}}
}
Body enviado
{
  "email": "ana@acme.com",
  "company_size": 500,
  "summary": "Route sales at 0.85 — lead score 0.8414",
  "lead": { "message": "We need pricing for 500 users.", "email": "ana@acme.com", "company_size": 500 }
}

Así que escribe {{state.company_size}} — no "{{state.company_size}}" — para enviar el número 500 en lugar del texto "500". {{params.email}} tampoco necesita comillas: su valor es un string, así que se escribe con sus comillas.

El body debe ser JSON válido una vez completadas las variables: el editor lo comprueba con valores de ejemplo al guardar, y una plantilla no válida se rechaza con "The body must be JSON once variables are filled in…". Un body tiene hasta 10,000 caracteres. Déjalo vacío en POST, PUT y PATCH para enviar los params como un objeto JSON; las solicitudes GET y DELETE no tienen body.

Comprobaciones de las plantillas

Las plantillas se validan cuando guardas o despliegas:

  • cada variable debe existir: {{params.awb}} necesita un param llamado awb, {{state.company_size}} un campo de un estado de objeto, {{result.route}} una pregunta llamada route;
  • los nombres de los secretos van en UPPER_SNAKE_CASE, como {{secrets.CRM_TOKEN}};
  • cada {{ necesita su }}, con una variable dentro;
  • los secretos no se pueden usar en textos.

Un secreto ausente no es un error del esquema — los secretos cambian sin deploy —, pero una entrega que hace referencia a uno falla hasta que se define. Consulta Secretos del workspace.

En esta página