Ir a contenido principal
Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado. La versión en inglés se considera, por tanto, la versión oficial y es posible que haya sido actualizada. Para acceder a la versión en inglés, haz clic aquí.

Administrar llamadas de API de integración de Salesforce y errores de sincronización

Última actualización: 27 de mayo de 2025

Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:

Marketing Hub   Pro , Enterprise
Sales Hub   Pro , Enterprise
Service Hub   Pro , Enterprise
Operations Hub   Pro , Enterprise
Content Hub   Pro , Enterprise

La integración HubSpot-Salesforce puede encontrar errores de sincronización, que impiden que los datos se sincronicen. Puedes identificar y resolver estos errores de sincronización en la configuración de integración de Salesforce.

Ajustar el límite de llamadas a la API

  • En tu cuenta de HubSpot, haz clic en el icono de settings Configuración en la barra de navegación superior. En el menú de la barra lateral izquierda, ve a Integraciones > Aplicaciones conectadas.
  • En la lista de aplicaciones conectadas, haga clic en Salesforce
  • En la pestaña Estado de la sincronización , en la sección Uso de llamadas a la API , vea cuántas llamadas a la API ha utilizado en las últimas 24 horas. El número Limitado por Salesforce es la cantidad de llamadas API que puedes hacer en función de tu configuración de Salesforce. Para ajustar cuántas llamadas se pueden asignar a HubSpot, edita el campo Asignado a HubSpot

sync-health-api-call-use

Ver errores de sincronización de Salesforce

  • En tu cuenta de HubSpot, haz clic en el icono de settings Configuración en la barra de navegación superior. En el menú de la barra lateral izquierda, ve a Integraciones > Aplicaciones conectadas.
  • En la lista de aplicaciones conectadas, haga clic en Salesforce
  • En la pestaña Estado de la sincronización, en Errores de sincronización, vea las fichas de cada tipo de error, con el número de errores actuales y de registros afectados. Haz clic en una tarjeta de tipo de error para ver detalles de los errores en el panel derecho. Más información sobre cada tipo de error y recomendaciones de resolución

sync-health-sync-errors

  • Para ver más detalles sobre un error, haga clic en el icono info en la columna Tipo de error .
  • Para actuar sobre registros individuales, haga clic en [#] registros en la columna Registros afectados y, a continuación, haga clic en Acciones > Crear una vista temporal de registros de HubSpot para crear una vista filtrada de los registros afectados. 
  • Una vez resueltos los errores, vuelva a la lista de errores. Selecciona la casilla de comprobación a la izquierda de cualquier error resuelto y haz clic en Volver a sincronizar.
  • Para exportar sus errores, haga clic en Exportar errores (CSV) en la parte superior izquierda de la lista de errores.
captura de pantalla que muestra el botón para exportar los errores de sincronización de Salesforce en HubSpot

Tipos de error de sincronización de Salesforce

Asociaciones

Ejemplos de errores de asociación 

  • Límite de asociación alcanzado
  • Esperando a que se sincronice la cuenta

Significado de los errores

Los registros no se están sincronizando porque están asociados a cuentas de Salesforce que aún no se han sincronizado con empresas de HubSpot o porque están asociados a registros que han alcanzado el límite de asociación de registros de HubSpot. 

Cómo resolver los errores 

Para resolver el error Límite de asociación alcanzado , puede eliminar algunos de los registros asociados o asociarlos a un registro de Salesforce diferente y, a continuación, proceder con la sincronización.

Para resolver el error Esperando a que se sincronice la cuenta , se recomienda ejecutar una importación de cuentas de Salesforce. 

Código personalizado

Ejemplos de errores de código personalizado 

  • Automatización de Salesforce
  • Falta ID de contacto
  • Regla de validación de campos personalizados de Salesforce
  • Flujo de Salesforce

Significado de los errores

Los registros no se están sincronizando debido a un problema causado por automatización, flujos o reglas de validación en su cuenta de Salesforce.

Cómo resolver los errores

Dado que estos errores se originan en Salesforce, se recomienda que trabaje con su administrador de Salesforce para resolver el problema en su código personalizado en Salesforce. 

Duplicados

Ejemplos de errores por duplicado

  • Correo electrónico ya en uso
  • Regla de duplicados de Salesforce

Significado de los errores

Un Lead o contacto de Salesforce no se puede sincronizar con HubSpot porque la dirección de correo electrónico ya existe en un registro de contacto de HubSpot o debido a una regla de desduplicación en Salesforce

Cómo resolver los errores

Para resolver el error Correo electrónico ya en uso , elimine la dirección de correo electrónico del contacto de HubSpot existente.

Para resolver el error de regla de duplicación de Salesforce , se recomienda comprobar las reglas de coincidencia para la desduplicación configuradas en Salesforce

Permisos

Ejemplos de errores de permisos

  • Acceso insuficiente o falta de registro en Salesforce
  • Permiso de campo de Salesforce
  • Acceso insuficiente a Salesforce

Significado de los errores

Los cambios realizados en HubSpot no se pueden sincronizar con Salesforce porque el usuario conectado no tiene acceso al campo o el objeto necesarios en Salesforce.

Cómo resolver los errores

En la mayoría de los casos, el error Acceso insuficiente o falta un registro de Salesforce se produce cuando la integración intenta actualizar un campo de Salesforce con un valor incorrecto o crear una asociación incorrecta. 

Para resolver el error de permiso de campo de Salesforce , asegúrese de que el usuario de integración de Salesforce tiene permisos de Lectura y Edición para el campo en Salesforce. 

El error Acceso insuficiente a Salesforce se produce cuando el usuario de integración de Salesforce no puede realizar la acción en Salesforce debido a sus permisos de usuario en Salesforce. Se recomienda comprobar los permisos de usuario de integración de Salesforce en Salesforce.

Listas de selección

Ejemplos de errores en la lista de selección

  • Falta la opción de lista de selección de Salesforce
  • Valor de estado o país no coincidente
  • Opciones no coincidentes
  • Propietario de Salesforce inactivo
  • Valor restringido de la lista de selección
  • Etapa de oportunidad inactiva
  • Los propietarios de Salesforce no están sincronizados
  • Límite de opciones superado
  • Proceso de venta predeterminado no disponible
  • Etapa de oportunidad no válida o inexistente

Significado de los errores

Los registros no se sincronizan debido a una discrepancia entre los valores de campo de lista de selección en HubSpot y Salesforce. Esto puede suceder cuando un valor de lista de selección en un sistema no coincide con ningún valor actual en el otro, si la lista de selección ha alcanzado un límite de valores o si el valor aprobado no es válido.

Cómo resolver los errores

Para resolver el error Estado o valor de país no coincidentes , se recomienda comprobar que se cumplen los siguientes requisitos:

  • El valor interno de la opción de propiedad País en HubSpot debe coincidir con una opción País existente en sus ajustes de lista de selección Estado y País/Territorio en Salesforce. 
  • El valor Estado debe existir como opción Estado/Provincia disponible para el valor País del registro en Salesforce. Además, el valor interno de la opción de propiedad Estado en HubSpot debe coincidir con una opción de Estado existente en Salesforce. 

Para resolver el error Opciones no coincidentes , se recomienda actualizar el nombre interno/API de las opciones de campo de Salesforce para que coincida con el valor interno de las opciones de propiedad en HubSpot. 

Para resolver el error de propietario inactivo de Salesforce , reasigne el registro de HubSpot a un usuario que sea un usuario activo en Salesforce. 

El error Valor de lista de selección restringido se produce cuando tiene activado el ajuste Restringir lista de selección a los valores definidos en el conjunto de valores para el campo en Salesforce. Cuando esta opción está activada en Salesforce, el valor que está intentando sincronizar de HubSpot a Salesforce debe existir como opción en la lista de selección de Salesforce. Se recomienda desactivar la opción Restringir lista de selección a los valores definidos en el ajuste del conjunto de valores en Salesforce, para que cualquier valor se pueda sincronizar desde HubSpot a Salesforce. 

El error Etapa de oportunidad inactiva se produce cuando una oportunidad de Salesforce con una etapa de oportunidad inactiva intenta sincronizarse con HubSpot. Para resolver este error, cambie la etapa de la oportunidad en Salesforce a activa o mueva la oportunidad a una etapa activa. 

Para resolver el error de propietarios de Salesforce no sincronizados , asegúrese de que los usuarios de Salesforce tienen el tipo de usuario establecido en Estándar, Partner avanzado o Invitado en Salesforce. 

Para resolver el error Option limit exceeded , se recomienda que elimine las opciones de propiedad adicionales en HubSpot y Salesforce que su equipo no esté utilizando. Además, asegúrese de que todas las propiedades asignadas tienen los tipos de campo correspondientes. 

En la mayoría de los casos, el error Proceso de ventas predeterminado no disponible se produce cuando las oportunidades de Salesforce intentan sincronizarse con HubSpot con un Tipo de registro que falta. Si ha activado Tipos de registro en Salesforce, pero no los está utilizando, o tiene oportunidades de Salesforce sin un Tipo de registro, se recomienda que trabaje con Salesforce para desactivar todos los Tipos de registro o crear un nuevo Tipo de registro

Para resolver el error Falta la etapa de oportunidad o no es válida , asegúrese de que el valor de la etapa de oportunidad de Salesforce existe en el pipeline de HubSpot. 

Asignaciones de propiedades

Ejemplos de errores de asignación de propiedades 

  • Tipo incorrecto
  • Falta el ID de Salesforce
  • ID de Salesforce no válido

Significado de los errores

Los registros no se sincronizan debido a una discrepancia en la asignación entre la propiedad de HubSpot y el campo de Salesforce. Esto puede significar que la propiedad y los tipos de campos no son compatibles, que la propiedad o el campo ya no existe o que se debe crear una asignación de campo de referencia de Salesforce.

Cómo resolver los errores 

Para resolver el error Type mismatch , asegúrese de que el tipo de propiedad en HubSpot y el tipo de campo en Salesforce son compatibles. Obtenga más información sobre los tipos de campo de propiedad de HubSpot que se pueden sincronizar con Salesforce

El error Falta ID de Salesforce se produce cuando HubSpot intenta sincronizar un valor distinto de un ID de Salesforce existente con un campo de referencia/consulta en Salesforce. 

Para resolver el error ID de Salesforce no válido , se recomienda que compruebe la regla de validación personalizada que ha configurado en Salesforce

Valores de propiedades

Ejemplos de errores en los valores de la propiedad

  • Cadena demasiado larga
  • Correo electrónico no válido
  • Falta el país requerido
  • Valor no válido
  • Asignación del propietario
  • Valor único restringido
  • Falta el valor requerido

Significado de los errores

Los registros no se sincronizan entre HubSpot y Salesforce porque incluyen valores de propiedad que no son válidos. Estos errores normalmente requieren que los registros afectados individuales se actualicen para corregir el error.

Cómo resolver los errores

Para resolver el error Cadena demasiado larga , acorte el valor del campo en Salesforce o HubSpot, o aumente el límite de caracteres del campo en Salesforce. 

Para resolver el error de correo electrónico no válido , actualiza el formato de la dirección de correo electrónico en el registro de Salesforce que está intentando sincronizarse con HubSpot.

Para resolver el error Falta el país requerido , se recomienda comprobar que se cumplen los siguientes requisitos:

  • El valor interno de la opción de propiedad País en HubSpot debe coincidir con una opción País existente en sus ajustes de lista de selección Estado y País/Territorio en Salesforce. 
  • El valor Estado debe existir como opción Estado/Provincia disponible para el valor País del registro en Salesforce. Además, el valor interno de la opción de propiedad Estado en HubSpot debe coincidir con una opción de Estado existente en Salesforce. 

Para resolver el error Valor no válido, se recomienda actualizar el valor de la propiedad en el registro de Salesforce para cumplir los requisitos de HubSpot para el valor de la propiedad. 

En la mayoría de los casos, el error de asignación de propietario se produce cuando una actividad de HubSpot se sincroniza con Salesforce como una tarea de Salesforce y HubSpot intenta asignar la tarea a un propietario de la cola de Salesforce.

Para resolver el error Valor único restringido, se recomienda que compruebe las reglas de coincidencia para la desduplicación que configuró en Salesforce. 

Para resolver el error Falta valor requerido, añada un valor al registro de Salesforce para cualquier propiedad que esté marcada como requerida en HubSpot. 

Otra opción

Los registros no se sincronizan debido a un error desconocido. Póngase en contacto con el soporte de HubSpot para obtener más ayuda con estos errores.

Nota: es posible realizar una resincronización masiva de 100 errores de Salesforce a la vez. Para sincronizar más de 100 errores, importe los registros desde Salesforce o actualice una propiedad asignada.

Configurar notificaciones de error de sincronización

  • En tu cuenta de HubSpot, haz clic en el icono de settings Configuración en la barra de navegación superior. En el menú de la barra lateral izquierda, ve a Integraciones > Aplicaciones conectadas.
  • En la lista de aplicaciones conectadas, haga clic en Salesforce
  • Haga clic en la pestaña Estado de la sincronización
  • En Errores de sincronización, haz clic en Administrar notificaciones
  • En el cuadro de diálogo, active el interruptor Activar notificaciones
  • Selecciona el botón de radio junto a Instantáneamente, Diario o Semanal para establecer la frecuencia de tus notificaciones. 
  • Haz clic en Guardar

sync-health-error-notifications

¿Te resultó útil este artículo?
Este formulario se utiliza solo para recibir comentarios a la documentación. Cómo recibir ayuda con HubSpot.