Importar usuários por planilha (.csv)
Caminho: Usuários → Importar
Visão geral
A importação permite que você cadastre vários usuários de uma vez a partir de uma planilha .csv. Assim, você evita cadastrar um por um quando está implantando o Opa! Suite ou recebendo uma equipe nova.
O assistente Importar usuários tem duas etapas: Seleção do arquivo, em que o sistema confere o formato da planilha, e Revisão, em que você vê cada usuário antes de salvar e corrige o que for preciso.
Pré-requisitos
- Permissão Usuários liberada no seu grupo de permissões.
- Licenças disponíveis para todos os usuários da planilha. Cada usuário ativo ocupa uma licença.
- IDs dos grupos de permissão e dos departamentos que você vai usar. Para vê-los, ative Mostrar IDs nos formulários em Configurações → Empresa. O ID passa a aparecer no cabeçalho de cada grupo e departamento, com um botão para copiar.
- Planilha salva no formato .csv.
Passo a passo
- Acesse Usuários e clique no botão Importar (ícone de arquivo, ao lado de Adicionar novo).
- Na etapa Seleção do arquivo, clique em Baixar modelo para baixar a planilha com as colunas certas.
- Preencha uma linha por usuário, seguindo as colunas da tabela abaixo.
- Clique no campo Arquivo .csv e envie a planilha.
- Clique em Continuar. O sistema confere o arquivo e abre a etapa Revisão.
- Na Revisão, confira a contagem de usuários prontos e dos que necessitam revisão. Para corrigir um registro, clique no menu da linha e em Editar. Para tirar um registro da importação, use Excluir.
- Quando não houver mais registros com pendência, clique em Importar e salvar.
Colunas da planilha
| Coluna no modelo | O que informar | Obrigatória |
|---|---|---|
nome | Nome do usuário. | Sim |
email | E-mail de login. Não pode pertencer a um usuário já cadastrado. | Sim |
senha | Senha inicial do usuário (veja os requisitos abaixo). | Sim |
idGrupoPermissao | ID do grupo de permissões. | Sim |
departamentos | IDs dos departamentos do usuário. | Só se alguma das colunas seguintes estiver preenchida |
departamentoPadrao | ID do departamento padrão (um só). | Não |
departamentosEmQueRealizaAtendimentos | IDs dos departamentos em que o usuário fica disponível para transferências diretas. | Não |
departamentosResponsavel | IDs dos departamentos em que o usuário é responsável. | Não |
recebeNotificacoesDosDepartamentos | IDs dos departamentos de que o usuário recebe notificações de transferências. | Não |
As colunas de departamento só aceitam departamentos ativos que também estejam na coluna departamentos. Para informar mais de um departamento na mesma célula, separe os IDs por vírgula.
Requisitos da senha da planilha: de 8 a 50 caracteres, com pelo menos uma letra maiúscula, um número e um caractere especial.
O sistema só aceita a planilha se a primeira linha tiver exatamente as colunas do modelo. Se o formato não bater, aparece a mensagem "A formatação das informações do arquivo enviado não corresponde ao padrão esperado". Baixe o modelo de novo e copie seus dados para ele.
Resultado esperado
O sistema exibe "Usuários adicionados com sucesso!" e os novos usuários aparecem na lista com o status Ativo, já vinculados aos departamentos informados.
Por segurança, a senha da planilha funciona como senha temporária: no primeiro acesso, cada usuário precisa criar uma nova senha. Veja Senha temporária e troca de senha no primeiro acesso.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| "A formatação das informações do arquivo enviado não corresponde ao padrão esperado" | O arquivo não é .csv, o cabeçalho foi alterado ou a planilha está vazia. Use o modelo de Baixar modelo. |
| Aviso "O limite de usuários foi atingido!" | A quantidade de usuários da planilha passa das licenças livres. Remova registros na Revisão, inative usuários que não usam mais o sistema ou contrate mais licenças pelo botão Entrar em contato. |
| Registro com "Usuário já cadastrado!" | Já existe um usuário com esse e-mail. Corrija o e-mail ou exclua o registro da importação. |
| Registro com erro na senha | A senha não tem 8 caracteres, passa de 50 ou falta letra maiúscula, número ou caractere especial. |
| O botão Importar e salvar está desabilitado | Ainda há registros que necessitam revisão, a lista está vazia ou não há licenças suficientes. |
| O usuário foi importado sem departamento | O ID informado não existe, é de um departamento inativo ou, nas colunas complementares, não está também na coluna departamentos. |
Boas práticas
- Sempre comece pelo arquivo de Baixar modelo e não renomeie as colunas.
- Copie os IDs com o botão de copiar do formulário, para evitar erros de digitação.
- Antes de importar, confira as licenças livres em Verificação da versão e licença.
- Envie a senha inicial de cada pessoa por um canal privado.