Importar membros por planilha

A aba Importar planilha da janela Convidar Membros traz para a comunidade as pessoas de uma planilha: a lista de inscritos de um evento, a base de associados, os alunos de uma turma. Serve qualquer planilha: você diz para onde vai cada coluna, escolhe função, grupos e tags para todos, confere um resumo e só então importa. Cada pessoa nova recebe um convite por e-mail.

Importe só quem autorizou receber e-mails e participar da comunidade. Listas compradas, sorteios e dados coletados por robôs são proibidos. Leia a Política de convites e importação de membros antes de importar.

#Para que serve

#Como funciona

#Quem pode importar

Proprietário e administrador. A importação só dá a função de Membro ou Moderador: quem precisa entrar como administrador ou financeiro é convidado pela aba Digitar e-mails. Ver Convidar membros.

#O arquivo

• .xlsx ou .csv. O .xls antigo e o .xlsm (com macros) são recusados, mesmo renomeados.
• Até 5 MB, 5.000 linhas de dados e 100 colunas.
• Fórmulas valem pelo valor calculado; células mescladas, pelo valor da primeira.
• No CSV, a Memberfy descobre sozinha a codificação (acentos certos mesmo em arquivo salvo pelo Excel antigo) e o separador (vírgula, ponto e vírgula, tabulação ou barra vertical). Dá para trocar os dois.

#O que acontece com cada linha

#O convite por e-mail

Toda pessoa nova na comunidade recebe um e-mail em nome da comunidade, com a origem da lista ("Você recebeu este convite porque seus dados constam em: Inscritos do evento X de 2026") e, no rodapé, o link Agradeço o convite, mas não quero participar. Quem não tem conta recebe Definir minha senha (o link vale por 7 dias e uma vez só); quem já tem, Entrar. Quem já era membro não recebe nada.

Os e-mails da importação não contam na cota de campanhas.

#Em segundo plano

Ao clicar em Importar, a importação entra numa fila e roda sozinha: pode fechar a janela. Os convites saem no ritmo das campanhas, cerca de 5 por segundo, então uma lista de 3.000 pessoas leva uns 10 minutos para entregar tudo. No fim, quem importou recebe um aviso no app e um e-mail com o resumo.

A comunidade lê uma planilha por vez. Se outra pessoa da equipe estiver importando no mesmo instante, a tela diz "Outra planilha está sendo lida agora. Tente de novo em instantes."

#O que fica guardado

A importação registra quem importou, quando, o nome do arquivo, a origem e o consentimento usado (a coluna e os valores, ou a declaração). Uma cópia do arquivo original fica guardada em local privado, sem prazo para apagar: proprietário e administrador baixam pelo histórico (Importações anteriores › Ver › Baixar o arquivo original). Na ficha de quem entrou, a equipe lê "Origem: importação por planilha em …".

#Passo a passo

Papel: proprietário ou administrador.

1. Administração › Membros, botão Convidar Membros, aba Importar planilha.

2. No topo da janela, escolha a Função (Membro ou Moderador), os Grupos e as Tags para todos. Grupo e tag novos se criam ali mesmo, digitando o nome. Esses três campos são os mesmos da aba Digitar e-mails: o que você escolher numa vale na outra.

3. 1. Origem. Escreva a Origem da lista (obrigatória, até 150 caracteres, sem links), por exemplo Inscritos do evento X de 2026. Ela vai no e-mail de cada convidado. Escolha o arquivo (arraste ou clique) e clique em Próximo.

4. 2. Arquivo. Confira a leitura: a Aba (num .xlsx com várias), a Linha de cabeçalho ("Cabeçalho na linha 8.", quando a planilha tem um título em cima) e, num CSV, o Separador e a Codificação. Trocar qualquer um relê o arquivo.

5. 3. Colunas. Cada coluna aparece com as 3 primeiras linhas e o seletor Vai para. As reconhecidas automaticamente (e-mail, nome, sobrenome, telefone, campos que já existem) vêm primeiro; as outras ficam em Ignorar, recolhidas em "28 colunas ignoradas — mostrar". Os destinos:

   Vai para	Regra
   E-mail	Obrigatório, uma coluna só. Sem ele, "Escolha a coluna de e-mail para continuar."
   Nome e Sobrenome	Juntos viram o nome completo. Uma coluna de nome completo também serve
   Telefone	Ajustado ao formato internacional, com o país da comunidade como padrão; ilegível fica vazio
   Tags	Cada valor vira uma tag (separe várias com , ; ou |). Ex.: Tipo de ingresso
   Grupos	Cada valor põe a pessoa no grupo de mesmo nome; o que não existir vira grupo novo
   Consentimento	A coluna que diz quem aceitou. Marque quais valores contam como sim (Sim, x, aceito…)
   Campo: …	Um campo customizado que já existe
   + Novo campo customizado	Cria o campo com o nome da coluna (editável) e o tipo sugerido pelo conteúdo. Ele nasce opcional
   Ignorar	A coluna não é importada

   Consentimento, Tags e Grupos nunca são sugeridos: é você quem escolhe. Colunas com o mesmo nome aparecem separadas (Telefone (col. 24), Telefone (col. 30)), e só uma pode ir para cada dado da pessoa.

6. Consentimento. Com uma coluna de consentimento, entram só as linhas com os valores marcados. Sem ela, marque a declaração "Declaro que todas as pessoas desta lista autorizaram receber e-mails e participar desta comunidade." Sem uma das duas, não dá para importar.

7. 4. Resumo. Confira antes de gravar: Linhas na planilha, Pessoas novas, Já são membros, Serão ignoradas (com o motivo), Ignoradas porque pediram para não participar, E-mails de convite que serão enviados e os grupos, tags e campos que serão criados, pelo nome. Clicar em Importar confirma tudo isso; não há outra pergunta.

8. 5. Resultado. O andamento aparece na janela. No fim: Importados, Atualizados, Ignorados e Convites enviados, a lista das Linhas ignoradas com o motivo, as Linhas importadas com aviso e o botão Baixar CSV dos erros (as linhas originais com a coluna do motivo, para corrigir e importar de novo).

Importações anteriores, na própria aba, mostra o histórico: cada importação com data, contagens, estado e o arquivo original.

#Recusar o convite

Quem foi importado e não quer participar tem dois caminhos:

• Pelo e-mail: o link Agradeço o convite, mas não quero participar abre uma página da comunidade, sem login, com Confirmar: não quero participar.
• Na comunidade: em Minha Conta, a mesma frase aparece discreta, com a explicação "Você foi adicionado a esta comunidade por uma importação de lista."

Ao confirmar, a pessoa sai da comunidade e entra na lista de recusa: a comunidade não consegue mais importá-la nem convidá-la. A conta dela na Memberfy continua existindo. Ela só volta se entrar por conta própria, pelo cadastro aberto.

• O link do e-mail vale por 30 dias e deixa de valer quando a pessoa aceita o convite (define a senha e entra) ou quando a função dela muda. Depois disso, para sair, ela fala com quem administra a comunidade.
• A recusa não vale para quem é da equipe (moderador, administrador, financeiro) nem para quem tem assinatura ativa ou pendente na comunidade: a pessoa cancela a assinatura antes.
• A lista de recusa vale também para o convite por e-mail e para o Novo Membro: quem recusou volta como "Pediu para não participar desta comunidade", e nenhum e-mail sai.

Uma recusa sozinha não é violação; muitas recusas numa mesma lista levam a Memberfy a avaliar a comunidade. Ver a Política de convites.

#Exemplos

Evento com 220 inscritos. A planilha tem um título nas primeiras linhas e o cabeçalho na linha 8. A organização confere a linha de cabeçalho, manda a coluna Aceito receber novidades para Consentimento com Sim contando como sim, Tipo de ingresso para Tags e Empresa para + Novo campo customizado. O resumo mostra 97 pessoas novas, 109 sem consentimento, 12 duplicadas e 2 sem e-mail. Importa; 97 convites saem.

Associação trazendo a base de novo. Metade já é membro. Essa metade ganha o grupo Associados 2026 e preenche a Empresa que estava vazia, sem receber e-mail; só os novos são convidados.

#Erros comuns e como resolver

#Perguntas frequentes

Dá para importar sem mandar e-mail? Não. Toda pessoa nova recebe o convite, com a origem e o link de recusa: é o que permite a ela saber de onde vieram os dados e dizer não.

Dá para desfazer uma importação? Não há botão de desfazer. Para tirar alguém, use Gerenciar membros.

Posso importar alguém que recusou? Não. Quem recusou só volta se entrar por conta própria.

A coluna de grupos tem um nome escrito diferente do grupo. A comparação ignora maiúsculas e acentos (engenharia acha Engenharia). Um nome que não bate com nenhum grupo cria um grupo novo, e o resumo mostra qual antes de importar.

Posso importar pelo Claude ou pelo ChatGPT? Pode: anexe a planilha na conversa e peça. Ver a receita Importar uma planilha pelo assistente.

#Na API

POST /api/members/imports (o arquivo, em multipart), POST /api/members/imports/{id}/preview, POST /api/members/imports/{id}/start, GET /api/members/imports, GET /api/members/imports/{id}, GET /api/members/imports/{id}/errors.csv e GET /api/members/imports/{id}/file. A recusa é POST /api/invite-opt-out/{token} (pelo link) e POST /api/profiles/me/decline (logado). Ver Member Imports na Referência da API.

#Relacionados

• Política de convites e importação de membros
• Convidar membros
• Campos customizados
• Grupos e organograma
• Tags