Importar usuários
Com a importação, você cadastra ou atualiza muitos usuários do portal de uma vez, a partir de um arquivo CSV. O arquivo é processado em segundo plano, linha a linha, e no fim você vê quantas linhas deram certo e quais falharam.
Como importar
- Em Portal › Usuários (
/dashboard/users), clique em Importar. - Selecione o arquivo CSV ou arraste-o para a janela.
- Clique em Confirmar.
- Acompanhe o andamento. No fim, a janela mostra o resumo e, se houver, o erro de cada linha.
Quando a importação termina, a lista de usuários é atualizada sozinha.
O arquivo
- Formato CSV, em UTF-8, com vírgula como separador. Outros formatos (como XLSX) não são aceitos.
- Até 10 MB.
- A primeira linha é o cabeçalho, com os nomes das colunas abaixo. A ordem não importa.
- Valores com vírgula vão entre aspas.
| Coluna | Obrigatória | O que faz |
|---|---|---|
email | Sim | O e-mail do usuário. Uma linha sem e-mail dá erro |
tenant_id | Não | O tenant ID. Sem a coluna, o tenant ID não muda; com a célula vazia, ele é apagado |
status | Não | active, pending_verification, pending_invitation, suspended ou locked. Vazio ou ausente vira pending_verification |
sso_only | Não | true, 1, yes ou sim marca o usuário como apenas SSO (sem senha). Qualquer outro valor, ou a coluna ausente, desmarca |
public_id | Não | O ID público do usuário. Serve para achar um usuário existente |
metadata | Não | Um objeto JSON com dados extras |
O nome do usuário não é importado.
Exemplo:
email,tenant_id,status
larissa.pereira@clientes-aurora.com.br,36790981705,active
caio.nascimento@clientes-aurora.com.br,51205326000196,active
Criar ou atualizar
Cada linha procura um usuário do workspace pelo public_id e, se não achar, pelo email:
- Achou — o usuário é atualizado com os valores da linha.
- Não achou — um usuário novo é criado.
A importação não envia e-mails. Um usuário criado como pending_verification entra pelo portal (com link mágico, por exemplo) e o primeiro login o ativa. Se quiser mandar um convite, use Convidar usuário — veja Usuários do portal.
:::warning Atualizar um usuário existente
Ao atualizar, status, sso_only e metadata sempre são regravados. Se a sua planilha não tiver essas colunas, um usuário Ativo volta a Pendente, perde a marca de apenas SSO e fica sem metadados. Inclua as colunas com os valores atuais quando for só ajustar o tenant ID — a exportação traz todos eles.
:::
:::tip Reaproveitar uma exportação
O arquivo da exportação usa cabeçalhos em português (E-mail, ID do Titular...). Para importá-lo de volta, troque o cabeçalho pelos nomes das colunas acima (email, tenant_id...).
:::
Status da importação
| Status | O que significa |
|---|---|
pending | Na fila. A janela mostra Processando importação... |
processing | Lendo as linhas. A janela mostra quantas já foram (12 de 40) |
Importação concluída (completed) | Todas as linhas deram certo |
Importação com erros (completed_with_errors) | Algumas linhas falharam; a janela lista cada uma com o motivo (Linha 5: ...) |
Falha na importação (failed) | O arquivo não pôde ser lido — por exemplo, sem nenhuma linha de dados |
As linhas que deram certo ficam gravadas mesmo quando outras falham. Corrija só as linhas com erro e importe de novo.
Cada importação fica registrada na Auditoria.
A importação depende da opção Permitir cadastrar usuários no dashboard, em Configurações › Cadastros. Com ela desligada, a importação é recusada.