Definindo senhas para colaboradores via planilha
Neste artigo você aprende a como configurar senhas padrão com base no CPF na Importação de Usuários
Agora a plataforma oferece uma forma prática e padronizada de criar senhas automáticas para colaboradores durante a importação de usuários, utilizando os 6 primeiros dígitos do CPF. Este artigo explica como funciona o recurso, quando a senha é gerada e como utilizar corretamente os novos campos na planilha de importação.
1. O que é a Senha Padrão baseada no CPF?
As colunas a serem apresentadas não estão de forma padrão no modelo básico ou completo de importação, elas precisam ser criadas conforme o print abaixo. O preenchimento permite gerar automaticamente senhas padronizadas baseadas no CPF do colaborador:
-
cpf_password_prefix: Define o prefixo que será usado para construir a senha. -
force_update_password: Força a atualização da senha mesmo quando o usuário já existe na base.
A ordem das colunas é indiferente e você pode ajustar como preferir.
2. Como a senha é gerada?
A senha é criada automaticamente seguindo o formato:
{prefixo} + {6 primeiros dígitos do CPF} + #A1
Exemplo
-
cpf_password_prefix: Teste -
CPF: 12345678900
-
Senha gerada: Teste123456#A1
Este padrão garante complexidade mínima e consistência na criação de contas.
3. Quando a senha é gerada?
✓ Cenário 1: Criação de um novo usuário
-
Se cpf_password_prefix estiver preenchido:

-
A senha será gerada automaticamente.
Conforme exemplo do print, a senha padrão será Teste434645#A1. -
force_update_passwordnão é necessário em caso de criação de usuário.
-
✓ Cenário 2: Atualização de um usuário existente
-
A senha só será atualizada quando force_update_password estiver preenchido.

-
force_update_password = true -
cpf_password_prefixpreenchido com o prefixo. Conforme exemplo, senha padrão Teste434645#A1 atualizada a um usuário existente.
Importante: Se
force_update_passwordestiver vazio ou false a senha não muda. -
4. Pontos importantes a observar
-
Se você preencher cpf_password_prefix, é obrigatório que o CPF também esteja preenchido na planilha.
-
Se marcar force_update_password = true, então cpf_password_prefix também deve ser informado.
-
O prefixo é livre: pode ser nome da empresa, ano, departamento, etc.
-
Sempre serão usados os 6 primeiros dígitos do CPF.
-
O sufixo #A1 é automaticamente adicionado para atender aos requisitos de segurança.
-
As colunas não aparecem automaticamente no modelo padrão — você deve adicioná-las manualmente.
-
Importante: O recurso também funciona através da API de importação de usuários.
4.1. A senha gerada obriga o usuário a alterá-la no próximo login.
Quando o colaborador acessar a plataforma e inserir a senha padrão (prefixo + 6 primeiros dígitos do CPF + #A1), e clicar em acessar, seria direcionado para uma tela em que terá que criar uma nova senha.


5. Exemplos práticos
Exemplo 1: Criar novos usuários com senha padrão
| nome | user_login | cpf | cpf_password_prefix | force_update_password |
|---|---|---|---|---|
| João Silva | cpf | 12345678900 | Teste | |
| Maria Santos | cpf | 98765432100 | Teste |
Resultado:
-
João → Teste123456#A1
-
Maria → Teste987654#A1
Exemplo 2: Atualizar senha de usuários existentes
| nome | user_login | cpf | cpf_password_prefix | force_update_password |
|---|---|---|---|---|
| João Silva | cpf | 12345678900 | Teste | true |
| Maria Santos | cpf | 98765432100 | Teste |
Resultado:
-
João → senha atualizada (Teste123456#A1)
-
Maria → senha não alterada (faltou force_update_password)
Exemplo 3: Atualizar dados sem alterar a senha
| nome | user_login | cpf | cpf_password_prefix | force_update_password |
|---|---|---|---|---|
| João Silva | cpf | 12345678900 | Teste | false |
Resultado:
-
Dados atualizados
-
Senha mantida (Teste123456#A1)
Exemplo 4: Erro — Prefixo sem CPF
| nome | cpf | cpf_password_prefix | force_update_password | |
|---|---|---|---|---|
| João Silva | joao@empresa.com | Teste |
Resultado:
❌ Erro: é obrigatório informar o CPF quando o prefixo (cpf_password_prefix) é preenchido.
Exemplo 5: Erro — Forçar atualização sem prefixo
| nome | user_login | cpf | cpf_password_prefix | force_update_password |
|---|---|---|---|---|
| João Silva | cpf | 12345678900 | true |
Resultado:
❌ Erro: é obrigatório informar o prefixo quando force_update_password = true.
Usuários sem email mas com CPF / Utilizando user_login.
A funcionalidade também é sucedida para colaboradores que não tem email atribuído, mas apenas CPFs.
Seguem exemplos:
Preenchimento para criação de novo usuário que usa CPF (sem email):

Relembrando que não é necessário preencher "force_update_password" para criar novo usuário.
Preenchimento para atualização de usuário existente:
Nesse caso é preciso preencher "force_update_password" = true para atualizar a senha de usuário existente.
Como logar/acessar a plataforma sem email?
Clique em "Entrar com CPF"

Insira o slug da empresa.
Digite o CPF e senha padrão (prefixo + 6 primeiros dígitos do CPF + #A1)
Crie uma nova senha:
Ficou com dúvidas? #ChamaNoChat =)