Mapeo de Datos (Data Mapping)

Cada sistema habla su propio idioma. Tu trabajo como automatizador es traducir entre idiomas para que la información fluya sin perder sentido. Eso es mapear: tomar un campo que viene en un "idioma" (formato, ruta, nombre) y entregarlo en otro que el destino entienda.

Mapear no es copiar y pegar: es decidir qué dato va dónde, con qué transformación, y en qué formato.

Mapear datos es el acto de conectar la salida (output) de un nodo con la entrada (input) de otro. En n8n se hace con expresiones dentro de doble llave: {{ ... }}.

// Dato que el Webhook recibió
$json.body.usuario = "Gabriel"

// Campo de Telegram que quieres llenar
"Hola {{ $json.body.usuario }}, bienvenido"
// → "Hola Gabriel, bienvenido"

El motor de expresiones de n8n usa JavaScript-like syntax. Puedes hacer operaciones, condicionales, formateo de fechas, etc. Empieza con lo simple y crece.

n8n tiene un editor visual de expresiones que evita que memorices rutas. Úsalo y dejarás de escribir $json.cuerpo.del.usuario.que.esta.anidado a mano.

1. En cualquier campo de un nodo (ej. Text de Telegram), busca el botón con el ícono ⟹ o la etiqueta Expression. Clic ahí.
2. El editor se divide en dos paneles: izquierda = estructura JSON disponible, derecha = la expresión que escribes.
3. Arrastra el campo deseado desde la izquierda. n8n escribe la sintaxis por ti: {{ $json.body.usuario }}.
4. Si necesitas un valor estático en medio del dinámico, ciérralo con }} y sigue escribiendo texto plano.
5. El editor valida en vivo: si ves un cuadrado rojo, la ruta no existe en los datos del nodo anterior.

Objetivo: tomar usuario y monto de un webhook y armar un mensaje personalizado para Telegram.

1. Workflow Crea un workflow nuevo llamado lab-05-mapeo. Trigger: Webhook, método POST, path mapeo.
2. Payload de prueba Desde Postman envía: {"lead": {"usuario": "Sofía", "monto": 95000, "moneda": "COP"}}.
3. Nodo Telegram Agrega el nodo Telegram (o HTTP Request a la API). En el campo Chat ID pon tu chat.
4. Expresión del Text En el campo Text abre el editor de expresiones y escribe: "Nuevo lead: {{ $json.body.lead.usuario }} - {{ $json.body.lead.monto }} {{ $json.body.lead.moneda }}".
5. Resultado En Telegram debes ver: "Nuevo lead: Sofía - 95000 COP".
6. Validación Cambia el JSON en Postman (otro nombre, otro monto, otra moneda). El mensaje en Telegram debe cambiar sin tocar n8n.

// Payload que llegó al Webhook
{
  "lead": {
    "usuario": "Sofía",
    "monto": 95000,
    "moneda": "COP",
    "items": [
      { "producto": "Curso", "precio": 50000 },
      { "producto": "Mentoría", "precio": 45000 }
    ]
  }
}

// Expresión para el Text de Telegram
"Hola {{ $json.body.lead.usuario }}, compraste {{ $json.body.lead.items.length }} items por {{ $json.body.lead.monto }} {{ $json.body.lead.moneda }}"

• Entiendo qué significa mapear datos entre dos sistemas.
• Sé abrir el Editor de Expresiones en cualquier campo de un nodo.
• Reconozco la sintaxis {{ $json.campo }} y de dónde sale.
• Navego JSON anidado con puntos y corchetes sin equivocarme.
• Conecté Webhook → Telegram con un mensaje dinámico funcionando.