Importar usuários em massa
Neste artigo vamos te mostrar como importar usuários em massa usando uma planilha Excel ou Google Sheets.
Você pode adicionar facilmente um grande número de usuários de uma só vez. Compartilhamos um formulário de exemplo para que você o utilize, e também explicamos cada campo para que você possa preenchê-los.
Vamos começar!
📹 Aqui você encontrará um vídeo tutorial completo
1. Abra a planilha que compartilhamos aqui no Excel ou Google Sheets.
👉 Vá em Arquivo e escolha "Fazer uma cópia" para poder editá-la com as informações que você precisa importar.
Você não precisa adicionar todas as colunas para realizar uma importação — apenas as colunas marcadas como Obrigatórias.
Detalhes dos cabeçalhos de cada coluna
|
|
|---|---|
Cabeçalho | Detalhe |
external_id (opcional) | É um identificador único do usuário e não deve ser confundido com o ISBN da publicação. Recomendamos usar este campo, pois é a única forma de referenciar um usuário após a importação, além do e-mail. Deve conter no máximo 250 caracteres. Pode conter caracteres alfanuméricos, além de hífens e sublinhados. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
email (obrigatório) | E-mail do usuário. Deve conter no máximo 250 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
password (opcional) | Você pode criar uma senha manualmente ou deixar este campo em branco para que o usuário gere sua própria senha usando a função "recuperar senha" quando quiser acessar a plataforma. Deve conter no mínimo 8 caracteres alfanuméricos e no máximo 250. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. Por questão de segurança, recomendamos que cada usuário gere sua própria senha quando quiser acessar, para evitar o envio de senhas em e-mails. |
assign_plan_id (opcional) | É um identificador único de Plano e é usado para atribuir automaticamente um Plano aos usuários importados. Escreva para support@publica.la indicando o nome do Plano para o qual você precisa do identificador, para que possamos informá-lo. O formato desta coluna deve ser Número. Para isso, selecione a coluna, clique em Formatar > Número > Número. |
assign_plan_valid_from (opcional) | Caso o usuário tenha um Plano válido a partir de uma determinada data. O formato desta coluna deve ser Texto simples "ano-mês-dia" (2019-04-28). Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
assign_plan_valid_to (opcional) | Caso o usuário tenha um Plano válido até uma determinada data. O formato desta coluna deve ser Texto simples "ano-mês-dia" (2019-04-28). Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
only_sees_readable (opcional) | Caso o usuário veja apenas as publicações que pode ler. Deve conter 1 (um) ou 0 (zero). O padrão é 0 (zero). O formato desta coluna deve ser Número. Para isso, selecione a coluna, clique em Formatar > Número > Número. |
name (opcional) | O nome do usuário. Deve conter no máximo 50 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
sessions_limit (opcional) | Limite de sessões para cada usuário. Valor entre 1 e 99999. O formato desta coluna deve ser Número. Para isso, selecione a coluna, clique em Formatar > Número > Número. |
national_id (opcional) | É o número de identificação do usuário (por exemplo, no Brasil o CPF). O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
address_line_1 (opcional) | O endereço do usuário. Deve conter no máximo 50 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
address_line_2 (opcional) | O endereço adicional do usuário. Deve conter no máximo 50 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
town (opcional) | A cidade do usuário. Deve conter no máximo 50 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
status (opcional) | O estado do usuário. Deve conter no máximo 50 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
country (opcional) | O país do usuário. Deve conter no máximo 50 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
postal_code (opcional) | O CEP do usuário. Deve conter no máximo 20 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
other_information (opcional) | Outras informações de faturamento do usuário. Deve conter no máximo 512 caracteres. O formato desta coluna deve ser texto simples. Para isso, selecione a coluna, clique em Formatar > Número > Texto simples. |
2. Quando tiver preenchido esta planilha, você deverá baixá-la ou salvá-la como arquivo .XLSX (Microsoft Excel) para poder utilizá-la.
3. Vá para o Painel de Controle da sua Biblioteca, em seguida Configurações > Importações.
4. Clique em Nova Importação, escolha a opção Importar Usuários e adicione o arquivo que você criou.
5. Clique no botão Criar Importação e o processo será executado automaticamente.
Após a execução, você poderá ver nessa mesma seção se foi concluída com sucesso ou se houve algum erro.
Em alguns casos, pode ser necessário atualizar a página para ver o status final do processo, caso ele continue aparecendo como "Em processamento" por vários minutos.
Erros comuns
Em Ver detalhes do relatório você poderá ver os erros, caso ocorram, e a linha da planilha em que o erro está ocorrendo será indicada. A linha indicada é exatamente a mesma da planilha, contando o cabeçalho como número 1 (um).
Os diferentes erros comuns que costumam ocorrer são os seguintes:
- Cabeçalho inválido: este é um dos erros mais comuns e geralmente ocorre porque os dados de algum cabeçalho foram modificados manualmente e não correspondem exatamente ao que indicamos no arquivo de exemplo.
- E-mail inválido: o e-mail indicado contém um erro. Isso pode estar relacionado principalmente a um erro de digitação em que uma letra ou ponto foi omitido. _Exemplo: nome@hotmail.co ou nome@hotmailcom ou nome@hotmail.con_
- Data com formato incorreto: o formato de data deve ser seguido conforme indicado nos pontos anteriores. Exemplo: usar barras em vez de hífens (2020/01/20), escrever sem a ordem correta (01/20/2020) ou abreviar o ano em dois dígitos (01-20-20).
- Muitos caracteres: não respeitar o número máximo de caracteres para os campos conforme indicado em cada caso. Exemplo: tentar adicionar muitas informações no campo de informações adicionais de faturamento.
- plan_id inválido: ao indicar um número de identificação de Plano que não existe na Biblioteca porque não foi criado antes ou foi escrito incorretamente.
Esperamos que este tutorial tenha sido simples para você. Se tiver dúvidas, escreva para support@publica.la.
Atualizado em: 11/05/2026
Obrigado!