Cuando Fin encuentra un problema al conectarse con Salesforce, los detalles aparecen en Registros de errores. Esta guía te ayuda a entender rápidamente qué significa cada error y cómo solucionarlo.
Cada entrada de error incluye:
Código de error – un identificador único para el error.
Error del sistema – el mensaje devuelto por Salesforce.
Ruta de la solicitud – El endpoint específico de la API de Salesforce que provocó el error.
Método de solicitud – El método HTTP utilizado (por ejemplo, GET, POST o PATCH).
Código de estado – El código de respuesta HTTP devuelto por Salesforce (por ejemplo, 400 o 403).
Función del producto – donde ocurrió el problema (por ejemplo, Historical Conversations Import).
Tipo de API y Tipo de objeto – detalles técnicos para ayudar a identificar qué objeto de datos o endpoint de Salesforce está afectado.
Cómo acceder a los registros de errores
Selecciona cualquier error relacionado con Salesforce para abrir el panel de Detalles del error.
Consejo: Puedes hacer clic en Revisar configuración para abrir directamente desde los registros de errores la configuración relevante de conexión o permisos de Salesforce.
Cómo solucionar errores comunes de integración
Errores con la importación de knowledge
Objeto: Knowledge__kav
Código de error: INVALID_QUERY_FILTER_OPERATOR
Mensaje: Filtro inválido en la consulta de knowledge article, probablemente debido a una incompatibilidad de tipo de datos.
Cómo solucionar este error:
Revisa tus filtros y vuelve a intentar sincronizar tus artículos.
Si la sincronización funcionaba antes, el error puede deberse a cambios en los campos de knowledge article de Salesforce. Verifica si algún campo usado en tus filtros ha sido actualizado en Salesforce.
Objeto: Knowledge__kav
Código de error: MALFORMED_QUERY
Mensaje: Valores de filtro inválidos en la consulta de knowledge article.
Cómo solucionar este error:
Revisa tus filtros y vuelve a intentar sincronizar tus artículos.
Si la sincronización funcionaba antes, el error puede deberse a cambios en los campos de knowledge article de Salesforce. Verifica si algún campo usado en tus filtros ha sido actualizado en Salesforce.
Objeto: Knowledge__kav
Código de error: NOT_FOUND
Mensaje: No se encontró el knowledge article solicitado.
Cómo solucionar este error: Al activar una importación de knowledge, recopilamos una instantánea de los artículos que necesitan sincronizarse y luego iniciamos la sincronización. Entre la recopilación y la sincronización, parece que un artículo fue eliminado y ya no es consultable. No hay más acciones que tomar, salvo quizás reinstaurar el artículo eliminado.
Objeto: Knowledge__kav
Código de error: INVALID_FIELD
Mensaje: Hubo algunos problemas al construir la consulta de knowledge article.
Cómo solucionar este error:
Revisa y actualiza tus filtros e intenta sincronizar nuevamente la selección de artículos.
Si la sincronización funcionaba antes, el error puede deberse a cambios en los permisos o visibilidad de los campos usados en tus filtros. Verifica si se han realizado actualizaciones en Salesforce.
Objeto: Knowledge__kav
Código de error: UNKNOWN
Mensaje: Hubo algunos problemas al construir la consulta de knowledge article.
Cómo solucionar este error: Actualmente solo soportamos importar objetos Knowledge__kav como artículos de Salesforce. Si tu organización Salesforce usa un objeto diferente, contacta a nuestro equipo de soporte para asistencia.
Errores con Cases de Salesforce
Objeto: Case
Código de error: INVALID_FIELD_FOR_INSERT_UPDATE
Mensaje: El usuario de integración no tiene permisos para actualizar los campos de auditoría en el objeto.
Cómo solucionar este error:
Si el error es que Fin no puede establecer CreatedById o LastModifiedById:
Ve a Configuración de Salesforce → Interfaz de usuario.
Habilita los permisos “Set Audit Fields upon Record Creation” y “Update Records with Inactive Owners”.
(Consulta Habilitar el permiso 'Create Audit Fields' en Salesforce)
Si el error es sobre cualquier otro campo:
Comparte los detalles del error con tu administrador de Salesforce o contacta a nuestro equipo de soporte para ayuda.
Objeto: Case
Código de error: FIELD_CUSTOM_VALIDATION_EXCEPTION
Cómo solucionar este error:
Haz una de las siguientes acciones:
Verifica que el campo que causa el error de validación personalizada se esté configurando correctamente en el flujo de trabajo.
Si no quieres que el flujo de trabajo establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el valor correcto.
Objeto: Case
Código de error: CANNOT_EXECUTE_FLOW_TRIGGER
Cómo solucionar este error: Un flujo o proceso en tu organización Salesforce está generando un error cuando Fin actualiza o crea un Case.
Comparte los detalles del error del sistema con tu administrador de Salesforce para que pueda resolver el problema en el flujo o proceso de Salesforce.
Objeto: Case
Código de error: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Cómo solucionar este error:
Haz una de las siguientes acciones:
Actualiza el flujo de trabajo para asegurar que el campo picklist que causa el error de picklist restringido esté configurado correctamente.
Si no quieres que el flujo de trabajo establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el valor correcto del campo picklist.
Objeto: Case
Código de error: UNABLE_TO_LOCK_ROW
Cómo solucionar este error: Fin no pudo actualizar el Case de Salesforce porque otro proceso lo estaba actualizando al mismo tiempo. Algunas actualizaciones del Case pueden no haberse guardado.
Si Fin sigue asignado al Case, la próxima actualización intentará automáticamente de nuevo.
Si Fin ya no está asignado, es posible que necesites copiar manualmente cualquier actualización de la conversación de Fin al Case de Salesforce.
Objeto: EmailMessage
Código de error: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
Cómo solucionar este error: El objeto EmailMessage de Salesforce hace referencia al Case a través de ParentId y a un User mediante CreatedById y LastModifiedById. Asegúrate de que el User de Salesforce que conectó Fin tiene permiso para acceder tanto al Case como a los objetos User.
Si tu Organización de Salesforce usa Enhanced Email, Salesforce también creará Tareas a partir de los registros de EmailMessage. En este caso, asegúrate de que el mismo usuario tenga permiso para acceder a las Tareas, si el primer paso no resuelve el problema.
Objeto: EmailMessage
Código de error: UNABLE_TO_LOCK_ROW
Cómo solucionar este error: Fin no pudo crear un EmailMessage para el Case de Salesforce porque otro proceso estaba actualizando el Case al mismo tiempo.
Si Fin sigue asignado al Case, la próxima actualización creará automáticamente el EmailMessage y enviará el correo electrónico de nuevo.
Objeto: EmailMessage
Código de error: INVALID_FIELD_FOR_INSERT_UPDATE
Cómo solucionar este error: Si el error es porque Fin no puede establecer CreatedById o LastModifiedById:
Ve a Configuración de Salesforce → Interfaz de Usuario.
Habilita los permisos “Set Audit Fields upon Record Creation” y “Update Records with Inactive Owners”.
(Consulta Habilitar el permiso 'Create Audit Fields' en Salesforce)
Si el error es sobre cualquier otro campo:
Comparte los detalles del error con tu administrador de Salesforce o contacta a nuestro equipo de soporte para ayuda.
Objeto: FeedItem
Código de error: UNKNOWN_EXCEPTION
Mensaje: El usuario de contexto no tiene permiso para crear texto enriquecido en el feed
Cómo solucionar este error: Fin necesita la capacidad de crear elementos de feed de case con texto enriquecido.
Ve a Configuración de Salesforce → Configuración de Chatter
Haz clic en Editar
En Publicaciones con texto enriquecido habilita “Permitir a los users redactar publicaciones con texto enriquecido”
Haz clic en Guardar.
Si el error es sobre cualquier otro campo:
Comparte los detalles del error con tu administrador de Salesforce o contacta a nuestro equipo de soporte para ayuda.
Errores con Fin Messenger
Objeto: Case
Código de error: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Mensaje: Valor incorrecto seleccionado para el campo de lista restringida.
Cómo solucionar este error:
Haz una de las siguientes acciones:
Actualiza el workflow para asegurar que el campo de lista que causa el error de lista restringida esté configurado correctamente.
Si no quieres que el workflow establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el campo de lista al valor correcto.
Objeto: Case
Código de error: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
Cómo solucionar este error: Fin no puede crear un Case durante el paso Crear Case de Salesforce en el workflow de Fin messenger. Asegúrate de que el usuario de Salesforce que conectó Fin a Salesforce tiene permiso para acceder al objeto Case.
Objeto: Case
Código de error: FIELD_CUSTOM_VALIDATION_EXCEPTION
Mensaje: Valor incorrecto seleccionado para el campo de lista restringida.
Cómo solucionar este error:
Haz una de las siguientes acciones:
Actualiza el workflow para asegurar que el campo que causa el error de validación esté configurado correctamente.
Si no quieres que el workflow establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el campo al valor correcto.
Objeto: Case
Código de error: REQUIRED_FIELD_MISSING
Cómo solucionar este error:
Haz una de las siguientes acciones:
Actualiza el workflow para asegurar que el campo que causa el error de validación esté configurado correctamente.
Si no quieres que el workflow establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el campo al valor correcto.
Nota: Si el campo no es visible como un paso de configuración de datos, ve a Deploy > Fin Messenger > Data y selecciona el campo Case en la sección Extraer datos de Salesforce.
Objeto: Case
Código de error: INVALID_FIELD_FOR_INSERT_UPDATE
Cómo solucionar este error: Fin no puede establecer ciertos campos en el objeto Case de Salesforce. Asegúrate de que el usuario de Salesforce que conectó Fin tiene los permisos correctos en el objeto Case.
Si el problema continúa, comparte los detalles del error con tu administrador de Salesforce o contacta a nuestro equipo de soporte para asistencia.
Objeto: Case
Código de error: INVALID_EMAIL_ADDRESS
Cómo solucionar este error: Fin no pudo crear un objeto Case de Salesforce. Por favor, verifica que el correo electrónico proporcionado a Fin sea válido.
Objeto: Case
Código de error: CANNOT_EXECUTE_FLOW_TRIGGER
Cómo solucionar este error: Un flujo o proceso en tu Organización de Salesforce está generando un error cuando Fin actualiza o crea un Case. Comparte los detalles del error del sistema con tu administrador de Salesforce para que puedan resolver el problema.
Objeto: FeedItem
Código de error: UNKNOWN_EXCEPTION
Mensaje: El usuario de contexto no tiene permiso para crear texto enriquecido en el feed
Cómo solucionar este error: Fin necesita la capacidad de crear elementos de feed de case con texto enriquecido.
Ve a Configuración de Salesforce → Configuración de Chatter
Haz clic en Editar
En Publicaciones con texto enriquecido habilita “Permitir a los users redactar publicaciones con texto enriquecido”
Haz clic en Guardar.
Si el error es sobre cualquier otro campo:
Comparte los detalles del error con tu administrador de Salesforce o contacta a nuestro equipo de soporte para ayuda.
Errores con el historial de sincronización de casos
Objeto: Emails
Código de error: INVALID_TYPE
Mensaje: El usuario de integración no puede acceder a los mensajes de correo electrónico adjuntos al case.
Cómo solucionar este error: Fin no puede acceder a la relación Emails en el objeto Case de Salesforce. Esto probablemente se debe a que Enhanced Email no está habilitado en tu Organización de Salesforce.
Para resolver esto, haga una de las siguientes acciones:
Vaya a Salesforce Setup → Enhanced Email y habilite Enhanced Email.
Desactive la sincronización del historial de conversaciones. Vaya a Fin Workspace → Settings → Salesforce integration y desactive Sync case history from Salesforce.
Estamos trabajando activamente para soportar organizaciones de Salesforce sin Enhanced Email. Contacte a nuestro equipo de soporte para las últimas actualizaciones.
Object: CaseFeed
Error code: INVALID_FIELD
Message: El workspace necesita que Digital Experiences esté habilitado.
How to fix this error: Fin no puede consultar el campo Visibility en el objeto Salesforce CaseFeed. Asegúrese de que el usuario de Salesforce que conectó Fin tenga permiso para acceder a este campo.
El campo Visibility solo está disponible cuando Digital Experiences está habilitado en Salesforce. Este campo es necesario para determinar si un comentario es interno o público. Consulte Enable Digital Experiences in Salesforce para habilitarlo.
Si el problema persiste una vez habilitado, comparta los detalles del error con su administrador de Salesforce o contacte a nuestro equipo de soporte.
Object: Case
Error code: INVALID_FIELD
How to fix this error: Fin no puede consultar ciertos campos en el objeto Salesforce Case. Verifique que el usuario de Salesforce que conectó Fin tenga permiso para acceder a estos campos.
Si el problema continúa, comparta los detalles del error con su administrador de Salesforce o contacte a nuestro equipo de soporte.
Preguntas frecuentes
¿Cómo sé si un error está relacionado con Salesforce?
Los errores relacionados con Salesforce mostrarán API type: Salesforce REST API en los detalles del error.
¿Puedo exportar los registros de errores de Salesforce?
Aún no, pero puede hacer clic en Copy all details en cualquier panel de error para copiar el registro completo para reportar o compartir.
¿Dónde puedo ver los errores resueltos?
Los problemas resueltos se eliminan automáticamente de la vista Error logs una vez que Fin se reconecta con éxito o reintenta la solicitud fallida.