Redefinição de Senha
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Redefinição de Senha — Painel
A tela de Redefinição de Senha é onde o usuário do Painel B2B define uma nova senha de acesso depois de esquecê-la, chegando até ela por um link recebido por e-mail — nunca pelo menu do sistema.
Visão Geral
A tela de Redefinição de Senha é onde o usuário do Painel B2B define uma nova senha de acesso depois de esquecê-la, chegando até ela por um link recebido por e-mail — nunca pelo menu do sistema. O fluxo completo começa na tela de login, onde o usuário aciona “Esqueci minha senha” e informa o e-mail de acesso; o sistema então envia um e-mail com um botão/link de redefinição contendo os dados necessários para validar a operação. Ao clicar nesse link, o Painel abre já posicionado nesta tela, com o campo de e-mail preenchido e bloqueado, pronto para o usuário digitar e confirmar a nova senha. Depois de concluída (com sucesso ou com erro), a tela não avança automaticamente: o usuário retorna à tela de login manualmente para entrar com a nova senha.
Pré-requisitos
Para a tela de Redefinição de Senha ser exibida e funcionar, é necessário que:
- o acesso venha de um link contendo, na própria URL do Painel, quatro informações simultâneas: uma marcação indicando a intenção de redefinição, um código de redefinição, um identificador de confirmação e o e-mail do usuário — se qualquer uma dessas quatro informações estiver ausente ou vazia, o Painel abre normalmente na tela de login, sem qualquer aviso de link incompleto.
- no momento em que o link é aberto, não exista uma sessão de acesso já autenticada no navegador (nem de usuário comum, nem de administrador) — se já existir uma sessão válida, o Painel ignora os dados do link e abre diretamente na área autenticada correspondente.
- o e-mail informado no link corresponda a um usuário existente e com o cadastro ativo — caso contrário, a redefinição é rejeitada com uma mensagem específica (ver Troubleshooting).
- o identificador e o código recebidos no link ainda sejam válidos no momento do envio do formulário — ambos podem deixar de ser válidos entre o recebimento do e-mail e o preenchimento da tela (ver Regras de Negócio).
- a nova senha informada atenda aos requisitos mínimos de composição (ver Regras de Negócio) e seja repetida de forma idêntica no campo de confirmação.
Fluxo Operacional
- O usuário, na tela de login, aciona a opção de redefinição de senha e informa o e-mail de acesso da própria conta.
- O usuário recebe um e-mail com um botão de redefinição e abre o link recebido.
- O Painel abre diretamente na tela de Redefinição de Senha, com o campo “Usuário” já preenchido com o e-mail do link e bloqueado para edição.
- O usuário digita a nova senha e a repete no campo de confirmação, podendo alternar a exibição de cada campo entre texto oculto e texto visível.
- O usuário clica em “ATUALIZAR SENHA”.
- A tela exibe a confirmação de sucesso ou a mensagem de erro correspondente, permanecendo na mesma tela em ambos os casos.
- Para acessar o sistema, o usuário clica em “LOGIN” (que também está disponível a qualquer momento, antes de concluir a redefinição, para desistir e voltar à tela de login) e entra com a nova senha.
Interface e Comportamentos
Tela de Redefinição de Senha
A tela de Redefinição de Senha exibe três campos: “Usuário” (preenchido automaticamente com o e-mail do link recebido, sempre bloqueado para edição), “Nova senha” e “Confirmar nova senha”. Os dois campos de senha começam ocultos (como uma senha comum) e cada um tem um ícone próprio de “olho” que alterna a própria exibição entre oculta e visível, independentemente do outro campo. Ao digitar em qualquer um dos três campos, uma mensagem de erro eventualmente exibida é limpa imediatamente.
Enquanto a solicitação de redefinição está em andamento, os campos “Nova senha” e “Confirmar nova senha” e o botão “ATUALIZAR SENHA” ficam desabilitados, e o botão passa a exibir um ícone de carregamento em rotação no lugar do ícone de salvar. O botão “LOGIN”, no topo da tela, permanece sempre habilitado e a qualquer momento leva de volta à tela de login, independentemente de haver uma redefinição em andamento ou já concluída.
Feedbacks ao Usuário
Na tela de Redefinição de Senha, uma única mensagem por vez aparece na mesma área abaixo dos campos de senha — tanto os avisos de erro quanto a confirmação de sucesso usam esse mesmo espaço.
Validações preenchidas no próprio Painel
| Situação | Feedback | Texto exato |
|---|---|---|
| Campo “Usuário” chega vazio (não ocorre no uso normal via link de e-mail, que sempre preenche este campo) | Mensagem de erro | “Insira o e-mail de acesso do usuário.” |
| Campo “Nova senha” não preenchido ao clicar em ATUALIZAR SENHA | Mensagem de erro | “Insira a nova senha.” |
| Campo “Confirmar nova senha” não preenchido ao clicar em ATUALIZAR SENHA | Mensagem de erro | “Insira a confirmação da nova senha.” |
| Nova senha e confirmação com valores diferentes | Mensagem de erro | “As senhas não correspondem.” |
| Falha de comunicação com o sistema ao enviar a redefinição | Mensagem de erro | “Não é possível redefinir a senha neste momento.” |
| Sistema não retorna nenhuma resposta utilizável | Mensagem de erro | “Não foi possível redefinir a senha.” |
| Redefinição concluída com sucesso | Mensagem de confirmação | “Senha redefinida com sucesso!” |
Mensagens retornadas pelo sistema
| Situação | Feedback | Texto exato |
|---|---|---|
| E-mail do link em formato inválido | Mensagem de erro | “E-mail inválido.” |
| E-mail do link ausente | Mensagem de erro | “E-mail de acesso.” |
| Identificador do link ausente | Mensagem de erro | “Identificador inválido.” |
| Código de redefinição do link ausente | Mensagem de erro | “Código de redefinição inválido.” |
| Nova senha ausente no envio | Mensagem de erro | “Senha inválida.” |
| E-mail não corresponde a nenhum usuário ativo | Mensagem de erro | “E-mail de usuário não encontrado ou desativado.” |
| Identificador do link não corresponde ao esperado para o usuário | Mensagem de erro | “Código de redefinição inválido.” |
| Código de redefinição do link não corresponde ao esperado no momento do envio | Mensagem de erro | “Código de redefinição não correspondente.” |
| Nova senha com menos de 8 caracteres | Mensagem de erro | “A senha deve conter pelo menos 8 caracteres.” |
| Nova senha sem nenhum número | Mensagem de erro | “A senha deve conter pelo menos um número.” |
| Nova senha sem nenhuma letra | Mensagem de erro | “A senha deve conter pelo menos uma letra” |
| Falha ao gravar a nova senha | Mensagem de erro | “Erro ao salvar a nova senha, tente novamente.” |
Regras de Negócio
Validade do link de redefinição
Na Redefinição de Senha, o link recebido por e-mail contém um código que só é válido no mesmo dia em que a solicitação foi feita — se o link não for usado até o fim do dia, ele deixa de funcionar e uma nova solicitação precisa ser feita pela tela de login. Assim que a senha é redefinida com sucesso, o mesmo link deixa de funcionar automaticamente: usá-lo novamente (por exemplo, clicando outra vez em ATUALIZAR SENHA depois de já ter sido bem-sucedido) mostra uma mensagem de erro, mesmo a senha já tendo sido alterada com sucesso na tentativa anterior.
Requisitos da nova senha
Na Redefinição de Senha, a nova senha só é aceita quando atende, nesta ordem, a três condições — a primeira condição não atendida já interrompe a validação, sem informar as demais de uma vez:
- Ter pelo menos 8 caracteres.
- Conter pelo menos um caractere numérico.
- Conter pelo menos uma letra.
Não há outras regras de composição (não exige caractere especial nem letra maiúscula) e não há verificação de que a nova senha seja diferente da senha anterior.
Encerramento do fluxo
Ao concluir a Redefinição de Senha com sucesso, o sistema não realiza login automático nem redireciona o usuário: ele precisa retornar manualmente à tela de login (botão “LOGIN”) e autenticar-se com a nova senha. O campo “Usuário” desta tela nunca pode ser alterado pelo usuário — ele reflete exatamente o e-mail que veio no link recebido; para redefinir a senha de um e-mail diferente, é necessário solicitar um novo link a partir da tela de login.
Troubleshooting
Mensagem “Insira o e-mail de acesso do usuário.” aparece mesmo com o campo de usuário bloqueado
Cenário: validação defensiva da Redefinição de Senha para o campo “Usuário” chegar vazio; no uso normal, a partir do link recebido por e-mail, este campo sempre chega preenchido e bloqueado, então este cenário não é alcançado por um usuário comum.
Mensagem exibida: “Insira o e-mail de acesso do usuário.”
O que fazer: solicitar um novo link de redefinição pela tela de login.
Campo de nova senha vazio ao clicar em ATUALIZAR SENHA
Mensagem exibida: “Insira a nova senha.”
O que fazer: preencher o campo “Nova senha” e tentar novamente.
Campo de confirmação de senha vazio ao clicar em ATUALIZAR SENHA
Mensagem exibida: “Insira a confirmação da nova senha.”
O que fazer: preencher o campo “Confirmar nova senha” com o mesmo valor da nova senha.
Nova senha e confirmação não coincidem
Mensagem exibida: “As senhas não correspondem.”
O que fazer: digitar novamente os dois campos de senha com o mesmo valor; usar os ícones de “olho” para conferir o que foi digitado.
Falha de comunicação ao enviar a redefinição de senha
Cenário: a requisição ao sistema falha por completo (rede instável, sistema indisponível).
Mensagem exibida: “Não é possível redefinir a senha neste momento.”
O que fazer: verificar a conexão com a internet e tentar novamente em alguns instantes.
Sistema responde sem confirmar nem informar erro
Mensagem exibida: “Não foi possível redefinir a senha.”
O que fazer: tentar novamente; se persistir, contatar o suporte.
E-mail do link não corresponde a nenhuma conta ativa
Cenário: o e-mail do link foi digitado incorretamente na solicitação original, a conta foi desativada, ou removida entre o envio do e-mail e o uso do link.
Mensagem exibida: “E-mail de usuário não encontrado ou desativado.”
O que fazer: confirmar com o administrador da empresa se a conta está ativa; solicitar um novo link informando o e-mail correto.
Link de redefinição de senha rejeitado como inválido
Cenário: o link foi copiado incompletamente, corrompido, ou pertence a uma solicitação de outro usuário.
Mensagem exibida: “Código de redefinição inválido.”
O que fazer: abrir o link diretamente a partir do e-mail recebido (sem editar o endereço); se persistir, solicitar um novo link.
Código de redefinição não corresponde mais ao link
Cenário: o código do link deixou de ser válido — o dia mudou desde que o e-mail foi enviado, ou a senha da conta já foi redefinida com sucesso desde então (inclusive por um envio anterior deste mesmo link).
Mensagem exibida: “Código de redefinição não correspondente.”
O que fazer: solicitar um novo link de redefinição pela tela de login.
Nova senha rejeitada por não atender aos requisitos mínimos
Cenário: a nova senha tem menos de 8 caracteres, ou não contém pelo menos um número, ou não contém pelo menos uma letra.
Mensagem exibida: “A senha deve conter pelo menos 8 caracteres.” ou “A senha deve conter pelo menos um número.” ou “A senha deve conter pelo menos uma letra” (conforme o requisito não atendido, um de cada vez)
O que fazer: ajustar a nova senha para conter ao menos 8 caracteres, com letras e números, e tentar novamente.
Erro ao salvar a nova senha
Mensagem exibida: “Erro ao salvar a nova senha, tente novamente.”
O que fazer: tentar novamente; se persistir, contatar o suporte técnico.
Casos de Uso
Caso 1 — Redefinição de senha concluída com sucesso
O usuário esquece a senha, solicita a redefinição pela tela de login informando seu e-mail, recebe o e-mail e clica no link no mesmo dia. A tela de Redefinição de Senha abre com o e-mail já preenchido. O usuário digita “NovaSenha123” nos dois campos de senha e clica em ATUALIZAR SENHA. A tela exibe “Senha redefinida com sucesso!”. O usuário clica em LOGIN e acessa o sistema normalmente com a nova senha.
Caso 2 — Link de redefinição usado no dia seguinte ao recebimento
O usuário recebe o e-mail de redefinição mas só abre o link no dia seguinte. Ao preencher a nova senha e confirmar, a tela exibe “Código de redefinição não correspondente.” (o código só era válido no dia em que foi gerado). O usuário volta à tela de login e solicita um novo link.
Caso 3 — Tentativa de reenvio do formulário depois de uma redefinição já concluída
O usuário conclui a redefinição com sucesso, mas clica novamente em ATUALIZAR SENHA sem sair da tela (por engano, ou por não ter percebido a mensagem de sucesso). Como a senha já foi alterada, o código do link deixou de corresponder à nova senha, e a tela agora exibe “Código de redefinição não correspondente.” — mesmo a redefinição já tendo sido concluída com sucesso na tentativa anterior.
Caso 4 — Nova senha fraca
O usuário digita “abc123” como nova senha (6 caracteres). Ao clicar em ATUALIZAR SENHA, a tela exibe “A senha deve conter pelo menos 8 caracteres.” — mesmo a senha já contendo letras e números, a primeira condição não atendida (tamanho) é a única reportada.
