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 la 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 – dónde ocurrió el problema (por ejemplo, Importación de Conversaciones Históricas).
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 al conectar con Salesforce
Código de error: OAUTH_EC_APP_NOT_FOUND
Cuándo aparece: cuando conectas Fin a Salesforce.
Cómo solucionar este error: El paquete Fin para Salesforce no está instalado en la organización a la que te conectas, o no está en la versión más reciente.
Instala o actualiza el paquete Fin para Salesforce en esa organización exacta de Salesforce.
Reconecta Fin a Salesforce.
Reinstalar el paquete no afecta a otros espacios de trabajo de Fin.
Errores con la importación de conocimiento
Objeto: Knowledge__kav
Código de error: INVALID_QUERY_FILTER_OPERATOR
Mensaje: Filtro inválido en la consulta de artículos de conocimiento, 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 artículos de conocimiento 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 artículos de conocimiento.
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 artículos de conocimiento 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 artículo de conocimiento solicitado.
Cómo solucionar este error: Al iniciar una importación de conocimiento, recopilamos una instantánea de los artículos que necesitan sincronizarse y luego comenzamos 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 restaurar el artículo eliminado.
Objeto: Knowledge__kav
Código de error: INVALID_FIELD
Mensaje: Hubo algunos problemas al construir la consulta de artículos de conocimiento.
Cómo solucionar este error:
Revisa y actualiza tus filtros y vuelve a intentar sincronizar 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 hecho actualizaciones en Salesforce.
Objeto: Knowledge__kav
Código de error: UNKNOWN
Mensaje: Hubo algunos problemas al construir la consulta de artículos de conocimiento.
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, por favor contacta a nuestro equipo de soporte para asistencia.
Errores con Casos 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 workflow.
Si no quieres que el workflow 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 Caso.
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 workflow para asegurarte de que el campo picklist que causa el error de restricted picklist esté configurado correctamente.
Si no quieres que el workflow establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el campo picklist con el valor correcto.
Objeto: Case
Código de error: UNABLE_TO_LOCK_ROW
Cómo solucionar este error: Fin no pudo actualizar el Salesforce Case porque otro proceso lo estaba actualizando al mismo tiempo. Algunas actualizaciones del Case pueden no haberse guardado.
Si Fin sigue asignado al Case, la siguiente actualización intentará automáticamente de nuevo.
Si Fin ya no está asignado, puede que necesites copiar manualmente cualquier actualización de la conversación de Fin al Salesforce Case.
Objeto: Case
Síntoma: Las respuestas del cliente a un caso existente están creando nuevas conversaciones en tu espacio de trabajo Fin en lugar de enlazarse al caso original.
Cómo solucionar este error: Esto ocurre cuando Lightning threading no está habilitado en Salesforce. Sin esto, Salesforce no conserva los encabezados del hilo de correo electrónico que Fin usa para relacionar las respuestas entrantes con el caso original.
Ve a Salesforce Setup → Email → Email-to-Case.
Habilita Lightning Threading y guarda tus cambios.
Nota: Lightning threading se aplica a toda tu organización Salesforce — afecta todos los casos y correos, no solo los manejados por Fin. Si tu equipo depende de que el threading esté desactivado para otros workflows, revisa el impacto en toda tu configuración Salesforce antes de habilitarlo.
Objeto: EmailMessage
Código de error: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
Cómo solucionar este error: El objeto Salesforce EmailMessage referencia el Case vía ParentId y un User vía CreatedById y LastModifiedById. Asegúrate de que el User de Salesforce que conectó Fin tenga permiso para acceder tanto al Case como a los objetos User.
Si tu Organización Salesforce usa Enhanced Email, Salesforce también creará Tasks a partir de registros EmailMessage. En este caso, asegúrate de que el mismo user tenga permiso para acceder a Tasks, 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 Salesforce Case porque otro proceso estaba actualizando el Case al mismo tiempo.
Si Fin sigue asignado al Case, la siguiente actualización creará automáticamente el EmailMessage y enviará el correo 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 Salesforce Setup → User Interface.
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 caso con texto enriquecido.
Ve a Salesforce Setup → Chatter Settings
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 restricted picklist.
Cómo solucionar este error:
Haz una de las siguientes acciones:
Actualiza el workflow para asegurarte de que el campo picklist que causa el error de restricted picklist esté configurado correctamente.
Si no quieres que el workflow establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el campo picklist con el 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 Create Salesforce Case en el workflow de Fin messenger. Asegúrate de que el user de Salesforce que conectó Fin a Salesforce tenga permiso para acceder al objeto Case.
Objeto: Case
Código de error: FIELD_CUSTOM_VALIDATION_EXCEPTION
Mensaje: Valor incorrecto seleccionado para el campo restricted picklist.
Cómo solucionar este error:
Haz una de las siguientes acciones:
Actualiza el workflow para asegurarte de 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 con el 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 asegurarte de 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 con el valor correcto.
Nota: Si el campo no es visible como un paso de Set data, ve a Deploy > Fin Messenger > Data y selecciona el campo Case en la sección Pull data from 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 Salesforce Case. Asegúrate de que el user de Salesforce que conectó Fin tenga 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 Salesforce Case. 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 su Organización Salesforce está generando un error cuando Fin actualiza o crea un Case. Comparta los detalles del error del sistema con su 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.
Vaya a Configuración de Salesforce → Configuración de Chatter
Haga clic en Editar
En Publicaciones con texto enriquecido active “Permitir a los usuarios redactar publicaciones con texto enriquecido”
Haga clic en Guardar.
Si el error es sobre cualquier otro campo:
Comparta los detalles del error con su administrador de Salesforce o contacte a nuestro equipo de soporte para obtener ayuda.
Error: Incompatibilidad en el modo de autenticación en Fin Messenger con Salesforce Messaging
Cómo solucionar este error: Los visitantes conectados siempre envían tokens autenticados, por lo que el canal de mensajería de Salesforce debe aceptarlos.
En Salesforce, vaya a Configuración → Configuración de mensajería y seleccione el canal.
Active Verificación de usuario para el canal de mensajería.
Configure la verificación de identidad para Fin Messenger.
Errores con la sincronización del historial de case
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 su Organización Salesforce.
Para resolver esto, haga una de las siguientes acciones:
Vaya a Configuración de Salesforce → Enhanced Email y habilite Enhanced Email.
Desactive la sincronización del historial de conversación. Vaya a Fin Workspace → Configuración → integración de Salesforce y desactive Sincronizar historial de case desde Salesforce.
Estamos trabajando activamente para soportar organizaciones Salesforce sin Enhanced Email. Contacte a nuestro equipo de soporte para las últimas actualizaciones.
Objeto: CaseFeed
Código de error: INVALID_FIELD
Mensaje: El workspace necesita que Digital Experiences esté habilitado.
Cómo solucionar este error: Fin no puede consultar el campo Visibility en el objeto CaseFeed de Salesforce. 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 Habilitar Digital Experiences en Salesforce para activarlo.
Si el problema persiste una vez habilitado, comparta los detalles del error con su administrador de Salesforce o contacte a nuestro equipo de soporte.
Objeto: Case
Código de error: INVALID_FIELD
Cómo solucionar este error: Fin no puede consultar ciertos campos en el objeto Case de Salesforce. 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?
Todavía no, pero puede hacer clic en Copiar todos los detalles 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 Registros de errores una vez que Fin se reconecta o reintenta la solicitud fallida con éxito.