Módulo 8: Proyecto — Hub de Integraciones

El Núcleo de Procesamiento

Descripción de la cápsula

Los tres caminos de entrada convergen — todos con el mismo "lead normalizado". A partir de ese punto empieza el núcleo de procesamiento: el cerebro del hub.

El núcleo es la pieza que justifica toda la arquitectura. Es una sola copia de la lógica de negocio, que se ejecuta igual para los tres canales porque no sabe ni le importa de cuál vino el lead — solo ve el formato común. Cambias algo en el núcleo, cambia para todos los canales a la vez. Eso es lo que el hub "espagueti" no podía darte.

El núcleo hace tres cosas, en orden: deduplicar (¿este lead ya lo teníamos?), enriquecer (¿se le puede agregar información útil?), y enrutar (¿todos los leads se tratan igual, o algunos van por un camino especial?). Esta cápsula construye las tres — todas reutilizando patrones que ya conoces de los módulos anteriores. El núcleo no inventa nada nuevo; orquesta lo que ya sabes.

Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

✅ Construir la deduplicación del núcleo — "buscar antes de actuar" a escala de hub
✅ Enriquecer un lead — agregarle información que no traía
✅ Enrutar leads — separar los que necesitan tratamiento distinto
✅ Mantener el núcleo agnóstico del canal de origen
✅ Reconocer que el núcleo orquesta patrones conocidos, no inventa

El principio del núcleo: agnóstico del origen

La regla que define esta capa:

El núcleo no sabe si el lead vino del formulario, de Calendly o del email. Solo ve los seis campos del formato común. Si en algún nodo del núcleo te encuentras escribiendo lógica del tipo "si vino de Calendly, haz X" — detente. O eso pertenece a la capa de entrada (el traductor), o el formato común está mal definido.

La única excepción legítima es el enrutamiento, y aun ahí el núcleo enruta por propiedades del lead (su mensaje, su empresa), no por su canal. El source_channel se guarda para reportes, pero el núcleo no decide en función de él salvo casos muy justificados.

Esta disciplina es lo que mantiene el núcleo como una sola copia que sirve a todos.

Parte 1: Deduplicar

El primer trabajo del núcleo. Un hub recibe leads por tres canales — y nada impide que la misma persona llegue por dos: llenó el formulario y reservó en Calendly. O que el mismo formulario se envíe dos veces. Sin deduplicación, el CRM y la hoja se llenan de repetidos.

La construcción

Es "buscar antes de actuar" (Módulo 1, cápsula 03) — el patrón que has usado en cada módulo de la guía, ahora a escala de hub:

[lead normalizado, viene del Merge]
   │
   ▼
Buscar el lead por email  (en HubSpot, o en la hoja de seguimiento)
   │
   ▼
IF: ¿ya existía?
   │
   ┌──────────┴──────────┐
   ▼ NO (lead nuevo)     ▼ SÍ (ya lo teníamos)
 sigue al enriquecido    [marca como "lead recurrente"
                          y decide: ¿actualizar? ¿avisar
                          que volvió a contactar?]

La clave de deduplicación es el email — el identificador que el formato común garantiza normalizado (minúsculas, sin espacios) desde la capa de entrada. Por eso normalizamos el email en los traductores: para que la deduplicación del núcleo funcione de verdad.

Un lead "recurrente" no es basura — es información. Alguien que te contacta por segunda vez está más interesado. El núcleo puede tratarlo distinto: en vez de "crear", actualiza; y quizás avisa al equipo "este lead volvió". Decide qué tiene sentido para el negocio.

Parte 2: Enriquecer

El segundo trabajo: agregarle al lead información que no traía, pero que es útil aguas abajo.

Enriquecer no es inventar datos — es derivar o completar:

Enriquecimiento	Cómo
Marca de tiempo de procesado	`processed_date = {{ $now.toISO() }}` — distinta de la `date` de entrada
Un ID interno del lead	Generar un identificador propio del hub para rastrear este lead
Una clasificación simple	Según el `message` o la `company`: ¿parece un lead "grande" o "pequeño"?
El estado inicial	`status = new` (o `recurring`, según la deduplicación)
El canal, ya como dato limpio	El `source_channel` que traía, listo para reportes

Mantén el enriquecimiento simple y honesto. Un Set que agrega 3-4 campos derivados es enriquecimiento sano. Intentar "adivinar" datos que no tienes (la facturación de la empresa, el cargo de la persona) no es enriquecer — es inventar. Lo que sí podrías hacer en producción es llamar a un servicio externo que complete datos reales — pero eso es avanzado; para el capstone, deriva de lo que ya tienes.

La clasificación con IA (entender de verdad el message del lead) es justo lo que las guías G6 y G7 del path enseñan. El hub es el lugar perfecto para esa mejora — pero por ahora, una clasificación por palabras clave (como la del Módulo 2) es suficiente y honesta.

Parte 3: Enrutar

El tercer trabajo: decidir si todos los leads se tratan igual o algunos necesitan un camino distinto.

Para muchos hubs, la respuesta es "todos igual" — y entonces no hay enrutamiento, el lead pasa directo a la distribución. Pero a menudo hay matices reales:

Caso	Enrutamiento
Un lead "grande" (por su empresa o mensaje)	Además de lo normal, mencionar a un vendedor senior en Slack
Un lead recurrente (de la deduplicación)	Camino "ya lo conocíamos" — actualizar en vez de crear
Un lead con un mensaje vacío o sospechoso	Camino "revisar manualmente" — quizás no es un lead real

La herramienta es el Switch (G2) — separa el flujo según una propiedad del lead (no de su canal, recuerda el principio):

[lead enriquecido]
   │
   ▼
Switch: ¿qué tipo de lead?
   │
   ┌──────────┬──────────┬──────────┐
   ▼ normal   ▼ grande   ▼ recurrente ▼ a revisar

No sobre-enrutes. Si tu negocio de verdad trata a todos los leads igual, no inventes ramas. El enrutamiento se justifica cuando hay una diferencia real de tratamiento, no por "tener más cajitas". Un hub con un solo camino al que llegan todos los leads es perfectamente válido — y más fácil de mantener.

El núcleo completo

Juntando las tres partes:

[Merge — lead normalizado, de cualquier canal]
   │
   ▼
DEDUPLICAR  →  buscar por email → IF (¿existe?)
   │
   ▼
ENRIQUECER  →  Set: processed_date, id interno, status, clasificación
   │
   ▼
ENRUTAR     →  Switch: ¿normal / grande / recurrente / revisar?
   │
   ▼
[hacia la DISTRIBUCIÓN — cápsula 05]

Una sola copia. Tres canales entran por arriba (vía el Merge de la cápsula 03), un lead procesado y enrutado sale por abajo hacia la distribución.

Fíjate en algo: el núcleo no usa ninguna herramienta externa salvo la búsqueda de deduplicación. Es casi todo Set, IF y Switch — lógica pura de n8n. El núcleo es el "pensamiento" del hub; la distribución (cápsula 05) es donde vuelve a tocar herramientas externas.

Trampas comunes

Trampa 1: Lógica "según el canal" en el núcleo

Qué pasa: Un IF en el núcleo dice "si vino de Calendly, haz X". El núcleo deja de ser agnóstico — la arquitectura se erosiona.

Cómo evitar: Lógica de canal → va en el traductor (capa de entrada). El núcleo solo ve el formato común.

Trampa 2: Saltarse la deduplicación

Qué pasa: "Para qué deduplico, si los leads son distintos". Hasta que el mismo lead llega por formulario y por Calendly, y tienes dos registros de la misma persona.

Cómo evitar: Un hub con varios canales necesita deduplicación. Es el primer trabajo del núcleo, no opcional.

Trampa 3: "Enriquecer" inventando datos

Qué pasa: Intentas adivinar el tamaño de la empresa, el presupuesto del lead. Datos inventados que contaminan el CRM.

Cómo evitar: Enriquecer = derivar de lo que tienes o completar con fuentes reales. No inventar.

Trampa 4: Sobre-enrutar

Qué pasa: Creas seis ramas en el Switch para diferencias que el negocio en realidad no trata distinto.

Cómo evitar: Enruta solo cuando hay una diferencia real de tratamiento. Un solo camino es válido.

Trampa 5: Meter distribución en el núcleo

Qué pasa: "Ya que deduplico contra HubSpot, aprovecho y creo el contacto aquí". Mezclaste núcleo con distribución.

Cómo evitar: El núcleo decide y prepara; la distribución ejecuta. La búsqueda de deduplicación toca HubSpot, sí — pero crear/registrar es trabajo de la cápsula 05.

Ejercicio: construye el núcleo

Objetivo: un núcleo agnóstico que deduplica, enriquece y enruta.

Tu tarea

Continuando el workflow de la cápsula 03 (después del Merge):

Deduplicar: un nodo de búsqueda por email (en HubSpot o en tu hoja de seguimiento) → un IF que separe "lead nuevo" de "lead recurrente".
Enriquecer: un nodo Set que agregue al lead: processed_date, status (new o recurring), y una classification simple (puedes derivarla del message con una regla de palabras clave, o dejarla en general por ahora).
Enrutar: un nodo Switch que separe al menos "normal" de algún caso especial que tenga sentido para tu diseño (recurrente, o "grande", o "a revisar").
La prueba de agnosticismo: revisa todo el núcleo que construiste. ¿Hay algún nodo que dependa de source_channel para decidir? Si lo hay, ¿debería estar en el traductor? Corrígelo.

Ver pistas

En el 1, la condición del IF es la de siempre: {{ $('Search').all().length === 0 }} para "nuevo".
En el 2, la clasificación por palabras clave reusa la técnica del Módulo 2 (/palabra/i.test(...)).
El paso 4 es el más importante: leer tu propio núcleo y verificar que es agnóstico. Guardar source_channel está bien; decidir en función de él (salvo casos muy justificados) no.

Resumen y siguiente paso

El núcleo es una sola copia de la lógica de negocio — se ejecuta igual para los tres canales porque es agnóstico del origen
Si te encuentras escribiendo "si vino de tal canal, haz X" en el núcleo — detente: eso va en el traductor
El núcleo hace tres cosas: deduplicar (buscar antes de actuar, por email), enriquecer (derivar datos útiles, sin inventar), enrutar (Switch, por propiedades del lead, no por su canal)
La deduplicación no es opcional en un hub multi-canal — la misma persona puede llegar por dos vías
No sobre-enrutes: un solo camino es válido si el negocio trata a todos los leads igual
El núcleo es casi todo Set, IF y Switch — lógica pura; orquesta patrones conocidos, no inventa
El núcleo decide y prepara; la distribución ejecuta — no los mezcles
5 trampas: lógica de canal en el núcleo, saltarse la deduplicación, "enriquecer" inventando, sobre-enrutar, meter distribución en el núcleo

Antes de avanzar deberías poder:

Construir la deduplicación del núcleo
Enriquecer un lead sin inventar datos
Verificar que tu núcleo es agnóstico del canal

Lo que sigue (cápsula 05):

El núcleo entrega un lead procesado, deduplicado y enrutado. La cápsula 05 construye la última capa: la distribución — repartir ese lead a las cuatro herramientas (HubSpot, Sheets, Slack, Gmail) para que todo el negocio se entere a la vez.

Recursos adicionales

n8n IF node Docs - Para la deduplicación.
n8n Switch node Docs - Para el enrutamiento.
Revisa el Módulo 1 (cápsula 03, "buscar antes de actuar") — el patrón que el núcleo reusa a escala de hub.

Creado: Mayo 14, 2026 Versión: 1.0

← AnteriorLos Puntos de Entrada Siguiente →La Distribución a las Herramientas