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, mas as pessoas que você importa contam para o limite de membros do seu 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 em Admin → Membros → Tags de 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.

As pessoas novas contam para o limite de membros do seu plano da plataforma. Se sua comunidade já estiver no limite quando você executar uma importação Apenas criar, uma caixa de diálogo de upgrade é aberta e a importação não começa. Veja Verificar o uso e os limites do plano.

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. Uma linha que adicionaria uma pessoa nova depois que sua comunidade atingiu o limite de membros mostra "Não importado: a comunidade atingiu o limite de membros do plano." As linhas que atualizam membros existentes não são afetadas.
  • 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). Se você tiver campos de perfil personalizados, marque os que quer incluir em Campos de perfil. As respostas dos membros são dados pessoais, portanto trate o arquivo de acordo.
  4. Se quiser, restrinja a lista com Filtro por papel (opcional), Filtro por status (opcional), Entrou após e Entrou antes de. As duas datas são incluídas e lidas no fuso horário da sua comunidade. Filtro por status (opcional) inclui Desativados; com Todos os Status, todos os membros são exportados, inclusive os desativados.
  5. Escolha um Formato: CSV ou JSON.
  6. Clique em Executar exportação.

A caixa de diálogo aguarda enquanto a exportação é processada. Quando ela termina, aparece uma mensagem com um botão Baixar, que fica visível até você fechá-la. Na página Importar / Exportar, o arquivo também aparece em Sua exportação está pronta. Se você fechar a caixa de diálogo antes de a exportação terminar, ela continua sendo processada e aparece em Histórico de exportações.

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. Quando o arquivo estiver pronto, clique em Baixar na mensagem que aparece.

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 você é membro de uma comunidade, fale com os administradores dela. Se está criando ou gerenciando uma comunidade no Mateflow, nossa equipe pode ajudar.