Módulo 6: CRM con HubSpot
Empresas y Asociaciones
Descripción de la cápsula
Hasta ahora tienes dos objetos sueltos: contactos (cápsula 03) y deals (cápsula 04). Esta cápsula los conecta — y agrega el tercero, las empresas — convirtiendo el CRM en un sistema relacional de verdad.
El concepto central se llama asociación: el vínculo entre dos registros de HubSpot. Un contacto está asociado a una empresa. Un deal está asociado a un contacto y a una empresa. Sin asociaciones, tu CRM es tres listas separadas que no se hablan: personas por un lado, ventas por otro, empresas por otro. Con asociaciones, es lo que un CRM debe ser — una red donde puedes ver "todos los deals de esta empresa", "el contacto detrás de esta venta", "la empresa de este lead".
Si hiciste el Módulo 5, esto te va a sonar muchísimo: las asociaciones de HubSpot son exactamente las relaciones de Airtable/Notion (cápsula 06 del M05). Misma idea, mismo reto: se manejan con IDs, no con nombres. Esta cápsula reaplica ese conocimiento al CRM.
Lo que vas a aprender
Al terminar esta cápsula serás capaz de:
- ✅ Trabajar con empresas (companies) — crear, buscar, actualizar
- ✅ Entender qué es una asociación en HubSpot
- ✅ Asociar un contacto con una empresa
- ✅ Asociar un deal con su contacto y su empresa
- ✅ Manejar los IDs que las asociaciones requieren
- ✅ Reconocer que esto es el patrón de relaciones del Módulo 5
El tercer objeto: empresas
Una empresa (company) en HubSpot es el registro de una organización — no una persona, sino el negocio al que pertenecen las personas. Sus propiedades típicas:
| Propiedad | Qué es |
|---|---|
name | El nombre de la empresa |
domain | El dominio web — funciona como identificador, parecido al email en contactos |
industry | El sector |
city, country | Ubicación |
Las operaciones son las mismas de siempre: Create, Search, Get, Update, Delete. Si dominaste contactos (cápsula 03), las empresas no tienen misterio — son otro registro relacional.
Detalle paralelo al de contactos: así como el email identifica a un contacto, el dominio (
domain) tiende a identificar a una empresa. HubSpot lo usa para deduplicar empresas. Mismo principio, distinto campo.
Qué es una asociación
Una asociación es el vínculo entre dos registros de HubSpot. Es lo que hace que el CRM sea una red y no tres listas sueltas.
Las asociaciones que más vas a usar:
| Asociación | Significa |
|---|---|
| Contacto ↔ Empresa | "Esta persona trabaja en esta empresa" |
| Deal ↔ Contacto | "Esta venta es con esta persona" |
| Deal ↔ Empresa | "Esta venta es con esta empresa" |
Un deal bien modelado normalmente tiene las dos asociaciones: a su contacto y a su empresa. Así, desde el deal sabes quién es el comprador y de qué organización.
Es el patrón del Módulo 5
Si esto te suena, es porque lo es. Las asociaciones de HubSpot son las relaciones de Airtable/Notion (Módulo 5, cápsula 06). Misma idea: un campo de un registro apunta a otro registro. Mismo reto: se manejan con IDs, no con nombres.
Cuando asocias un deal a un contacto, no le mandas
"Ana López"— le mandas el Contact ID de Ana. Igual que un campo de relación en Airtable recibía Record IDs. Si entendiste aquello, ya entiendes esto.
Cómo se crean las asociaciones
Hay dos momentos en que se establece una asociación:
Al crear el registro
Algunos nodos permiten crear el registro ya asociado. Por ejemplo, al crear un deal, indicar en la misma operación a qué contacto y empresa va asociado (pasando sus IDs). Es lo más eficiente cuando ya tienes los IDs a la mano.
Como operación aparte
El nodo HubSpot también tiene operaciones dedicadas para asociar registros que ya existen. El patrón general:
- Indicas el tipo de objeto origen y su ID (ej. el Deal ID)
- Indicas el tipo de objeto destino y su ID (ej. el Contact ID)
- HubSpot crea el vínculo entre ellos
El nodo de n8n y la versión de la API pueden ofrecer estas operaciones con nombres y formas algo distintas. Lo que no cambia es el principio: una asociación necesita los IDs de los dos registros que vincula. Antes de poder asociar, tienes que tener esos IDs — lo que casi siempre implica un paso de búsqueda previo.
El patrón completo: del nombre a la asociación
El caso real más común: tu workflow recibe un lead con datos en texto ("Ana López, de Acme Corp") y necesita un deal asociado a un contacto y una empresa. Pero las asociaciones necesitan IDs. El patrón:
1. Crear/buscar el CONTACTO → obtienes el Contact ID
2. Crear/buscar la EMPRESA → obtienes el Company ID
3. Crear el DEAL
4. Asociar el deal ←→ contacto (con sus IDs)
5. Asociar el deal ←→ empresa (con sus IDs)
6. (opcional) Asociar el contacto ←→ empresa
Cada paso de "crear/buscar" es "buscar antes de actuar" (Módulo 1) — y su producto es un ID, que es el insumo de los pasos de asociación. Es exactamente el patrón "del nombre al ID a la relación" que practicaste en el Módulo 5, cápsula 06.
Este patrón es el esqueleto del mini-proyecto de la cápsula 08 (lead → contacto → deal). Tenlo presente — lo vas a construir completo.
Trampas comunes
Trampa 1: Intentar asociar con nombres en vez de IDs
Qué pasa: Quieres asociar el deal a "Acme Corp" y mandas el texto. La asociación necesita el Company ID.
Cómo evitar: Asocia con IDs. Si solo tienes el nombre, busca el registro primero para obtener su ID. Es el patrón del Módulo 5.
Trampa 2: Crear deals sin asociaciones
Qué pasa: Tu workflow crea deals que no están vinculados a ningún contacto ni empresa. El CRM se llena de ventas "huérfanas".
Cómo evitar: Un deal casi siempre debe asociarse a su contacto y su empresa. Inclúyelo en el flujo, no lo dejes "para después".
Trampa 3: Olvidar que asociar requiere tener los IDs primero
Qué pasa: Diseñas un workflow que "crea el deal asociado" en un solo paso, sin contar con que necesitas los IDs del contacto y la empresa antes.
Cómo evitar: Las asociaciones van al final del flujo, cuando ya tienes todos los IDs. Planea: primero los registros, luego los vínculos.
Trampa 4: Duplicar la empresa
Qué pasa: Cada lead de "Acme Corp" crea una empresa "Acme Corp" nueva. Terminas con 12 "Acme Corp" en el CRM.
Cómo evitar: Igual que con contactos (email) — usa el dominio para deduplicar empresas, o aplica "buscar antes de crear": busca la empresa por dominio/nombre antes de crearla.
Trampa 5: Asociar al contacto pero no a la empresa (o al revés)
Qué pasa: El deal queda asociado al contacto pero no a la empresa. Desde la empresa no ves la venta.
Cómo evitar: Un deal bien modelado normalmente tiene ambas asociaciones. No te quedes a medias.
Ejercicio: conectar los tres objetos
Objetivo: practicar empresas y asociaciones, construyendo el mini-patrón del proyecto final.
Tu tarea
- Crear/buscar una empresa: Manual Trigger → Set → HubSpot (Company, Create or Update por dominio). Obtén el Company ID.
- Crear/buscar un contacto: HubSpot (Contact, Create or Update por email). Obtén el Contact ID.
- Crear un deal: HubSpot (Deal, Create) en la primera etapa. Obtén el Deal ID.
- Asociar: vincula el deal ←→ contacto y el deal ←→ empresa usando sus IDs.
- Verifica en HubSpot: abre el deal y confirma que muestra el contacto y la empresa asociados.
Ver pistas
- Los pasos 1-3 producen tres IDs. Arrástralos por el workflow (referenciando los nodos:
{{ $('HubSpot Company').item.json.id }}, etc. — ajusta a los nombres reales de tus nodos). - El paso 4 es donde esos IDs se usan: cada asociación necesita el ID de los dos registros que vincula.
- Esta es la estructura exacta del mini-proyecto de la cápsula 08 — si te sale aquí, el proyecto será directo.
Resumen y siguiente paso
- Una empresa (company) es el registro de una organización — otro registro relacional, con el dominio como identificador (paralelo al email del contacto)
- Una asociación es el vínculo entre dos registros — lo que hace del CRM una red, no tres listas sueltas
- Las asociaciones clave: Contacto↔Empresa, Deal↔Contacto, Deal↔Empresa — un deal bien modelado tiene las dos
- Las asociaciones de HubSpot son las relaciones del Módulo 5 — mismo principio: se manejan con IDs, no con nombres
- El patrón completo: crear/buscar cada registro (obtener su ID) → crear el deal → asociar con los IDs — "buscar antes de actuar" encadenado
- 5 trampas: asociar con nombres, deals huérfanos, olvidar que asociar requiere IDs primero, duplicar empresas, asociar a medias
- Este patrón es el esqueleto del mini-proyecto (cápsula 08)
Antes de avanzar deberías poder:
- Crear y buscar empresas sin duplicar
- Asociar un deal con su contacto y su empresa usando IDs
- Explicar por qué las asociaciones son las relaciones del Módulo 5
Lo que sigue (cápsula 06):
Ya tienes la red: contactos, empresas, deals, conectados. Falta lo que mueve la venta: el seguimiento. La cápsula 06 cubre las actividades y tareas — notas, llamadas registradas, recordatorios de follow-up — el trabajo comercial que hace que un deal no se quede estancado.
Recursos adicionales
- n8n HubSpot node Docs - Operaciones de Company y asociaciones.
- HubSpot: asociaciones - Cómo funcionan las asociaciones entre objetos.
- HubSpot: propiedades de empresa - Las propiedades predefinidas de una empresa.
Creado: Mayo 14, 2026 Versión: 1.0