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
from | Valor |
|---|---|
state | El 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. |
action | La acción final: continue, block, escalate o fallback. |
decision.slug | El slug de la decisión. |
decision.version | La versión que respondió — null en el Playground, que ejecuta el borrador. |
execution.id | El 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
| Tipo | Los params… |
|---|---|
webhook | se envían en el evento, bajo data.params. |
workflow | se envían como campos JSON de nivel superior — lo que n8n, Make y Zapier mapean directamente. |
http | son 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. |
agent | se envían en el body de la solicitud, bajo params. |
function | se pasan a tu handler como primer argumento. |
reply, llm | solo 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 }}.
| Variable | Valor |
|---|---|
{{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ónde | Cómo se insertan los valores | Secretos |
|---|---|---|
URLs — webhook.url, http.url, agent.url, workflow.url | Codificados para URL. Un secreto se inserta tal cual, así que puede contener una URL completa. | Permitidos |
Valores de header — http.headers, agent.headers | Como texto, con los saltos de línea reemplazados por espacios — un valor no puede agregar un header. | Permitidos |
http.body | Como JSON — consulta más abajo. | Permitidos |
Textos — reply.text, reply.buttons, llm.instructions, llm.input, agent.instructions | Como 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:
{
"email": {{params.email}},
"company_size": {{state.company_size}},
"summary": "Route {{result.route}} at {{confidence.route}} — lead score {{composites.lead_score}}",
"lead": {{state}}
}{
"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 llamadoawb,{{state.company_size}}un campo de un estado de objeto,{{result.route}}una pregunta llamadaroute; - 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.
Disparadores de destinos
Cuándo se dispara un destino — condiciones sobre respuestas, confianza, niveles ponderados y compuestos, acciones finales, una confianza mínima por ruta, niveles de score, umbrales de probabilidad — y en qué orden.
Respuestas fijas
Devuelve un mensaje predefinido —texto y botones opcionales, con variables— en la respuesta de la API para un resultado dado, al instante y sin llamar a ningún modelo.