---
title: "Como importar usuários em lote"
slug: "admin-batch-import-user"
updated: 2026-11-06T18:33:26Z
published: 2026-11-06T18:33:26Z
canonical: "docs.senhasegura.io/admin-batch-import-user"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Como importar usuários em lote

A Importação em lote possibilita criar um conjunto de usuários rapidamente ao realizar o upload de uma planilha devidamente preenchida. Este recurso é útil para gerenciar grandes bases de usuários de forma automatizada.

Alguns pontos importantes sobre a importação de lotes:

- A importação é baseada em uma planilha, conforme o arquivo de importação.
- As planilhas importadas são registradas no sistema e podem ser recuperadas caso necessário.
- Usuários que não existem serão criados na importação.
- Usuários que já estão registrados no Segura™ e que forem reimportados, serão atualizados.
- A maneira mais rápida de desfazer uma importação errada é corrigir a planilha e importá-la novamente.
- É recomendado não importar um arquivo com mais de mil itens, uma vez que essa ação pode consumir muitos recursos do servidor e reduzir seu desempenho.

## Arquivo de importação

Para realizar o download do arquivo modelo de importação, siga os passos abaixo:

1. No Segura™, na barra de navegação, passe o mouse sobre o **Menu de produtos** e selecione **Configurações**.
2. No menu lateral, selecione **Gestão de usuários > Importação em lote**.
3. Na barra superior, clique no botão **Importar** no menu suspenso.
4. Na janela **Adicionar arquivo**, clique em **Arquivo de modelo** para baixar o arquivo `import_users.xlsx.`

## Preenchimento do arquivo de modelo

Para realizar a importação é necessário preencher corretamente a planilha de importação. Na planilha você irá encontrar os seguintes campos para preenchimento:

- **Nome**: adicione o nome do usuário.
- **Nome do usuário**: adicione o username do usuário.
  - **Nota**: este campo que indicará se o usuário será criado ou alterado
- **Senha**: adicione a senha do usuário.
  - **Nota**: caso este campo não seja preenchido, a senha não será atualizada.
- **Departamento**: adicione o departamento atrelado ao usuário.
  - **Nota**: caso não exista, o departamento será criado
- **E-mail**: adicione o endereço de e-mail do usuário.
- **Telefone**: adicione o telefone do usuário.
- **Ativo**: preencha com **SIM** ou **NÃO** para informar se o usuário está ativo ou não.
- **Ignorar MFA**: preencha com **SIM** ou **NÃO** para informar se deseja ignorar a autenticação de multi-fator.
- **Papéis**: adicione a permissão que o usuário pode executar.
  - **Nota**: deve ser um papel existente
- **Grupo de usuário**: adicione o grupo de usuário que o colaborador pertence.
  - **Nota**: deve ser um grupo de usuário existente. Uma linha com um grupo de usuário que não existe é rejeitada, e as demais linhas continuam sendo importadas.

## Resultado da importação

Para verificar o resultado de uma importação, siga os passos abaixo:

1. No Segura™, na barra de navegação, passe o mouse sobre o **Menu de produtos** e selecione **Configurações**.
2. No menu lateral, selecione **Gestão de usuários > Importação em lote**.
3. Na linha da importação, clique na ação **Detalhes do processo**.

A tela **Processamento da importação em lote** é exibida. O campo **Situação** da importação pode ser:

- **Sucesso**: todas as linhas foram importadas.
- **Erro**: pelo menos uma linha foi rejeitada. As linhas que passaram na validação são importadas.
- **Executando**: as linhas estão sendo processadas.
- **Execução pendente**: a importação aguarda o início.
- **Cancelado**: a importação foi cancelada.

O Segura™ define a situação **Sucesso** ou **Erro** somente depois que todas as linhas da planilha são processadas.

Quando a situação é **Erro**, a mensagem informa quantas linhas falharam em relação ao total, a primeira linha que falhou e o motivo. Somente a primeira linha com falha é exibida. Para encontrar outros erros, corrija essa linha na planilha e importe-a novamente.

---

Você ainda tem dúvidas? Entre em contato com a [Comunidade Segura™](https://community.senhasegura.io/).