Ativar conta
Módulo: Autenticação Caminho na aplicação: app.mantoerp.com.br/ativar?token=...&tipo=ativacao (ou tipo=recuperacao_senha) Última atualização: 20/04/2026
Para que serve
A mesma tela atende a dois fluxos, ambos acessados pelo link enviado por e-mail:
- Ativação de conta (
tipo=ativacao): definir a senha inicial de um cadastro recém-criado. - Redefinição de senha (
tipo=recuperacao_senha): trocar a senha após o usuário pedir recuperação.
O texto do título e do botão principal muda conforme o tipo.
Quem pode usar
Qualquer pessoa que tenha recebido um link de ativação ou de redefinição de senha por e-mail. A tela é pública.
Como usar (passo a passo)
- Abra o link recebido por e-mail (o link contém o token de validação).
- Aguarde o sistema verificar o token automaticamente — enquanto isso, aparece a mensagem "Verificando link...".
- Se o link for válido, o sistema exibe seu nome, e-mail e a empresa (tenant) associados ao cadastro.
- Informe a nova senha no campo "Nova Senha".
- Repita a senha no campo "Confirmar Senha".
- Clique em Ativar Conta (ou Redefinir Senha no fluxo de recuperação).
- Na tela de sucesso, clique em Fazer Login para ir à tela de entrada.
- Se o link for inválido ou expirado, clique em Solicitar novo link para receber um novo e-mail.
Campos da tela
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Nova Senha | Sim | Senha de acesso | Mínimo 8 caracteres, com letra maiúscula, número e caractere especial |
| Confirmar Senha | Sim | Repetir a nova senha | Deve ser idêntica ao campo Nova Senha |
Validações e regras
- Token ausente: se a URL não tiver o parâmetro
token→ a tela mostra o bloco "Link inválido" com a mensagem "Token nao fornecido". - Token inválido ou expirado: ao chamar
GET /auth/verificar-token→ resposta com erro → a tela mostra "Link inválido" com a mensagem devolvida pelo backend (tipicamente "Token invalido ou expirado"). - Token válido: a tela exibe nome, e-mail e tenant no cartão azul de identificação antes do formulário.
- Senha obrigatória: submeter sem senha → exibe "Informe a senha".
- Senha mínima: menos de 8 caracteres → exibe "Minimo 8 caracteres".
- Senha sem requisitos: se a senha não tiver letra maiúscula, número e caractere especial → exibe "Deve conter maiuscula, numero e caractere especial".
- Confirmar senha obrigatória: submeter sem confirmação → exibe "Confirme a senha".
- Senhas diferentes: quando "Nova Senha" e "Confirmar Senha" divergem → exibe "As senhas nao conferem".
- Sucesso: após ativar/redefinir → a tela é substituída pela confirmação "Conta ativada!" ou "Senha redefinida!".
- Reenvio de link: na tela de link inválido, clicar em "Solicitar novo link" dispara um novo e-mail usando o e-mail identificado pelo token anterior (se disponível). Se não houver e-mail disponível → exibe "Email nao disponivel para reenvio".
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Token nao fornecido" | URL sem o parâmetro token | Abra o link completo recebido no e-mail |
| "Token invalido ou expirado" | Link já usado ou vencido | Clique em "Solicitar novo link" |
| "Informe a senha" | Campo Nova Senha vazio | Digite a senha |
| "Minimo 8 caracteres" | Senha com menos de 8 caracteres | Use uma senha com ao menos 8 caracteres |
| "Senha deve conter ao menos 1 letra maiuscula, 1 letra minuscula, 1 numero e 1 caractere especial" | Senha não atende aos requisitos de complexidade | Use uma senha que combine maiúscula, minúscula, número e símbolo (ex.: !@#$%&) |
| "Confirme a senha" | Campo Confirmar Senha vazio | Repita a senha |
| "As senhas nao conferem" | Campos de senha diferentes | Digite a mesma senha nos dois campos |
| "Email nao disponivel para reenvio" | Reenvio sem e-mail identificado (token já anulado) | Acesse a tela de recuperação de senha e solicite o link pelo e-mail |
| "Erro ao processar" | Fallback genérico para falha ao ativar ou redefinir | Tente novamente; se persistir, contate o suporte |
| "Erro ao reenviar" | Fallback ao falhar o reenvio do link | Tente novamente ou use a tela de recuperação |
Integrações e dependências
- Endpoints:
GET /auth/verificar-token?token=...&tipo=...— valida o token e retorna nome, e-mail e tenant.POST /auth/ativar— ativa a conta (fluxotipo=ativacao).POST /auth/redefinir-senha— altera a senha (fluxotipo=recuperacao_senha).POST /auth/reenviar-token— dispara novo e-mail de ativação/recuperação.
- E-mail: os links chegam via AWS SES pelo domínio
mantoerp.com.br. - Tela seguinte após sucesso: Login.
Dúvidas frequentes
O link venceu. Perco meus dados? Não. O cadastro permanece, apenas o token expirou. Solicite um novo link.
Posso usar o mesmo link duas vezes? Não. Após a ativação ou redefinição, o token é invalidado.
Quanto tempo o link fica válido?
Posso definir qualquer senha? Não. A senha precisa ter 8 caracteres ou mais, com pelo menos uma letra maiúscula, um número e um caractere especial.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |