Cuando Fin encuentra un problema al conectarse con Salesforce, los detalles aparecen en Error logs. 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).
Funcionalidad del producto – dónde 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 error logs
Ve a Settings > Error logs.
Selecciona cualquier error relacionado con Salesforce para abrir el panel de Detalles del error.
Consejo: Puedes hacer clic en Review setup para abrir directamente desde los error logs 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 iniciar una importación de knowledge, 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 knowledge article.
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 en Salesforce. Verifica si se han realizado actualizaciones.
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, por favor contacta a nuestro equipo de soporte para asistencia.
Errores con Salesforce Cases
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 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: 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 al campo.
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 workflow para asegurar que el campo picklist que causa el error de picklist restringido esté configurado correctamente.
Si no quieres que el workflow establezca este campo, configura un Salesforce Flow para establecer o asignar por defecto el valor correcto al 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 siguiente 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: Case
Síntoma: Las respuestas del cliente a un case existente están creando nuevas conversaciones en tu espacio de trabajo Fin en lugar de enlazarse al case original.
Cómo solucionar este error: Esto ocurre cuando Lightning threading no está habilitado en Salesforce. Sin él, Salesforce no conserva los encabezados del hilo de correo electrónico que Fin usa para relacionar las respuestas entrantes con el case 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 cases y correos, no solo los manejados por Fin. Si tu equipo depende de que threading esté desactivado para otros workflows, revisa el impacto en tu configuración de Salesforce antes de habilitarlo.
Objeto: EmailMessage
Código de error: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
Cómo solucionar este error: El objeto EmailMessage de Salesforce 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 Case de Salesforce 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 case con texto enriquecido.
Ve a Salesforce Setup → Chatter Settings
Haz clic en Edit
En Publicaciones de texto enriquecido habilita “Permitir a los usuarios 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 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 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 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 establecer 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 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 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 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.
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 Salesforce Setup → Chatter Settings
Haz clic en Edit
En Publicaciones de texto enriquecido habilita “Permitir a los usuarios 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 obtener 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 caso.
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, haz una de las siguientes acciones:
Ve a Configuración de Salesforce → Enhanced Email y habilita Enhanced Email.
Desactiva la sincronización del historial de conversaciones. Ve a Fin Workspace → Settings → Salesforce integration y desactiva Sync case history from Salesforce.
Estamos trabajando activamente para soportar organizaciones de Salesforce sin Enhanced Email. Contacta 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úrate 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. Consulta Habilitar Digital Experiences en Salesforce para activarlo.
Si el problema persiste una vez habilitado, comparte los detalles del error con tu administrador de Salesforce o contacta 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. Verifica que el usuario de Salesforce que conectó Fin tenga permiso para acceder a estos campos.
Si el problema continúa, comparte los detalles del error con tu administrador de Salesforce o contacta 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 puedes hacer clic en Copiar todos los detalles en cualquier panel de error para copiar el registro completo y reportarlo o compartirlo.
¿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.