Saltar al contenido
PHP 8.2 pierde soporte de seguridad el 31 de diciembre.Revise la exposición de su sitio →

Cómo construir extensiones a medida en HubSpot: funciones serverless, módulos personalizados e integraciones por API

Cómo construir extensiones a medida en HubSpot: funciones serverless, módulos personalizados e integraciones por API

La propuesta de HubSpot es "sin código para el 80%, poco código para el 15% y desarrollo a medida para el 5% restante". Ese último 5% es donde el desarrollo a medida para RevOps se paga solo: es la diferencia entre una plataforma de marketing que usted configura y una superficie de producto que su equipo realmente opera. Este es un recorrido por los patrones que vale la pena conocer si está evaluando HubSpot como plataforma a largo plazo o definiendo el alcance de una migración desde WordPress.

HubSpot Projects: funciones serverless para RevOps

HubSpot Projects es el producto de funciones serverless de HubSpot. Se despliega con la CLI de HubSpot y escala automáticamente. Los casos de uso típicos:

  • Receptores de webhooks. Un sistema externo envía un evento a HubSpot; una función de Projects lo procesa, actualiza registros del CRM y dispara un flujo de trabajo.
  • Procesadores de formularios a medida. Cuando el envío de un formulario nativo no alcanza (validación condicional, enriquecimiento con una API de terceros, lead scoring a medida), una función de Projects se ejecuta como parte del proceso de envío.
  • Puentes con API de terceros. Traer datos de una API interna, adaptarlos a la estructura de HubSpot y actualizar registros según un horario.
  • Tareas en segundo plano para operaciones pesadas. Importaciones largas, conciliaciones o tareas de limpieza que superarían el tiempo de una solicitud síncrona.

La experiencia para los desarrolladores es limpia: compatible con TypeScript, con control de versiones, desplegable por CLI e integrada de forma nativa con la autenticación y los registros de HubSpot. Si ha usado Vercel Functions o AWS Lambda, se sentirá en casa.

Objetos de CRM personalizados: modelar las entidades de su negocio

HubSpot trae contactos, empresas, negocios y tickets. Para la mayoría de los modelos B2B eso basta. Cuando no basta (cuando su negocio tiene instalaciones, contratos, activos, pólizas, proyectos u otra entidad de primer nivel que HubSpot no modela de forma nativa), los objetos de CRM personalizados lo resuelven.

Un objeto personalizado es accesible por API, se reporta junto con contactos y negocios, y tiene ciclo de vida. Puede asociarlo con contactos y negocios para modelar las relaciones que importan a su equipo. Por ejemplo, una empresa de administración de instalaciones podría agregar un objeto "Instalación" asociado a contactos (administradores) y negocios (contratos), para que la vista de cuenta de cada vendedor muestre el contexto operativo correcto.

La disciplina aquí es modelar con moderación. Cada objeto personalizado suma superficie de mantenimiento; el punto de quiebre está en unos 3 o 4 objetos personalizados, a partir de los cuales el CRM empieza a sentirse hecho a medida. Eso puede ser correcto, pero debe ser una decisión deliberada.

HubDB: tablas estructuradas que generan páginas

HubDB es el producto de tablas estructuradas de HubSpot. Piense en él como una pequeña base de datos relacional con filas y columnas, accesible por API, que puede generar páginas dinámicas automáticamente.

HubDB es la respuesta correcta para contenido que se beneficia de una estructura de filas y columnas:

  • Directorios de sedes (cada fila es una sede, con una URL dinámica por sede)
  • Bibliotecas de recursos (cada fila es una descarga, con filtros por categoría)
  • Páginas de equipo (cada fila es una persona; se puede ordenar y filtrar)
  • Listados de eventos (cada fila es un evento, con vencimiento automático)
  • Marketplaces de integraciones (cada fila es un socio, con una página dinámica por socio)

Para contenido extenso y no estructurado (artículos del blog, casos de éxito detallados), HubDB es la herramienta equivocada. Para eso use el blog y las landing pages nativas de HubSpot.

Módulos personalizados: el multiplicador del equipo de contenido

Los módulos personalizados son bloques de interfaz reutilizables con campos tipados. Son la inversión principal que separa una buena implementación de HubSpot de una frágil.

Un módulo bien construido tiene etiquetas de campo claras, valores por defecto sensatos, validación por campo, documentación visible para quien edita y comportamiento responsive incorporado. Un módulo mal construido tiene campos de HTML libre, nombres de campo poco claros, ninguna documentación, y depende de que quien edita sepa qué clase de estilo usar.

La prueba: entréguele el módulo a alguien de marketing que no participó en su construcción y obsérvelo usarlo. Si busca al desarrollador a los 30 segundos, el módulo tiene una mala ergonomía. Vale la pena iterarlo durante la fase 3 de una migración y no dejarlo para después del lanzamiento.

Apps públicas: cuando necesita distribuir una integración

Todo lo anterior es interno a su portal de HubSpot. Las apps públicas son la forma de distribuir una integración que otras organizaciones instalan en sus propios portales. La tecnología de fondo es la misma (Projects y API), pero cambia la distribución: autenticación con OAuth, publicación en el HubSpot App Marketplace y gestión de credenciales por cliente.

Una app pública es un proyecto de ingeniería de producto, no de RevOps. Si está considerando una, trátela como cualquier producto SaaS: defina la experiencia de usuario, el soporte, el precio y el mantenimiento antes de escribir código.

Integraciones por API y webhooks

La API de HubSpot es amplia, está bien documentada y contempla límites de uso. Los patrones estándar de integración:

  • Sincronización con Salesforce: sincronización bidireccional de contactos y negocios. HubSpot trae una integración nativa con Salesforce que cubre el 80% de los casos; el desarrollo a medida resuelve el mapeo de campos restante y la lógica de resolución de conflictos.
  • Exportaciones a un data warehouse: funciones programadas de Projects que envían copias del CRM a Snowflake, BigQuery o Databricks para modelos de atribución y reportes ejecutivos.
  • Puentes con sistemas internos: un ERP (NetSuite, SAP), una plataforma de facturación (Stripe) o una herramienta operativa que necesita compartir estado con el CRM. Projects con webhooks es casi siempre el patrón más limpio.
  • Envío de eventos a HubSpot: telemetría de su propio producto SaaS que enriquece el perfil en el CRM. Use la Custom Events API en lugar de forzar los datos en propiedades del contacto.

La disciplina: empezar por la vía sin código

Cada vez que sienta la tentación de desarrollar a medida, pregúntese si una capacidad nativa de HubSpot resuelve el 80% de la necesidad. En casi todos los casos la respuesta es sí, y el 20% restante suele ser cosmético. El error más común de los equipos cuando obtienen capacidad de desarrollo a medida es usarla en todas partes, lo que socava la promesa sin código de la plataforma y crea una deuda de mantenimiento que se acumula.

La regla práctica correcta: todo desarrollo a medida debe ahorrar al menos 10 veces su costo de mantenimiento en horas de equipo por año. Si no lo hace, use la vía sin código y conviva con la solución del 80%.

Qué sigue

Si está definiendo una migración de WordPress a HubSpot y quiere saber qué patrones de extensión necesitará su equipo, nuestra guía gratuita de migración recorre el plan de 6 fases con los puntos de decisión de cada inversión en desarrollo a medida. O, si prefiere conversar sobre su situación específica, defina el alcance directamente con nosotros.

Empecemos

¿Listo para escalar sus operaciones de tecnología?

Respuesta a su cotización en 24 horas. Propuesta detallada en 48.