Ir para o conteúdo

Guia

Importar e exportar membros

Membros e acesso · 4 min de leitura

Use Importar / Exportar para adicionar muitas pessoas à sua comunidade de uma vez a partir de um arquivo CSV, ou para baixar uma lista dos seus membros. As duas operações rodam no console de administração, e todas as tarefas ficam guardadas em um histórico que você pode consultar depois.

Quem pode fazer isso: proprietários e administradores da comunidade. · Onde: web (console de administração, Admin → Membros → Importar / Exportar). · Plano: não depende de um recurso do plano da plataforma.

Preparar um arquivo CSV para importar membros

A importação lê as colunas pelo nome. Os nomes das colunas não diferenciam maiúsculas de minúsculas, a ordem não importa e as colunas extras são ignoradas.

Coluna Obrigatória O que faz
email Sim O endereço de e-mail do membro. Um arquivo sem essa coluna falha por inteiro.
display_name Não O nome do membro (uma coluna name também funciona). Se estiver vazia, é usada a parte do e-mail antes do @.
username Não Se estiver vazia, é gerada a partir do nome de exibição. Os nomes de usuário precisam ser únicos na sua comunidade.
tags Não As tags do membro, separadas por ;.

Para começar a partir de um exemplo, clique em Baixar modelo na caixa de diálogo de importação.

Algumas regras para saber antes de importar:

  • As tags já precisam existir. Os nomes de tags desconhecidos são ignorados e informados como avisos; o membro é importado mesmo assim. Crie as tags antes com Gerenciamento de Tags em Admin → Membros → Todos os Membros.
  • Todos são importados como membros comuns. Não é possível definir funções no arquivo.
  • Não é possível definir grupos de acesso no arquivo, e os membros importados também não recebem seu Grupo de Acesso Padrão. Adicione os grupos deles depois, na página de cada membro. Veja Adicionar ou remover o grupo de acesso de um membro.

Importar membros de um arquivo CSV

  1. Acesse Admin → Membros → Importar / Exportar e fique na aba Importar.
  2. Clique em Nova importação.
  3. Em Enviar CSV, escolha seu arquivo. Só arquivos CSV são aceitos. Se o arquivo for grande demais, você verá o tamanho máximo.
  4. Escolha um Modo:
    • Apenas criar: as pessoas novas são criadas. Uma linha cujo e-mail já pertence a um membro falha.
    • Criar ou atualizar: as pessoas novas são criadas. Os membros existentes mantêm o perfil e a função; só os campos vazios deles são preenchidos, e as tags são adicionadas.
  5. Clique em Executar importação.

A importação roda em segundo plano. O progresso e os resultados aparecem em Última importação, e todas as tarefas ficam listadas em Histórico de importações.

Os membros importados não recebem e-mail

Uma importação de CSV não envia nenhum e-mail nem cria convites, e você não pode enviar um depois pelo console de administração. Avise as pessoas de que elas foram adicionadas. Elas fazem login com o endereço de e-mail do seu arquivo redefinindo a senha.

Para convidar pessoas com um e-mail, use Admin → Membros → Convites. Veja Convidar membros.

Conferir os resultados de uma importação de membros

Cada importação mostra Total de linhas, Importados e Falhas.

  • Os erros são linhas que não foram importadas, por exemplo, um e-mail ausente ou inválido, um e-mail que já é de um membro no modo Apenas criar, ou um nome de usuário que já está em uso.
  • Os avisos são linhas que foram importadas com algo deixado de fora, como uma tag desconhecida.

Clique em Baixar relatório de importação para obter um CSV que lista cada erro e aviso pelo número da linha. Corrija as linhas com falha no seu arquivo e importe-as de novo.

Exportar membros para um arquivo CSV ou JSON

  1. Acesse Admin → Membros → Importar / Exportar e abra a aba Exportar.
  2. Clique em Nova exportação.
  3. Marque os campos que quer incluir. Todos vêm selecionados no início: email, display_name, username, role, status, created_at, last_active_at, verified, tags e tiers (os grupos de acesso do membro).
  4. Se quiser, restrinja a lista com Filtro por papel (opcional), Filtro por status (opcional), Entrou após e Entrou antes de.
  5. Escolha um Formato: CSV ou JSON.
  6. Clique em Executar exportação.

Uma exportação pequena fica pronta na hora em Sua exportação está pronta; clique em Baixar. Uma exportação maior entra na fila e aparece em Histórico de exportações quando termina.

Os links de download valem por tempo limitado. Depois disso, o link aparece como Expirado; execute a exportação de novo para obter um novo link.

Exportar só os membros selecionados

  1. Acesse Admin → Membros → Todos os Membros.
  2. Selecione os membros que você quer.
  3. Clique em Exportar na barra que aparece.

A caixa de diálogo de exportação abre só com esses membros. Os filtros de função, status e data não se aplicam a uma seleção.

As exportações contêm dados pessoais, como endereços de e-mail. Guarde e compartilhe os arquivos de acordo com a sua política de privacidade.

Artigos relacionados

Este guia foi útil?

Voltar aos guias

Não encontra o que precisa?

Se é membro de uma comunidade, fale com os administradores dela. Se está a criar ou a gerir uma comunidade no Mateflow, a nossa equipa pode ajudar.

Iniciar teste gratuito