Verificado el 16 de septiembre de 2026. Los errores de Workbench pueden interpretarse erróneamente durante un incidente de Salesforce. Un inicio de sesión fallido puede deberse a una sesión caducada, un entorno incorrecto, una ruta de Workbench defectuosa o una interrupción de la API de Salesforce. Una solicitud que devuelve 503 Service Unavailableapunta en una dirección diferente a la de un error 401 Invalid Session, aunque ambos pueden aparecer cuando un desarrollador intenta trabajar rápidamente.
El objetivo de la resolución de problemas no es imponer una solicitud, sino identificar qué capa está fallando, proteger los datos mientras el sistema es inestable y saber cuándo hay suficiente evidencia para esperar, cambiar de herramienta o contactar con el canal de soporte adecuado.
| Lo que ves | Capa más probable | El mejor siguiente paso |
|---|---|---|
| La página de Workbench no se cargará. | Ruta de acceso al sitio de Workbench, navegador, DNS o red. | Abra el estado de confianza de Salesforce y pruebe el sitio desde una red alternativa permitida. |
| El entorno de trabajo se carga, pero el inicio de sesión falla con el error 401. | Sesión, OAuth, nombre de usuario, contraseña o flujo de inicio de sesión | Inicie una nueva sesión autorizada y confirme el entorno seleccionado. |
| La solicitud a la API devuelve 403. | Permisos, política de aplicaciones conectadas o límite de API | Verifique los límites del usuario, la aplicación conectada y las solicitudes; no lo considere como prueba de tiempo de inactividad. |
| Varias llamadas a la API devuelven 500, 502 o 503. | Plataforma Salesforce, enrutamiento perimetral, mantenimiento o sobrecarga | Compare el tiempo de error con el estado de su instancia y producto en Trust. |
| Solo falla una consulta o un objeto. | Sintaxis de la solicitud, acceso a objetos, uso compartido de registros o problema de datos | Reduzca la solicitud a una lectura inofensiva y de buena reputación, e inspeccione el cuerpo de la respuesta. |
Esta tabla es un punto de partida, no un diagnóstico. El mismo código HTTP puede tener diferentes causas según el punto final, el método de autenticación y la política de la organización.
Workbench es una suite basada en navegador para interactuar con organizaciones de Salesforce a través de varias API, incluidas REST, SOAP, Bulk, Streaming, Metadata y herramientas relacionadas con Apex. Sin embargo, el sitio web de Workbench indica que no es un producto oficial de Salesforce y que no ofrece soporte técnico de Salesforce para Workbench. Su página "Acerca de" también advierte a los usuarios que no utilicen la aplicación con datos de producción.
Esa advertencia modifica la forma en que debe actuar durante un período de inactividad. El soporte de Salesforce puede investigar un problema con un servicio, instancia o API de Salesforce, pero es posible que no pueda solucionar todos los problemas de la interfaz de Workbench. Por otro lado, un problema reportado únicamente por Workbench podría deberse a Workbench o a la ruta del navegador, en lugar de a la plataforma de Salesforce.
Siempre que sea posible, mantenga la información de solución de problemas en modo de solo lectura. No pegue contraseñas, secretos de OAuth, identificadores de sesión, tokens de acceso, registros de clientes ni encabezados de solicitud sin censurar en capturas de pantalla, mensajes de chat o informes públicos de incidencias.
Abra el estado de confianza de Salesforce en una pestaña aparte. La documentación de ayuda de Salesforce dirige a los clientes a esta página en caso de interrupciones del producto o degradación del servicio, y el sitio de confianza puede mostrar información sobre productos e instancias específicas.
Compruebe dos vistas:
Una instancia marcada como Disponible no garantiza que todas las operaciones de la API funcionen. Significa que la instancia y sus servicios están disponibles según la definición de estado de Salesforce. La Degradación del rendimiento sugiere que el acceso puede funcionar con latencia o funcionalidad parcial; la Interrupción del servicio significa que la instancia no está disponible; el Mantenimiento indica un evento de mantenimiento que puede o no afectar el acceso.
Workbench puede conectarse a diferentes entornos de Salesforce. Antes de concluir que una API no está disponible, confirme si la solicitud fallida se dirige a producción, a un entorno de pruebas (sandbox) o a otro entorno autorizado. Una prueba exitosa en un entorno no soluciona el problema en el entorno que realmente está fallando.
Utilice el identificador de instancia o de dominio de la organización afectada. Salesforce indica que el prefijo de dominio se puede usar en el estado de confianza, mientras que un administrador puede encontrar la instancia en Configuración, en Información de la empresa . Anote la instancia, el entorno, la versión de la API, la hora aproximada del fallo y el punto final. Este pequeño registro evita un error común: comparar un error de producción con un estado de entorno de pruebas correcto.
Si la página de inicio de sesión de Workbench muestra un método de inicio de sesión no compatible o regresa a la pantalla de inicio de sesión, considérelo como un problema de autenticación o de Workbench independiente hasta que el estado de confianza y un inicio de sesión directo en Salesforce indiquen lo contrario. No envíe credenciales repetidamente durante una posible interrupción del servicio; los reintentos excesivos pueden provocar bloqueos o dificultar la investigación.
La documentación de la API REST de Salesforce explica que el encabezado de respuesta contiene un código de estado HTTP y que el cuerpo suele contener un mensaje y, cuando corresponde, el campo u objeto asociado al error. Conserve ambas evidencias.
| Código | La pista documentada de Salesforce | Cómo interpretarlo durante el tiempo de inactividad |
|---|---|---|
| 400 | La solicitud no pudo ser interpretada, a menudo porque el cuerpo JSON o XML no es válido. | Normalmente, se soluciona la solicitud antes de considerarla una interrupción del servicio. |
| 401 | El ID de sesión o el token de OAuth ha caducado o no es válido. | Vuelva a autenticarse a través de un flujo aprobado; un error 401 por sí solo no es prueba de una interrupción del servicio de la plataforma. |
| 403 | La solicitud fue rechazada, a menudo debido a problemas de permisos o a un límite de la API. | Verifique los permisos y límites antes de convertirlo en un incidente de disponibilidad. |
| 500 | Se ha producido un error en la plataforma Lightning. | Inténtelo de nuevo solo después de registrar la respuesta; compare los fallos repetidos con el estado de confianza. |
| 502 | Salesforce Edge no pudo comunicarse correctamente con la instancia. | Es posible que exista un problema de enrutamiento o del lado de la plataforma, especialmente al tratarse de múltiples solicitudes. |
| 503 | El servidor no está disponible; puede deberse a tareas de mantenimiento o a una sobrecarga. | Verifique si hay algún incidente o evento de mantenimiento y evite reintentos destructivos. |
Una vez que conozca el estado y el entorno, utilice la prueba de solo lectura más pequeña permitida. Una buena comparación tiene tres características: se dirige a la organización afectada, no modifica los datos y es lo suficientemente simple como para que sea improbable un error en el formato de la solicitud.
No utilice las solicitudes de escritura, eliminación, actualización masiva, implementación de metadatos o migración como comprobación de estado. Durante un incidente, una escritura puede generar resultados parciales, duplicar el trabajo o dar la falsa impresión de que se ha producido una recuperación.
Deja de rediseñar la consulta a menos que tengas evidencia independiente de que la solicitud está mal formada. Guarda el número de incidente, el servicio afectado, la instancia, la hora de inicio y la última actualización. Sigue los mensajes de recuperación de Salesforce y protege el trabajo en cola de reintentos duplicados.
Concéntrese en Workbench, el navegador, la red, la autenticación o la política local. Pruebe con una ventana de navegación privada, un navegador alternativo compatible y una comparación de red permitida. El sitio de Workbench dirige la asistencia específica de Workbench a sus recursos de la comunidad de código abierto, mientras que la Ayuda de Salesforce sigue siendo la vía para obtener asistencia sobre productos y cuentas de Salesforce.
Pase al análisis de identidad y autorización. Confirme el usuario, la política de la aplicación conectada, el alcance de OAuth, la antigüedad de la sesión, el acceso a la API, el perfil o el conjunto de permisos y los límites de la organización. Actualizar repetidamente el navegador no solucionará un permiso faltante ni un token no válido.
Investiga el punto final, el objeto, el campo, el uso compartido de registros, la versión de la API, el cuerpo de la solicitud y el cuerpo de la respuesta. Un fallo puntual no basta para declarar a Salesforce inoperativo globalmente. Reduce la solicitud hasta que puedas identificar si el problema es de sintaxis, acceso, datos o un servicio dependiente.
Si el problema con Salesforce persiste, utilice la guía oficial de soporte de Salesforce para el canal disponible en su Plan de éxito. Incluya:
Elimine las credenciales, los ID de sesión, los tokens de acceso, los nombres de clientes, los ID de registro y las cargas útiles confidenciales antes de enviar los registros. Si el problema se limita a Workbench, utilice la opción de soporte técnico que se indica en la página de ayuda de Workbench ; Salesforce no ofrece soporte técnico para Workbench.
Un indicador de estado verde es alentador, pero no es la meta final. Verifique la recuperación por capas:
El resultado que busca no es simplemente que "la página se haya abierto". Busca que la operación autorizada original se complete con éxito, con la respuesta esperada y sin efectos secundarios no revisados.
Para errores de Salesforce Workbench durante el tiempo de inactividad, comience con el estado de confianza y la instancia afectada, luego clasifique la respuesta HTTP antes de cambiar las credenciales o reescribir las solicitudes. Un error 500, 502 o 503 repetido en pruebas simples de solo lectura y un incidente de confianza coincidente respaldan una explicación del lado de Salesforce. Un error 401, 403, 400 o un fallo exclusivo de Workbench generalmente requiere la resolución de problemas de autenticación, permisos, solicitud, navegador o Workbench. Dado que Workbench no es un producto compatible con Salesforce, mantenga los datos de producción fuera de él, documente claramente los límites y utilice la guía de soporte y estado oficial más reciente cuando cambie la evidencia.
Una guía práctica para 2026 sobre inteligencia artificial, sensores para hogares inteligentes, monitorización remota, seguridad contra caídas, privacidad y cómo la tecnología puede facilitar el envejecimiento en el hogar sin sustituir la atención médica.
Descubre cómo las ciudades pueden transformar los datos sobre movilidad, uso del suelo, clima y comunidad en barrios más seguros, más ecológicos y más transitables a pie, sin anteponer la tecnología a las personas.
Compara los principales programas de ingeniería aeroespacial y de vehículos aéreos no tripulados (UAV) en las áreas de drones, autonomía, sistemas de control, operaciones con sistemas aéreos no tripulados (UAS) e investigación de posgrado, con actualizaciones verificadas hasta 2026.
A practical guide to AI-powered surgical robotics: current capabilities, levels of autonomy, precision benefits, limits, regulation, and evaluation criteria.
La inversión en CCUS está en aumento, pero ¿puede la captura de carbono revertir las emisiones globales? Descubra dónde funciona, qué limita su escala y qué evidencia es relevante.
Compare siete programas globales para cadenas de suministro digitales, logística, análisis, comercio global y operaciones, con orientación práctica para elegir el más adecuado.
Descubre cómo las interfaces cerebro-computadora decodifican las señales neuronales para restaurar la comunicación y el movimiento, qué han logrado los estudios recientes y qué limita aún el uso de las interfaces cerebro-computadora.
Descubre cómo los drones comerciales combinan sensores, IA en el borde, baterías, comunicaciones y software de control de vuelo, y dónde la autonomía aún depende de la misión y la normativa.
Compare siete opciones destacadas de fabricantes líderes en baterías y almacenamiento de energía, teniendo en cuenta los materiales, los sistemas, la investigación, la experiencia en la industria, la flexibilidad, el idioma y la relación costo-beneficio.
Aprenda cómo la masa de la carga útil, los límites de la batería, las condiciones meteorológicas, la eficiencia de la propulsión y la arquitectura de la aeronave influyen en la autonomía de los UAV industriales, y cómo mejorarla.
