Verificado em 16 de setembro de 2026. Erros do Workbench são fáceis de serem interpretados erroneamente durante um incidente do Salesforce. Uma falha de login pode ser causada por uma sessão expirada, um ambiente incorreto, uma rota do Workbench quebrada ou uma interrupção da API do Salesforce. Uma solicitação que retorna um 503 Service Unavailableerro pode apontar para uma direção diferente de um erro de login 401 Invalid Session, embora ambos possam ocorrer quando um desenvolvedor está tentando trabalhar rapidamente.
O objetivo da resolução de problemas não é forçar a aprovação de uma solicitação. É identificar qual camada está falhando, proteger os dados enquanto o sistema estiver instável e saber quando as evidências são fortes o suficiente para esperar, trocar de ferramenta ou entrar em contato com o canal de suporte adequado.
| O que você vê | Camada mais provável | Melhor próximo passo |
|---|---|---|
| A página da área de trabalho não carrega. | Site do Workbench, navegador, DNS ou caminho de rede | Abra o Status de Confiança do Salesforce e teste o site a partir de uma rede alternativa permitida. |
| A área de trabalho carrega, mas o login falha com o erro 401. | Sessão, OAuth, nome de usuário, senha ou fluxo de login | Inicie um novo login autorizado e confirme o ambiente selecionado. |
| A solicitação à API retornou 403. | Permissões, política de aplicativos conectados ou limite de API | Verifique os limites de usuário, aplicativo conectado e requisição; não interprete isso como prova de indisponibilidade do serviço. |
| Diversas chamadas à API retornam 500, 502 ou 503. | Plataforma Salesforce, roteamento de borda, manutenção ou sobrecarga | Compare o tempo de erro com o status da sua instância e do produto no Trust. |
| Apenas uma consulta ou objeto falha. | Problema com a sintaxe da solicitação, acesso a objetos, compartilhamento de registros ou dados | Reduza a solicitação a uma leitura inofensiva e comprovadamente válida e inspecione o corpo da resposta. |
Esta tabela é um ponto de partida, não um diagnóstico. O mesmo código HTTP pode ter causas diferentes dependendo do endpoint, do método de autenticação e da política da organização.
O Workbench é um conjunto de ferramentas baseado em navegador para interação com organizações Salesforce por meio de diversas APIs, incluindo REST, SOAP, Bulk, Streaming, Metadados e ferramentas relacionadas ao Apex. No entanto, o site do Workbench afirma que não é um produto oficial da Salesforce e que o suporte da Salesforce não está disponível para o próprio Workbench. Sua página "Sobre" também alerta os usuários para não utilizarem o aplicativo com dados de produção.
Esse aviso altera a forma como você deve reagir durante períodos de inatividade. O Suporte da Salesforce pode investigar problemas em serviços, instâncias ou APIs da Salesforce, mas pode não solucionar todos os comportamentos da interface do Workbench. Por outro lado, um problema relatado apenas pelo Workbench pode ser específico do Workbench ou do caminho do navegador, e não da plataforma Salesforce.
Mantenha as informações de solução de problemas em modo somente leitura sempre que possível. Não cole senhas, segredos OAuth, IDs de sessão, tokens de acesso, registros de clientes ou cabeçalhos de solicitação não editados em capturas de tela, mensagens de bate-papo ou relatórios de problemas públicos.
Abra o Status de Confiança do Salesforce em uma aba separada. A documentação de ajuda do Salesforce direciona os clientes para esta página em caso de interrupções de produtos e degradação de serviços, e o site de Confiança pode exibir informações sobre produtos, bem como instâncias específicas.
Confira duas perspectivas:
Uma instância marcada como Disponível não garante que todas as operações da API funcionarão. Significa que a instância e seus serviços estão disponíveis de acordo com a definição de status da Salesforce. Degradação de desempenho sugere que o acesso pode funcionar com latência ou funcionalidade parcial; Interrupção de serviço significa que a instância está indisponível; Manutenção indica um evento de manutenção que pode ou não afetar o acesso.
O Workbench pode se conectar a diferentes ambientes do Salesforce. Antes de concluir que uma API está inativa, confirme se a solicitação com falha se destina à produção, a um ambiente de teste (sandbox) ou a outro ambiente autorizado. Um teste bem-sucedido em um ambiente não resolve o problema no ambiente que está apresentando a falha.
Use o identificador do Meu Domínio ou da instância da organização afetada. A Salesforce documenta que o prefixo do Meu Domínio pode ser usado no Status de Confiança, enquanto um administrador pode encontrar a instância em Configuração, em Informações da Empresa . Anote a instância, o ambiente, a versão da API, o horário aproximado da falha e o endpoint. Esse pequeno registro evita um erro comum: comparar um erro de produção com o status de um ambiente de teste (sandbox) íntegro.
Se a própria página de login do Workbench exibir um método de login não compatível ou retornar à tela de login, trate isso como um problema de autenticação ou do Workbench separado até que o Status de Confiança e um login direto no Salesforce indiquem o contrário. Não envie credenciais repetidamente durante uma possível interrupção; tentativas excessivas podem causar bloqueios ou gerar ruído na investigação.
A documentação da API REST da Salesforce explica que o cabeçalho da resposta contém um código de status HTTP e que o corpo geralmente contém uma mensagem e, quando relevante, o campo ou objeto associado ao erro. Preserve ambas as informações.
| Código | A pista documentada da Salesforce | Como interpretar isso durante o período de inatividade |
|---|---|---|
| 400 | A solicitação não pôde ser compreendida, geralmente porque o corpo JSON ou XML é inválido. | Normalmente, corrige-se a solicitação antes de tratá-la como uma interrupção. |
| 401 | O ID da sessão ou o token OAuth expirou ou é inválido. | Autentique-se novamente por meio de um fluxo aprovado; um erro 401 por si só não é evidência de uma interrupção da plataforma. |
| 403 | A solicitação foi recusada, geralmente devido a problemas de permissão ou a um limite da API. | Verifique o acesso e os limites antes de reportar um incidente de disponibilidade. |
| 500 | Ocorreu um erro na plataforma Lightning. | Tente novamente somente após registrar a resposta; compare as falhas repetidas com o Status de Confiança. |
| 502 | O Salesforce Edge não conseguiu se comunicar com a instância. | É possível que ocorra um problema de roteamento ou do lado da plataforma, especialmente em várias solicitações. |
| 503 | O servidor está indisponível; pode estar em manutenção ou sobrecarregado. | Verifique se houve algum incidente ou evento de manutenção e evite novas tentativas destrutivas. |
Após conhecer o status e o ambiente, utilize o teste somente leitura mais simples possível. Uma boa comparação deve ter três características: deve ser direcionada à organização afetada, não deve modificar os dados e deve ser simples o suficiente para que um erro no formato da requisição seja improvável.
Não utilize solicitações de gravação, exclusão, atualização em massa, implantação de metadados ou migração como verificação de integridade. Durante um incidente, uma gravação pode gerar resultados parciais, trabalho duplicado ou uma falsa impressão de que a recuperação ocorreu.
Pare de reformular a consulta, a menos que tenha evidências independentes de que a solicitação está malformada. Salve o número do incidente, o serviço afetado, a instância, a hora de início e a atualização mais recente. Siga as mensagens de recuperação do Salesforce e proteja o trabalho em fila contra novas tentativas duplicadas.
Concentre-se no Workbench, no navegador, na rede, na autenticação ou na política local. Tente abrir uma janela anônima do navegador, usar um navegador alternativo compatível e comparar as redes permitidas. O site do Workbench direciona o suporte específico do Workbench para os recursos da comunidade de código aberto, enquanto a Ajuda do Salesforce continua sendo o canal para suporte a produtos e contas do Salesforce.
Passe para a análise de identidade e autorização. Confirme o usuário, a política do aplicativo conectado, o escopo do OAuth, a duração da sessão, o acesso à API, o perfil ou conjunto de permissões e os limites da organização. Atualizar o navegador repetidamente não corrigirá uma permissão ausente ou um token inválido.
Investigue o endpoint, o objeto, o campo, o compartilhamento de registros, a versão da API, o corpo da requisição e o corpo da resposta. Uma falha localizada não é suficiente para declarar o Salesforce como indisponível globalmente. Reduza a requisição até identificar se o problema está na sintaxe, no acesso, nos dados ou em um serviço dependente.
Se o problema com o Salesforce persistir, utilize as orientações oficiais de suporte do Salesforce para o canal disponível no seu Plano de Sucesso. Inclua:
Remova credenciais, IDs de sessão, tokens de acesso, nomes de clientes, IDs de registros e dados confidenciais antes de enviar os logs. Se o problema for apenas com o Workbench, utilize o canal de suporte indicado na página de Ajuda do Workbench ; a Salesforce não oferece suporte técnico para o Workbench em si.
Um indicador verde é encorajador, mas não significa que a recuperação esteja completa. Verifique a recuperação em etapas:
O resultado desejado não é simplesmente "a página aberta". Você quer que a operação autorizada original seja concluída com sucesso, com a resposta esperada e sem efeitos colaterais não verificados.
Para erros do Salesforce Workbench durante períodos de inatividade, comece verificando o Status de Confiança e a instância afetada. Em seguida, classifique a resposta HTTP antes de alterar credenciais ou reescrever solicitações. Erros 500, 502 ou 503 repetidos em testes simples de somente leitura e um incidente de Confiança correspondente indicam uma explicação do lado do Salesforce. Já falhas como 401, 403, 400 ou exclusivas do Workbench geralmente exigem investigação de autenticação, permissões, solicitações, navegador ou solução de problemas do próprio Workbench. Como o Workbench não é um produto com suporte do Salesforce, mantenha os dados de produção fora dele, documente claramente o limite de acesso e utilize as informações oficiais mais recentes sobre status e suporte quando as evidências mudarem.
Um guia prático para 2026 sobre IA, sensores para casas inteligentes, monitoramento remoto, segurança contra quedas, privacidade e como a tecnologia pode apoiar o envelhecimento no próprio lar sem substituir os cuidados.
Descubra como as cidades podem transformar dados de mobilidade, uso do solo, clima e comunidade em bairros mais seguros, verdes e acessíveis a pedestres, sem priorizar a tecnologia em detrimento das pessoas.
Compare os principais programas de engenharia aeroespacial e de UAVs (Veículos Aéreos Não Tripulados) para drones, autonomia, controles, operações de UAS (Sistemas de Aeronaves Não Tripuladas) e pesquisa de pós-graduação, com atualizações verificadas para 2026.
A practical guide to AI-powered surgical robotics: current capabilities, levels of autonomy, precision benefits, limits, regulation, and evaluation criteria.
O investimento em CCUS está aumentando, mas será que a captura de carbono pode reverter as emissões globais? Veja onde funciona, quais são os limites de escala e quais evidências são relevantes.
Compare seven global programs for digital supply chains, logistics, analytics, global trade, and operations, with practical guidance on choosing the right fit.
Aprenda como as interfaces cérebro-computador decodificam sinais neurais para restaurar a comunicação e o movimento, quais foram as conquistas de estudos recentes e o que ainda limita o uso das BCIs.
Veja como os drones comerciais combinam sensores, IA de ponta, baterias, comunicações e software de controle de voo — e como a autonomia ainda depende da missão e da regulamentação.
Compare sete opções de mestrado em baterias e armazenamento de energia de alta qualidade, considerando materiais, sistemas, pesquisa, experiência no setor, flexibilidade, idioma e custo-benefício.
Aprenda como a massa da carga útil, os limites da bateria, as condições climáticas, a eficiência da propulsão e a arquitetura da aeronave influenciam a autonomia dos UAVs industriais — e como melhorá-la.
