Open Office Hours Temporada 1: Sesión 4 - Conexiones: Salesforce y HubSpot

February 05, 2026 · Andreea Arseni · Open Office Hours

Configurar bien tu conexión con Salesforce o HubSpot desde el principio te ahorra dolores de cabeza más adelante. Esta guía recoge las mejores prácticas para ambas plataformas y te muestra, paso a paso, cómo configurar conexiones en MyRapidi.

En la 4.ª sesión de nuestra serie Open Office Hours, te explicamos cómo conectarte a Salesforce y HubSpot a través de Rapidi.

Cómo configurar conexiones con Salesforce y HubSpot

Mira la grabación de nuestra cuarta sesión: Conexiones - Salesforce y HubSpot

Mejores prácticas para la conexión con Salesforce

Usa un usuario de integración dedicado

No uses tu inicio de sesión personal de Salesforce para la integración. Crea en su lugar un usuario de integración dedicado.

¿Por qué? Por dos motivos. Primero, si alguien deja la empresa y su cuenta se desactiva, tu integración deja de funcionar. Lo hemos visto en clientes, y arreglarlo no tiene ninguna gracia. Segundo, un usuario dedicado te da un registro de auditoría limpio. Puedes ver exactamente qué cambios vienen de la integración y cuáles son ediciones manuales.

Conviene saberlo:
Salesforce incluye de serie una licencia de usuario de integración. No necesitas comprar una licencia aparte. Solo tienes que asignar los conjuntos de permisos adecuados y listo.

Configura los permisos de API adecuados

Dale a tu usuario de integración solo el acceso que necesita. Ni más ni menos. Eso significa:

• Acceso de lectura y escritura a los campos concretos que se usan en la integración
• Acceso a los objetos que sincronizas (cuentas, contactos, oportunidades, objetos personalizados, etc.)
• Una seguridad a nivel de campo bien configurada, para que el usuario pueda realmente leer y escribir todos los campos de tus transferencias

Si te saltas la seguridad a nivel de campo, puede que la integración se ejecute pero omita campos sin avisar. Revísalo pronto.

Ten en cuenta los límites de la API

Salesforce fija un tope de llamadas a la API por periodo de 24 horas para cada org. Conoce tus límites y planifica en función de ellos, sobre todo si ejecutas sincronizaciones frecuentes o manejas grandes volúmenes de datos.

Prueba siempre primero en un sandbox

Salesforce facilita la creación de un entorno sandbox. Desde tu org de producción, puedes solicitar una copia completa o parcial. Usa este sandbox para crear y probar tu integración antes de tocar los datos de producción.

Algunas cosas que debes saber sobre los sandboxes de Salesforce:

• Al crear el sandbox, te conviertes automáticamente en su administrador. Inicias sesión con las mismas credenciales. Si tus compañeros necesitan acceso, tendrás que añadirlos.
• Al actualizar un sandbox, cambia el ID de la org de Salesforce. Por eso tendrás que volver a autorizar tu conexión de Rapidi después.
• Actualizarlo es útil cuando necesitas datos recientes de producción para tus pruebas.

Mejores prácticas para la conexión con HubSpot

1 Usa un usuario dedicado

HubSpot no tiene un tipo de «usuario de integración» integrado como Salesforce. Aun así, puedes crear una cuenta de usuario independiente para la integración. Así mantienes limpio el registro de auditoría y evitas los mismos riesgos de continuidad.

2 Elige los scopes adecuados

Al autorizar tu conexión con HubSpot, tendrás que conceder acceso a los objetos correctos. Asegúrate de que el usuario de integración pueda llegar a todo lo que tienes previsto sincronizar.

3 Vigila los límites de tasa

HubSpot gestiona los límites de tasa de forma distinta a Salesforce. Tendrás que lidiar tanto con límites de ráfaga por segundo como con límites diarios. Las cifras exactas dependen de tu nivel de suscripción de HubSpot, así que comprueba cuáles se aplican a tu cuenta.

4 Comprueba el acceso a objetos personalizados

Si tu integración usa objetos personalizados, verifica que tu suscripción de HubSpot los admita. No todos los planes de HubSpot incluyen acceso a objetos personalizados, y esto puede convertirse en un obstáculo si no lo compruebas de antemano.

5 Prueba en un sandbox

Igual que con Salesforce, usa un entorno sandbox de HubSpot para las pruebas. Crea allí tu integración, valida que funciona y luego despliégala en producción.

Configurar conexiones en MyRapidi

Una vez que hayas preparado tus usuarios y permisos, así es como se crean y configuran las conexiones en la plataforma Rapidi.

1 Crear una nueva conexión

1. Inicia sesión en MyRapidi y ve a la sección Connections.
2. Haz clic para añadir una nueva conexión y selecciona Salesforce o HubSpot.
3. Rapidi asigna automáticamente un código de conexión único. Puedes cambiar la descripción por algo significativo, como «Salesforce Producción» o «HubSpot Sandbox».
4. Guarda la conexión.

2 Autorizar

Haz clic en el botón Authorize para vincular la conexión con tu instancia.

Salesforce

Se te redirigirá a una página de inicio de sesión de Salesforce. Antes de iniciar sesión, revisa la URL. Por defecto muestra login.salesforce.com, pero puede que tengas que sustituirla por la URL específica de tu org. Si ya has iniciado sesión en otra org de Salesforce en tu navegador, cierra sesión primero. De lo contrario, podrías autorizar por error la org equivocada.

HubSpot

Se te redirigirá a HubSpot para aprobar el acceso. Selecciona la cuenta correcta y confirma.

Tras la autorización, Rapidi muestra una confirmación con la fecha, la hora y el usuario que autorizó la conexión.

3 Probar

Después de autorizar, haz clic en Test para confirmar que Rapidi puede conectarse a tu instancia. Espera al mensaje de éxito antes de continuar.

4 Read design

Este es el paso que más se olvida. Haz clic en Read Design para que Rapidi lea todos los objetos y campos a los que puede acceder tu usuario de integración.

Cuánto tarda depende de tu nivel de acceso. Si el usuario tiene acceso de administrador a cientos de objetos, puede tardar unos minutos. Si el acceso se limita a unos pocos objetos, termina enseguida.

Error habitual
Si te saltas el paso «Read design», tus transferencias no verán los nuevos objetos o campos. Es una de las consultas de resolución de problemas que más recibimos.

Explorar la estructura de los objetos

Una vez completado el Read Design, puedes comprobar qué hay disponible yendo a cualquier transferencia y haciendo clic en Browse Table Layout. Busca un objeto concreto (como «Contact» u «Order») para ver todos sus campos. Si falta un objeto o un campo, vuelve a leer el diseño o revisa los permisos de tu usuario.

Referencia rápida

Preguntas frecuentes sobre Salesforce

1. ¿Tengo que comprar una licencia aparte para un usuario de integración?

No. Salesforce incluye de serie cinco licencias gratuitas de usuario de integración. Asignas la licencia de usuario «Salesforce Integration» y el perfil «Salesforce API Only System Integrations». No hace falta ninguna compra adicional.

Es algo que se malinterpreta mucho. Los hilos de la Salesforce Trailblazer Community y de Salesforce Ben aclaran una y otra vez que estas licencias vienen de serie con cada org.

2. ¿Por qué mi usuario de integración no puede acceder a objetos o campos tras la configuración?

Es la frustración número 1 en los foros. La licencia de usuario «Salesforce Integration» solo funciona con conjuntos de permisos, no con permisos basados en perfiles. No puedes añadir acceso a objetos al propio perfil.

Tienes que crear un conjunto de permisos que conceda acceso de lectura/escritura a objetos y campos concretos, asignar la licencia de conjunto de permisos (PSL) Salesforce API Integration y, después, asignar el conjunto de permisos al usuario.

La mayoría de las orgs siguen gestionando el acceso mediante perfiles, así que este nuevo modelo pilla a mucha gente desprevenida. Un bloguero lo describió como «montar el peor proyecto de IKEA de la historia».

3. ¿Por qué dejó de funcionar mi integración después de actualizar un sandbox?

Al actualizar un sandbox, cambia el ID de la org de Salesforce. Cualquier integración conectada al sandbox anterior pierde la conexión de inmediato.

Tienes que volver a autorizar la conexión (no basta con volver a probarla), iniciar sesión en la nueva instancia del sandbox y, a menudo, actualizar la URL. Algunas herramientas no te permiten simplemente volver a autorizar — tienes que eliminar la conexión y añadirla de nuevo por completo.

Ten en cuenta también: tras actualizar un sandbox, pueden pasar hasta 48 horas hasta que puedas iniciar sesión mediante test.salesforce.com. Durante ese tiempo, usa en su lugar la URL de inicio de sesión de My Domain de tu sandbox.

4. ¿Cómo compruebo mi uso de la API y qué pasa cuando alcanzo el límite?

Consulta el uso en Setup → System Overview → API Requests, Last 24 Hours. Para el uso mensual, ve a Setup → Company Information → Usage-Based Entitlements.

El límite diario es un límite flexible. Salesforce te permite superarlo temporalmente, pero si el uso sigue aumentando, entra en juego un tope estricto que devuelve el error 403 REQUEST_LIMIT_EXCEEDED. Las llamadas siguen bloqueadas hasta que el uso acumulado de las últimas 24 horas vuelve a bajar del límite.

Puedes configurar notificaciones por correo electrónico con umbrales personalizados (como el 50 %, el 80 % o el 90 %) para detectar picos a tiempo. Las orgs con Enterprise Edition parten de 100.000 solicitudes por periodo de 24 horas, más llamadas adicionales en función de las licencias de usuario.

5. ¿Debo usar mi propio inicio de sesión de Salesforce para las integraciones?

Todas las guías de mejores prácticas dicen que no. Si usas un inicio de sesión personal, la integración deja de funcionar cuando esa persona se va de la empresa. Pierdes un registro de auditoría limpio, porque los cambios de la integración y las ediciones manuales se ven iguales. Y la integración obtiene más acceso del que realmente necesita.

Un usuario de integración dedicado con los permisos mínimos imprescindibles es la recomendación estándar en todos los recursos de Salesforce.

Preguntas frecuentes sobre HubSpot

1. ¿Cuáles son los límites de tasa de la API de HubSpot y por qué recibo errores 429?

Es la pregunta más habitual en los HubSpot Developer Forums. Tanto para las apps privadas como para las apps OAuth, el límite es de 100 solicitudes por periodo de 10 segundos y por cuenta. Los límites diarios varían según el nivel de suscripción.

Al alcanzar estos límites se devuelve el error 429 Too Many Requests. La comunidad recomienda usar API por lotes, sincronizaciones incrementales con hs_lastmodifieddate y respetar la cabecera Retry-After. HubSpot también vende un API Add-On que eleva el límite de ráfaga a 200 por periodo de 10 segundos.

2. ¿Puedo usar objetos personalizados con mi plan de HubSpot?

Los objetos personalizados solo están disponibles en los planes Enterprise. Quienes tienen planes Professional o Starter suelen descubrir esta limitación cuando ya han diseñado su integración en torno a objetos personalizados.

Además, Zapier no admite los objetos personalizados de HubSpot, y la mayoría de las integraciones del Marketplace solo sincronizan objetos estándar. La comunidad suele recomendar usar el pipeline de Tickets como solución alternativa para la gestión de proyectos o el onboarding.

3. ¿Cómo configuro un entorno sandbox en HubSpot?

Las cuentas sandbox de HubSpot están disponibles en los planes Professional y Enterprise. Por defecto, puedes crear un sandbox estándar. Puede sincronizar hasta 5.000 contactos (y los registros asociados) al crearlo, o puedes importar manualmente hasta 200.000 registros por tipo de objeto.

Una limitación clave: las integraciones de tu cuenta de producción no se conectan automáticamente al sandbox. Tienes que volver a configurarlas por separado.

Atención: HubSpot retirará los sandboxes antiguos (legacy) el 16 de marzo de 2026 y los sustituirá por un nuevo sistema de sandbox. Si usas un sandbox antiguo, planifica ya tu migración.

4. ¿Por qué ha dejado de funcionar mi token de OAuth?

Los tokens de acceso OAuth de HubSpot caducan a las 6 horas, y al usar un token de actualización se revoca de inmediato el token de acceso anterior. Si tu gestión de tokens no maneja bien los ciclos de actualización, la integración falla sin avisar o lanza errores 401 Unauthorized.

La solución: implementa una lógica de actualización proactiva de tokens y supervisa las respuestas 401 para activar una nueva autenticación. Esto pilla desprevenidos a muchos desarrolladores que trabajan por primera vez con HubSpot, porque la ventana de 6 horas es más corta que en la mayoría de las plataformas.

5. ¿Puedo usar la licencia gratuita de usuario de integración de Salesforce con HubSpot?

Esta pregunta desató un hilo encendido en la HubSpot Community. Al principio, el propio equipo de HubSpot dijo que la licencia de usuario «Salesforce Integration» no funcionaría con HubSpot y que hacía falta una licencia de usuario completa de Salesforce.

Pero más tarde, miembros de la comunidad confirmaron que sí funciona, siempre que configures los conjuntos de permisos y los grupos de conjuntos de permisos adecuados. La clave es conceder acceso a los objetos concretos que sincroniza HubSpot (contactos, cuentas, oportunidades, etc.) mediante conjuntos de permisos en lugar de acceso basado en perfiles.

Esta pregunta sigue resurgiendo porque las indicaciones oficiales y la experiencia real no siempre coinciden.