Saltar al contenido principal

Método de integración de HubSpot: ¿app nativa, Data Sync o API personalizada?

Rob Ayala
Rob Ayala 17 min de lectura Actualizado
Ilustración de aplicaciones unidas a través de un centro redondo con gruesas flechas curvas, y pequeñas fichas de datos que viajan por las líneas.

Elige el método según cuatro factores: objetos y campos necesarios, dirección de sincronización, volumen y frecuencia de datos, y quién lo mantiene. Digitalegy es un partner de HubSpot. Usa HubSpot Data Sync si una app compatible cubre tus objetos y te basta una sincronización no instantánea (HubSpot revisa si hay cambios en HubSpot cada cinco minutos), una app del Marketplace si sus funciones listas para usar bastan, y si no, una integración personalizada por API o middleware.

Puntos clave

  • Elige el método menos personalizado que supere las cuatro preguntas: primero Data Sync o una app del Marketplace, luego middleware y, al final, una integración personalizada por API.
  • HubSpot Data Sync ejecuta sincronizaciones unidireccionales o bidireccionales con apps compatibles, y HubSpot revisa si hay cambios en HubSpot cada cinco minutos, por lo que las actualizaciones no son instantáneas.
  • Data Sync no mantiene las asociaciones de los objetos personalizados y no puede sincronizar datos de un proceso de ventas sin etapas de negocio u oportunidad.
  • Una app OAuth de distribución pública instalada desde el HubSpot Marketplace tiene un límite de 110 solicitudes cada 10 segundos por cada cuenta de HubSpot que la instala, así que diseña los datos de alto volumen con resúmenes, lotes o caché.
  • Una integración personalizada implica hacerte cargo de los cambios de la API, como el fin del soporte de HubSpot para las API v1 a v3, con fecha de aplicación en septiembre de 2027.
  • Define la fuente de verdad, la dirección, la regla de conflicto y la clave de coincidencia de cada campo compartido antes de ejecutar cualquier sincronización, porque una coincidencia fallida puede crear duplicados.

¿Cuál es la diferencia entre una app del Marketplace, HubSpot Data Sync y una integración personalizada por API?

Una app del Marketplace es una integración lista para usar que instalas, HubSpot Data Sync es la sincronización de registros integrada de HubSpot para apps compatibles, y una integración personalizada por API es código que tu equipo escribe y del que es responsable. El middleware, o iPaaS (plataforma de integración como servicio), es una cuarta opción en la que armas flujos de integración en una plataforma de terceros.

Las cuatro opciones se diferencian en quién escribe la lógica y quién la mantiene funcionando.

Sobre la revisión de las apps del Marketplace, la página de HubSpot sobre cómo instalar apps desde el HubSpot Marketplace indica:

"All apps in the HubSpot Marketplace are reviewed and certified by HubSpot's team of developers" (todas las apps del HubSpot Marketplace son revisadas y certificadas por el equipo de desarrolladores de HubSpot).

Las decisiones dentro de cualquier app (qué campos se mapean, qué sistema gana un conflicto) siguen siendo tuyas: tú las tomas y las pruebas. Con una app o con Data Sync, otra persona escribió la lógica y tú la configuras. Con middleware o una integración personalizada, tú armas o escribes la lógica, así que tu equipo la mantiene.

¿Qué objetos admite HubSpot Data Sync y qué no cubre?

Data Sync mantiene los registros alineados con una app compatible en una o dos direcciones y puede sincronizar objetos personalizados, pero HubSpot documenta limitaciones claras: no se mantienen las asociaciones de objetos personalizados, algunos campos desplegables solo se mapean en una dirección y los negocios necesitan un proceso de ventas basado en etapas.

Primero confirma en tu cuenta de HubSpot y en la ficha de la app en el Marketplace que tu herramienta es una app compatible con la sincronización de datos, y confirma qué suscripción de HubSpot requieren la sincronización y cualquier mapeo de campos personalizados antes de planear en torno a ellos. Si necesitas repasar cómo HubSpot organiza los datos de clientes, ventas y marketing, lee La visión general del modelo de datos de HubSpot antes de decidir qué objetos sincronizar.

Qué cubre Data Sync

Qué no cubre

¿Cómo se comparan los métodos de integración en costo, tiempo de configuración, flexibilidad, mantenimiento y volumen de datos?

Según nuestra evaluación, las apps del Marketplace y Data Sync son las opciones más baratas y rápidas de configurar, pero las menos flexibles; una integración personalizada por API es la más flexible y la más cara de sostener, y el middleware queda en medio.

La tabla califica los cuatro métodos en seis criterios. Las celdas con enlace provienen de la documentación pública de HubSpot; todas las demás celdas son nuestra evaluación.

CriterioApp del MarketplaceHubSpot Data SyncIntegración personalizada por APIMiddleware (iPaaS)
Costo (nuestra evaluación)Bajo: sin código; revisa en la ficha si la app tiene algún costoBajo: solo configuración; confirma la suscripción que requiere tu appEl más alto: tiempo de desarrolladores para construirla y mantenerla en funcionamientoMedio: una suscripción a la plataforma más el tiempo para construir flujos
Tiempo de configuraciónCorto (nuestra evaluación): instalar, conectar, configurarCorto de configurar; las sincronizaciones con millones de registros pueden tardar varios días en completarseEl más largo (nuestra evaluación): diseñar, construir, probar, documentarMedio (nuestra evaluación): construir y probar flujos
Flexibilidad (nuestra evaluación)Limitada a lo que ofrece quien desarrolla la appLos mapeos definen qué datos se sincronizan, la dirección y el manejo de conflictos; algunas propiedades desplegables solo se mapean en una dirección, como textoLa más alta: cualquier objeto, campo o lógica que expongan las APIAlta, dentro del conector de HubSpot de la plataforma
Carga de mantenimiento (nuestra evaluación)Baja: quien desarrolla la app mantiene el código; tú vigilas las apps desconectadasBaja a media: HubSpot no actualiza automáticamente las propiedades cuando se agregan opciones desplegables o cambia el tipo de un campoLa más alta: eres responsable de los cambios de la API, como el fin del soporte para las API v1 a v3 en septiembre de 2027Media: tú mantienes los flujos; pregunta al proveedor cómo mantiene su conector
Volumen de datosPara una app OAuth de distribución pública instalada desde el HubSpot Marketplace, 110 solicitudes cada 10 segundos por cada cuenta de HubSpot que la instalaHubSpot revisa si hay cambios cada cinco minutosSujeto a los límites de API de tu cuenta; para integraciones privadas o personalizadas, puedes comprar un máximo de dos aumentos del límite de APISujeto a los mismos límites de API de HubSpot en las llamadas que hace (nuestra evaluación)
Dirección de sincronizaciónLo que admita la appUnidireccional o bidireccionalCualquier dirección que programesCualquier dirección que definan tus flujos

Léela fila por fila. La fila donde tu requisito es más estricto suele decidir el método; por eso la lista de verificación de más abajo convierte estas filas en cuatro preguntas.

¿Qué implican los límites de uso de la API de HubSpot y la frecuencia de sincronización para datos de alto volumen o casi en tiempo real?

Una app OAuth de distribución pública instalada desde el HubSpot Marketplace tiene un límite de 110 solicitudes cada 10 segundos por cada cuenta de HubSpot que la instala, y Data Sync revisa si hay cambios cada cinco minutos, así que los datos de alto volumen o casi en tiempo real deben diseñarse en torno a esos topes.

Las pautas de uso y límites de la API de HubSpot establecen estas reglas:

  • Para una app OAuth de distribución pública instalada desde el HubSpot Marketplace, cada cuenta de HubSpot que instala la app tiene un límite de 110 solicitudes cada 10 segundos.
  • Para los límites de API propios de tu cuenta, que usan las integraciones privadas o personalizadas, puedes comprar un máximo de dos aumentos del límite de API.
  • Las respuestas de error no deben superar el 5% del total de tus solicitudes diarias.
  • Los datos que tu sitio web o tu app usa en cada carga de página deben guardarse en caché, no solicitarse a las API cada vez.
  • Las llamadas a webhooks hechas desde flujos de trabajo no cuentan para el límite de solicitudes de la API.

La guía de apps conectadas agrega que varias apps privadas (apps creadas para tu propia cuenta) comparten el mismo conjunto de límite diario de API en lugar de recibir cada una su propia asignación.

Los cálculos (un ejemplo con una app del Marketplace)

Para una app OAuth de distribución pública instalada desde el HubSpot Marketplace, 110 solicitudes cada 10 segundos equivalen a 11 por segundo, 660 por minuto y 39,600 por hora. Actualizar 50,000 registros con una solicitud cada uno toma al menos 50,000 dividido entre 660, aproximadamente 76 minutos, antes de reintentos. Una integración que envía 20,000 solicitudes al día debe mantenerse por debajo de 1,000 respuestas de error.

Data Sync funciona con otro reloj: HubSpot revisa si hay cambios cada cinco minutos, según la guía de sincronización de datos. Para datos de eventos de alto volumen, nuestra recomendación es enviar a HubSpot resúmenes, como la fecha del último inicio de sesión o los usuarios activos semanales por cuenta, en lugar de cada evento.

¿Cuándo vale la pena el costo de construir y mantener una integración personalizada por API o middleware?

Construye a medida cuando los datos o la lógica que necesitas quedan fuera de lo que mapea cualquier app compatible, o necesitas controlar la actualidad de los datos, el procesamiento por lotes o los resúmenes, y una persona designada será responsable del código durante años. Elige middleware cuando necesitas lógica de varios pasos entre sistemas pero nadie será responsable de código.

Señales de que las opciones empaquetadas ya no alcanzan:

  • No existe una app compatible con Data Sync ni una app del Marketplace para el sistema, como ocurre con una base de datos interna.
  • Necesitas asociaciones en objetos personalizados sincronizados, que Data Sync no mantiene.
  • Tu lógica abarca varios sistemas, por ejemplo, crear un registro solo cuando otras dos herramientas coinciden.
  • Necesitas controlar el procesamiento por lotes, la caché o los resúmenes para ajustarte a los límites de solicitudes.

El costo continúa después del lanzamiento. El registro de cambios de HubSpot sobre las API y apps heredadas que dejan de tener soporte anuncia el fin del soporte para las API v1 a v3, las apps públicas heredadas y las apps privadas heredadas, todas con fecha de aplicación en septiembre de 2027. Las integraciones que usan cualquiera de ellas tienen un plazo de 12 meses para migrar, y HubSpot dejará de publicar correcciones de errores, mejoras de confiabilidad o actualizaciones de seguridad para estas versiones. Una integración personalizada carga con ese trabajo de migración; con middleware, pregunta al proveedor cuándo pasará su conector de HubSpot a las API actuales.

Para integraciones internas pequeñas, el mismo registro de cambios dice: "Service Keys are the recommended path for lightweight integrations, internal tools, and AI agent integrations, with no full OAuth backend required" (las Service Keys son la vía recomendada para integraciones ligeras, herramientas internas e integraciones de agentes de IA, sin necesidad de un backend OAuth completo).

Nuestra recomendación: si nadie puede decir con nombre y apellido quién corregirá la integración dentro de un año, elige middleware o una app empaquetada en lugar de código personalizado.

¿Qué debes decidir antes de conectar cualquier cosa?

Antes de ejecutar cualquier sincronización, decide la fuente de verdad de cada campo compartido, la dirección de sincronización, la regla de conflicto, la propiedad para hacer coincidir registros y una línea base de limpieza que registre qué tan limpios están los datos hoy.

  1. Fuente de verdad por campo: un sistema es dueño de cada campo. Dos sistemas que escriben en el mismo campo son la forma en que los datos buenos se sobrescriben.
  2. Dirección de sincronización: unidireccional para los campos que pertenecen a un sistema, bidireccional solo donde ambos equipos editan el campo.
  3. Regla de conflicto: decide qué app gana. En Data Sync, la guía de sincronización de datos advierte que "If there’s no field value in the default app, no data will be changed in the third-party app" (si no hay un valor en el campo de la app predeterminada, no se modificará ningún dato en la app de terceros).
  4. Clave de coincidencia: la guía de HubSpot para hacer coincidir registros en la sincronización de datos recomienda revisar ambas apps para decidir qué propiedades compartidas usar para emparejar registros, porque una coincidencia fallida puede generar un registro duplicado.
  5. Línea base de limpieza: cuenta los duplicados, los propietarios vacíos y las claves de coincidencia vacías en ambos sistemas antes del lanzamiento, para saber después si la integración empeoró las cosas.

Registra las decisiones en un registro de decisiones de campos. Copia este ejemplo y reemplaza las filas con tus propios campos:

CampoFuente de verdadDirecciónRegla de conflictoClave de coincidencia
Dominio de la empresaHubSpotBidireccionalGana HubSpotDominio (empresas)
Domicilio de facturaciónHerramienta contableUnidireccional hacia HubSpotGana la herramienta contableDominio (empresas)
Correo electrónico del contactoHubSpotBidireccionalGana HubSpotCorreo electrónico (contactos)
Propietario del registroHubSpotUnidireccional desde HubSpotGana HubSpot; el propietario debe ser usuario en ambas appsNo es clave de coincidencia
Etapa del ciclo de vidaHubSpotNo se sincronizaNingunaNo es clave de coincidencia

Si estás por mapear campos heredados a HubSpot, Cómo usar Claude para mapear campos y planear la limpieza de datos antes de una migración a HubSpot te ayuda a redactar un mapa de campos y reglas de limpieza priorizadas antes de que cualquier sincronización entre en producción.

¿Qué método de integración elige la regla de las cuatro preguntas para las combinaciones de herramientas más comunes?

Responde cuatro preguntas (objetos y campos, dirección, volumen y frecuencia, responsable) y elige el método menos personalizado que las supere todas: primero Data Sync o una app del Marketplace, luego middleware y, al final, una integración personalizada por API.

La lista de verificación de cuatro preguntas

  1. Objetos y campos: ¿una app compatible con Data Sync o una app del Marketplace maneja cada objeto, campo y asociación que necesitas? Las asociaciones de objetos personalizados o un proceso de ventas sin etapas de negocio hacen fallar a Data Sync en este punto.
  2. Dirección de sincronización: ¿el método puede sincronizar cada campo en la dirección y con la regla de conflicto que define tu registro de decisiones de campos?
  3. Volumen y frecuencia: ¿te basta una revisión cada cinco minutos y, si usas una app OAuth de distribución pública instalada desde el HubSpot Marketplace, el volumen pico cabe dentro de sus 110 solicitudes cada 10 segundos?
  4. Responsable: ¿quién la mantiene? Sin desarrollador, se descarta una integración personalizada; sin nadie que se haga cargo de los flujos, se descarta el middleware.

Combinación 1: CRM más herramienta contable

Objetos: empresas, contactos y facturas. Dirección: los campos de facturación en una dirección hacia HubSpot, los datos de contacto en ambas direcciones. Volumen: unos pocos miles de registros; para los datos financieros no hace falta que la sincronización sea instantánea. Responsable: un gerente de Marketing Operations, sin desarrollador.

Resultado: Data Sync, si la herramienta contable es una app compatible. Planea una tarea manual: las facturas deben asociarse manualmente a los registros de empresa en HubSpot, así que designa quién lo hace y con qué frecuencia. Si la herramienta no es compatible, busca su app en el Marketplace.

Combinación 2: CRM más soporte y facturación

Objetos: tickets, empresas y suscripciones en un objeto personalizado. Dirección: el estado de los tickets en ambas direcciones, las suscripciones en una dirección desde facturación. Volumen: moderado. Responsable: un administrador de RevOps que puede mantener flujos pero no código.

Resultado: Data Sync para la herramienta de soporte (si es compatible), middleware para facturación. Data Sync puede sincronizar el objeto personalizado de suscripciones, pero no se mantienen las asociaciones, y un informe de renovaciones necesita cada suscripción vinculada a su empresa. Un flujo de middleware que escribe la suscripción y establece la asociación cierra esa brecha sin código personalizado.

Combinación 3: CRM más base de datos interna del producto

Objetos: uso del producto por cuenta, escrito en propiedades de empresa. Dirección: una dirección hacia HubSpot. Volumen: millones de eventos sin procesar al mes, resumidos en una actualización por empresa al día. Responsable: el equipo de ingeniería de producto.

Resultado: integración personalizada por API. Ninguna app lista para usar conoce tu esquema, y el equipo de ingeniería puede hacerse cargo del código. Si la integración funciona como app privada, consume el conjunto de límite diario de API de la cuenta, que comparten varias apps privadas, así que revisa los límites de tu cuenta antes de dimensionar el proceso nocturno. No construyas sobre las API v1 a v3 ni sobre apps privadas heredadas, que llegan al fin del soporte en septiembre de 2027, y evalúa las Service Keys, que HubSpot señala como la vía recomendada para herramientas internas.

Si tu equipo quiere ayuda para definir el alcance y construir integraciones con HubSpot, empieza con nuestro servicio de implementación en HubSpot.

¿Qué riesgos implica cada método de integración?

Cualquier método puede crear duplicados, sobrescribir datos buenos o fallar después de un cambio; lo que cambia es dónde vive la lógica y quién la corrige, algo que se complica más cuando se va la persona que construyó una integración personalizada.

  • Registros duplicados (todos los métodos): la guía de HubSpot para hacer coincidir registros advierte que hacer coincidir solo con la propiedad seleccionada "can result in records not matching as expected" (puede provocar que los registros no coincidan como se espera), lo que puede generar un registro duplicado. Con la coincidencia desactivada, los duplicados se sincronizan y no se fusionará ningún registro.
  • Campos sobrescritos (sincronizaciones bidireccionales): cuando ambos sistemas pueden escribir en un campo y la regla de conflicto es incorrecta, los datos buenos se reemplazan. En Data Sync, los mapeos definen cómo se manejan los conflictos; en el código personalizado o el middleware, lo define tu lógica.
  • Sincronizaciones rotas tras cambios: Data Sync no detecta automáticamente nuevas opciones desplegables ni cambios de tipo de campo, y el código personalizado sin migrar en las API v1 a v3 pierde las correcciones de errores y las actualizaciones de seguridad después de la fecha de aplicación de septiembre de 2027.
  • Límites compartidos: las apps privadas de una cuenta comparten un mismo conjunto de límite diario de API, así que la nueva app de otro equipo puede consumir parte de tu asignación.
  • Responsabilidad (personalizada y middleware): cuando quien la construyó se va, la lógica sin documentar se vuelve una caja negra. Nuestra recomendación: mantén un manual de operación (runbook) de una página con el registro de decisiones de campos, el responsable de las credenciales, quién recibe las alertas de error y cómo pausar la sincronización.

Si tu principal preocupación son los registros duplicados o incompletos después de conectar sistemas, lee ¿Cómo mejorar la calidad de los datos en RevOps con las herramientas IA de HubSpot? para la deduplicación y el enriquecimiento con las herramientas de IA de HubSpot.

¿Cómo pruebas y supervisas una integración con HubSpot después del lanzamiento?

Prueba con un conjunto pequeño y conocido de registros antes de la sincronización completa y, después, revisa con un calendario fijo los indicadores de apps conectadas de HubSpot para detectar errores, apps desconectadas y creaciones, actualizaciones o eliminaciones inesperadas.

Antes del lanzamiento

  1. Elige aproximadamente 50 registros de prueba que incluyan los casos difíciles: propietarios faltantes, valores desplegables poco comunes, casi duplicados y claves de coincidencia vacías.
  2. Confirma que cada propietario de registro existe como usuario en ambas apps, porque los datos no se sincronizan para un usuario que existe solo en una (guía de mapeos de campos).
  3. Ejecuta la sincronización y luego compara el número de registros y los campos clave con el origen.
  4. Edita el mismo campo en ambos sistemas y comprueba que gane el sistema documentado como ganador.
  5. Para sincronizaciones grandes, planea el calendario: las sincronizaciones con millones de registros pueden tardar varios días en completarse.

Después del lanzamiento

  • La guía de HubSpot para administrar apps conectadas describe indicadores que "help you monitor app behavior, identify and resolve errors, and prevent issues like expired connections or reaching API call limits" (te ayudan a supervisar el comportamiento de las apps, identificar y resolver errores, y prevenir problemas como conexiones vencidas o llegar a los límites de llamadas a la API). Úsalos para detectar apps desconectadas y ver cómo cada app crea, actualiza o elimina registros del CRM.
  • Mantén las respuestas de error por debajo del 5% del total de solicitudes diarias, el tope que fijan las pautas de uso de la API de HubSpot.
  • Vuelve a revisar los mapeos después de cualquier nueva opción desplegable o cambio de tipo de campo.
  • Designa a un responsable que revise todo esto cada semana y antes de cada informe de cierre de trimestre.

Si tu problema de integración es en realidad un problema de procesos y de reportes entre equipos, conoce nuestro servicio de Revenue Operations.

Preguntas frecuentes

¿HubSpot Data Sync funciona en tiempo real?

No. HubSpot revisa si hay cambios cada cinco minutos, y la guía de sincronización de datos señala que las sincronizaciones con millones de registros pueden tardar varios días en completarse. Si el equipo de ventas necesita datos más actualizados, una integración personalizada o middleware pueden enviar los cambios en el momento en que ocurren, dentro de los límites de API de HubSpot.

¿Una misma combinación de herramientas puede usar más de un método de integración?

Sí. Aplica las cuatro preguntas por sistema, no por combinación; la Combinación 2 de arriba combina Data Sync y middleware. Asigna un solo sistema que escriba en cada campo para que los métodos nunca se sobrescriban entre sí.

¿Quién debe hacerse cargo de una integración si no tenemos desarrollador?

Elige primero Data Sync o una app del Marketplace, o middleware si alguien, como un administrador de RevOps, puede mantener flujos, y designa a esa persona como responsable del manual de operación y de la revisión semanal de apps conectadas. Descarta una integración personalizada, porque su responsable tiene que encargarse de cambios de la API como el fin del soporte para las API v1 a v3 en septiembre de 2027.

¿Puedo comprar más capacidad de API?

Hasta cierto tope: para los límites de API propios de tu cuenta, que usan las integraciones privadas o personalizadas, puedes comprar un máximo de dos aumentos del límite de API. Primero reduce las llamadas con caché y resúmenes diarios, y luego compra capacidad si tus integraciones privadas o personalizadas aún superan el límite.

¿Conviene limpiar los datos antes o después de la primera sincronización?

Antes: cuenta y corrige los duplicados, los propietarios vacíos y las claves de coincidencia vacías en ambos sistemas, y registra esos conteos como tu línea base. Una coincidencia fallida puede generar un registro duplicado, y los datos no se sincronizan para un propietario que es usuario en una sola app, así que limpiar primero mantiene esos problemas fuera de la sincronización.

¿Por qué los registros podrían no sincronizarse entre HubSpot y otra app?

Entre las causas que documenta HubSpot están: si un usuario existe en una app y no en la otra, los datos no se sincronizan, y un proceso de ventas que no depende de etapas de negocio u oportunidad no puede sincronizarse con Data Sync. Revisa primero los propietarios y los pipelines de ventas.

Fuentes

  1. Connect and use HubSpot data sync, HubSpot Knowledge Base (2 de octubre de 2026)
  2. Understand your data sync field mappings, HubSpot Knowledge Base (21 de enero de 2026)
  3. Install apps in the HubSpot Marketplace, HubSpot Knowledge Base (4 de septiembre de 2026)
  4. Sync custom objects between HubSpot and data sync apps, HubSpot Knowledge Base (29 de junio de 2026)
  5. Manage your connected apps, HubSpot Knowledge Base (6 de octubre de 2026)
  6. Legacy APIs and Apps: What's Going Unsupported and When, HubSpot Developers (21 de septiembre de 2026)
  7. API usage guidelines and limits - HubSpot docs, HubSpot Developers (4 de septiembre de 2026)
  8. Match records in data sync, HubSpot Knowledge Base (17 de abril de 2026)

¿Quieres ayuda para ponerlo en práctica?

¡No olvides compartir esta publicación!

Rob Ayala

Rob Ayala

CEO & Founder

Publicaciones relacionadas

HubSpot Implementación Revenue Operations

Métricas de adopción de HubSpot para medir en los primeros 90 días tras la salida en vivo

Rob Ayala
HubSpot Revenue Operations Implementación

Cómo consolidar tu stack de herramientas de RevOps con HubSpot como sistema de registro

Rob Ayala
HubSpot Implementación Inteligencia Artificial

Cómo usar Claude para mapear campos y planear la limpieza de datos antes de una migración a HubSpot

Rob Ayala