Módulo 8: Proyecto — Hub de Integraciones

La Distribución a las Herramientas

Descripción de la cápsula

El núcleo te entrega un lead procesado, deduplicado y enrutado. Esta cápsula construye la última capa: la distribución — repartir ese lead a las cuatro herramientas del hub para que todo el negocio se entere a la vez.

Esta es la capa donde el hub devuelve el valor. Todo lo anterior — los traductores, el núcleo — fue preparación. La distribución es donde un lead que entró por un canal acaba registrado en el CRM, anotado en la hoja, anunciado en Slack y confirmado por correo. Un evento → cuatro herramientas, sin que nadie copie nada a mano. Eso es, literalmente, lo que la guía entera prometía.

La cápsula también introduce una decisión de diseño importante para esta capa: las distribuciones, ¿van en secuencia (una tras otra) o en paralelo (todas a la vez)? La respuesta cambia cómo se comporta el hub — y prepara el terreno para la cápsula 06, sobre qué pasa cuando una de esas cuatro herramientas falla.

Lo que vas a aprender

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

✅ Distribuir un lead a varias herramientas: CRM, hoja, Slack, correo
✅ Decidir entre distribución en secuencia y en paralelo
✅ Reusar todo lo aprendido en los Módulos 1-6
✅ Mantener la distribución agnóstica de cómo se procesó el lead
✅ Reconocer que la distribución es donde el hub "devuelve el valor"

El principio de la distribución: ejecutar, no decidir

Igual que cada capa tenía su disciplina, la distribución tiene la suya:

La distribución ejecuta, no decide. El núcleo ya tomó todas las decisiones — si el lead es nuevo o recurrente, qué clasificación tiene, por qué ruta va. La distribución solo reparte el lead ya procesado a las herramientas.

Si te encuentras poniendo un IF de lógica de negocio en la capa de distribución — "si el lead es grande, entonces..." — esa decisión pertenece al núcleo (cápsula 04). La distribución toma lo que el núcleo le dio y lo manda a cada herramienta. Punto.

Cada destino de la distribución reusa, casi tal cual, lo que aprendiste en su módulo. La distribución no enseña nada nuevo — cosecha lo que ya sabes.

Los cuatro destinos

Para el hub de Norte Digital, el lead procesado se reparte a cuatro herramientas. Cada una reusa su módulo:

Destino 1: el CRM — HubSpot (Módulo 6)

El lead entra al sistema de ventas:

HubSpot — Contact: Create or Update (deduplica por email, M06 cápsula 03)
Mapea los campos del lead normalizado a las propiedades del contacto
Idealmente, registra una nota con el source_channel y el message — la automatización visible (M06 cápsula 06)
Si el enrutamiento marcó "lead grande", aquí podrías además crear un deal y una tarea (M06 cápsulas 04, 06)

Destino 2: la hoja de seguimiento — Sheets (Módulo 1)

El registro operativo, el que el equipo revisa:

Google Sheets — Append Row (o Update or Append, M01 cápsulas 04-05)
Una fila por lead, con los seis campos del formato común más los enriquecidos del núcleo (processed_date, status, classification)

Destino 3: el aviso al equipo — Slack (Módulo 4)

El equipo se entera al instante:

Slack — Send al canal #leads, con formato (M04 cápsula 04)
Un mensaje escaneable: nombre, empresa, canal de origen, mensaje, clasificación
Si el enrutamiento marcó "lead grande" o "recurrente", menciona al responsable adecuado (M04 cápsulas 04-05)

Destino 4: la confirmación al cliente — Gmail (Módulo 2)

El lead recibe respuesta:

Gmail — Send un correo de confirmación personalizado (M02 cápsula 03)
Usa el name y el message para que se sienta escrito a mano, no automático

Mira lo que acaba de pasar: la distribución es un repaso de toda la guía. Sheets, Gmail, Slack, HubSpot — cada destino es un módulo. El hub no es magia nueva; es tus siete módulos, orquestados.

La decisión clave: ¿secuencia o paralelo?

¿Las cuatro distribuciones se ejecutan una tras otra o todas a la vez? Es una decisión de diseño real con consecuencias.

En secuencia

núcleo → HubSpot → Sheets → Slack → Gmail

Cada una espera a que termine la anterior.

✅ Simple de construir y de leer
✅ Puedes pasar datos de una a la siguiente (ej. el ID que devuelve HubSpot lo usa el siguiente nodo)
⚠️ Si HubSpot tarda, todo lo demás espera
⚠️ Si HubSpot falla, Sheets, Slack y Gmail no se ejecutan (tema de la cápsula 06)

En paralelo

         ┌→ HubSpot
núcleo ──┼→ Sheets
         ├→ Slack
         └→ Gmail

Las cuatro arrancan a la vez (con varias conexiones de salida del mismo nodo).

✅ Más rápido — no esperan entre sí
✅ Un destino lento no frena a los demás
⚠️ No puedes pasar datos entre ellas (ninguna "ve" el resultado de otra)
⚠️ Manejar el "qué pasó con cada una" es más complejo

Recomendación para el capstone: una mezcla pragmática. Pon en secuencia lo que tiene dependencia de datos real — por ejemplo, primero HubSpot (que devuelve el ID del contacto) y luego Sheets (que guarda ese ID). Lo que no depende de nadie — Slack y Gmail — puede ir después, o en paralelo. No hay una respuesta única; lo importante es decidir conscientemente, no que el orden quede "como salió".

Y un anticipo honesto: ese "⚠️ si una falla, las demás no se ejecutan" es exactamente el problema que la cápsula 06 resuelve. Por ahora, construye la distribución; en la siguiente cápsula la hacemos robusta.

El hub completo, de punta a punta

Júntalo todo — las tres capas, construidas en las cápsulas 03, 04 y 05:

┌─ ENTRADA (cápsula 03) ───────────────┐
│ Webhook    → traductor ─┐            │
│ Calendly   → traductor ─┼→ [MERGE]   │
│ Gmail      → traductor ─┘            │
└──────────────────────────────────────┘
                  │
┌─ NÚCLEO (cápsula 04) ────────────────┐
│ Deduplicar → Enriquecer → Enrutar    │
└──────────────────────────────────────┘
                  │
┌─ DISTRIBUCIÓN (cápsula 05) ──────────┐
│ → HubSpot (registrar + nota)         │
│ → Sheets  (anotar fila)              │
│ → Slack   (avisar al equipo)         │
│ → Gmail   (confirmar al cliente)     │
└──────────────────────────────────────┘

Esto es el Hub de Integraciones. Un lead entra por cualquiera de tres canales y, segundos después, está en el CRM, en la hoja, anunciado en Slack y con su correo de confirmación enviado. El destino de toda la guía, funcionando.

Trampas comunes

Trampa 1: Lógica de decisión en la distribución

Qué pasa: Un IF en la capa de distribución decide cosas que el núcleo debió decidir.

Cómo evitar: La distribución ejecuta. Las decisiones (nuevo/recurrente, clasificación, ruta) ya las tomó el núcleo.

Trampa 2: Orden de distribución "como salió"

Qué pasa: Pones los cuatro destinos en el orden en que se te ocurrieron, sin pensar dependencias.

Cómo evitar: Decide conscientemente: ¿qué destino produce un dato que otro necesita? Eso va en secuencia. El resto, en el orden que prefieras.

Trampa 3: Forzar secuencia donde no hay dependencia

Qué pasa: Pones Slack a esperar a Gmail aunque no se necesitan entre sí — el hub es más lento sin razón.

Cómo evitar: Solo encadena en secuencia lo que tiene dependencia de datos real.

Trampa 4: Reinventar en vez de reusar

Qué pasa: Construyes la distribución a HubSpot desde cero, olvidando todo lo del Módulo 6.

Cómo evitar: La distribución cosecha los Módulos 1-6. Cada destino es lo que ya aprendiste — reúsalo.

Trampa 5: Ignorar el "qué pasa si una falla"

Qué pasa: Construyes la distribución feliz, todo en secuencia, y asumes que las cuatro herramientas siempre responden.

Cómo evitar: Por ahora está bien — pero tenlo presente: la cápsula 06 trata exactamente esto. No des el hub por "terminado" hasta hacerlo robusto.

Ejercicio: construye la distribución

Objetivo: completar el hub — el lead procesado llega a las cuatro herramientas.

Tu tarea

Continuando el workflow (después del núcleo de la cápsula 04):

Construye los cuatro destinos, cada uno reusando su módulo:
- HubSpot: Create or Update del contacto + nota
- Sheets: Append de una fila con todos los campos
- Slack: mensaje formateado a #leads
- Gmail: correo de confirmación al lead
Decide el orden: ¿qué va en secuencia (por dependencia de datos) y qué da igual? Justifica tu decisión.
Prueba el hub completo: dispara los tres canales de entrada, uno por uno. Verifica que, venga de donde venga, el lead acaba en las cuatro herramientas.
Prueba la deduplicación end-to-end: manda el mismo lead (mismo email) por dos canales distintos. Verifica que el núcleo lo detecta como recurrente y no se duplica en el CRM ni en la hoja.

Ver pistas

En el 2, la dependencia más típica: HubSpot devuelve el ID del contacto; si quieres guardar ese ID en la hoja, Sheets va después de HubSpot, en secuencia.
En el 3, la prueba reveladora del capstone: tres entradas distintas, el mismo resultado en las cuatro herramientas. Si funciona, la arquitectura funciona.
En el 4, esto valida que el núcleo (cápsula 04) hace su trabajo: el hub es idempotente de punta a punta.

Resumen y siguiente paso

La distribución es la capa donde el hub devuelve el valor — un evento entra por un canal, acaba en cuatro herramientas
Su disciplina: ejecuta, no decide — el núcleo ya tomó las decisiones; la distribución solo reparte
Cuatro destinos, cada uno reusa su módulo: HubSpot (M06), Sheets (M01), Slack (M04), Gmail (M02) — la distribución cosecha la guía entera
Secuencia vs paralelo: en secuencia lo que tiene dependencia de datos real; lo demás puede ir en paralelo o en cualquier orden — decídelo conscientemente
El hub completo son las tres capas: entrada (traduce) → núcleo (procesa) → distribución (reparte) — el reloj de arena de la cápsula 01, funcionando
5 trampas: decisión en la distribución, orden "como salió", forzar secuencia sin dependencia, reinventar en vez de reusar, ignorar el "qué pasa si una falla"

Antes de avanzar deberías poder:

Distribuir un lead a varias herramientas reusando sus módulos
Decidir conscientemente entre secuencia y paralelo
Probar el hub completo de punta a punta

Lo que sigue (cápsula 06):

El hub funciona... cuando todo va bien. Pero un sistema real falla a veces — HubSpot tiene un rate limit, Slack está caído un minuto, una credencial caducó. La cápsula 06 hace el hub robusto: qué pasa cuando una de las cuatro herramientas falla, y cómo evitar que un fallo parcial deje el sistema a medias.

Recursos adicionales

Revisa los Módulos 1, 2, 4 y 6 — cada destino de la distribución es uno de ellos.
n8n: conexiones múltiples - Cómo un nodo puede tener varias salidas (para distribución en paralelo).
n8n Merge node Docs - Si necesitas reunir caminos paralelos después.

Creado: Mayo 14, 2026 Versión: 1.0

← AnteriorEl Núcleo de Procesamiento Siguiente →Manejo de Errores y Robustez