Automatización con código custom en HubSpot Operations Hub

HubSpot es conocido por sus workflows visuales de drag-and-drop. Pero hay un momento en el que las automatizaciones estándar no alcanzan: necesitás lógica condicional compleja, cálculos, o llamadas a APIs externas. Ahí es donde entra el Operations Hub y sus acciones de código custom.

¿Qué es Operations Hub?

Operations Hub es el hub de HubSpot diseñado para equipos de operaciones (RevOps). Su feature estrella son las Custom Code Actions: bloques de código JavaScript o Python que podés insertar dentro de cualquier workflow.

Esto significa que dentro de un workflow podés:

• Ejecutar código JavaScript/Python con lógica personalizada
• Llamar a APIs externas directamente desde el workflow
• Transformar y formatear datos antes de guardarlos
• Crear lógica de branching compleja que no es posible con las condiciones estándar

Ejemplo práctico: Lead Scoring custom

Imaginá que querés un sistema de scoring más sofisticado que el nativo de HubSpot. Podés crear un workflow con código custom que evalúe múltiples factores:

// Custom Code Action - Lead Scoring Avanzado
exports.main = async (event, callback) => {
  const { email, company, phone, country } = event.inputFields;

  let score = 0;

  // Email corporativo vale más
  if (email && !email.includes('gmail') && !email.includes('hotmail')) {
    score += 30;
  }

  // Tiene empresa definida
  if (company && company.length > 0) {
    score += 20;
  }

  // Dejó teléfono
  if (phone && phone.length > 5) {
    score += 25;
  }

  // País target
  if (['AR', 'MX', 'CO', 'CL'].includes(country)) {
    score += 25;
  }

  callback({
    outputFields: {
      lead_score: score,
      lead_tier: score >= 75 ? 'Hot' : score >= 50 ? 'Warm' : 'Cold'
    }
  });
};

Casos de uso avanzados

1. Enriquecimiento de datos automático

Cuando entra un lead nuevo, el workflow llama a una API de enriquecimiento (como Clearbit o Apollo) para obtener información adicional: cargo, tamaño de empresa, industria, etc. Todo se guarda automáticamente en las propiedades del contacto.

2. Rotación inteligente de leads

En vez de round-robin simple, usás código para asignar leads basándote en: territorio geográfico, carga actual del vendedor, especialización por industria, o valor estimado del deal.

3. Sincronización bidireccional con ERPs

Cuando un deal cambia de etapa en HubSpot, el código custom envía los datos al ERP. Cuando el ERP genera una factura, un webhook actualiza el deal en HubSpot con el número de factura.

4. Notificaciones inteligentes

Enviás alertas a Slack o Discord con contexto enriquecido: no solo "nuevo lead", sino datos como scoring, empresa, actividad reciente, y la acción recomendada para el vendedor.

"Con Operations Hub y código custom, automatizamos el 80% de las tareas manuales del equipo de operaciones. Lo que antes tomaba 2 horas diarias ahora se ejecuta solo."

Limitaciones a tener en cuenta

1. Tiempo de ejecución: máximo 20 segundos por acción de código
2. Memoria: limitada, no es para procesar archivos grandes
3. Librerías: solo un subset de npm packages están disponibles
4. Debugging: el entorno de testing es limitado, recomendamos testear la lógica primero

¿Cuándo conviene usar código custom?

Usá código custom cuando:

• Necesitás lógica condicional compleja (más de 3 niveles de if/else)
• Tenés que llamar a una API externa dentro del workflow
• Necesitás transformar datos (formatear fechas, calcular valores, parsear texto)
• Querés validar datos antes de crear o actualizar registros