# Importar membros por planilha

> Como trazer uma lista de pessoas de qualquer planilha .xlsx ou .csv para a comunidade - origem, arquivo, colunas, grupos e tags, consentimento, resumo e relatório -, o que cada pessoa recebe por e-mail e como ela recusa o convite.

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.

> [!WARNING]
> 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](/membros/politica-de-convites) antes de importar.

## Para que serve

| Comunidade | Planilha |
|---|---|
| Evento | Os inscritos que marcaram *"Quero participar da comunidade"*, com a coluna do tipo de ingresso virando tag |
| Associação | A base de associados, com empresa e cargo virando campos customizados |
| Escola | Os matriculados do semestre, todos no grupo da turma |
| Coworking | Os residentes, com a coluna *Andar* indo para Grupos |

## 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](/membros/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

| Caso | O que acontece |
|---|---|
| E-mail sem conta na Memberfy | Ganha a conta e entra na comunidade, com a função, os grupos (inclusive o [grupo padrão](/membros/grupos-e-organograma)), as tags e os campos. Recebe o convite com **Definir minha senha** |
| Já tem conta, mas não é desta comunidade | Entra na comunidade. O nome e o telefone da conta não mudam (valem em outras comunidades). Recebe o convite com **Entrar** |
| **Já é membro** | Não muda a função nem o nome. **Ganha** os grupos e as tags (nada é tirado) e preenche só os campos customizados **vazios**. Não recebe e-mail. Conta como *atualizado* |
| E-mail repetido na planilha | Vale a primeira linha; as outras são ignoradas como *duplicado na planilha* |
| Sem e-mail ou com e-mail inválido | Ignorada com o motivo, sem parar o resto |
| Sem consentimento | Ignorada (quando há coluna de consentimento) |
| Pediu para não participar desta comunidade | Ignorada; nenhum e-mail sai |
| Valor que não serve para o campo | Só aquele campo fica vazio; a pessoa entra e o relatório avisa |

### 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](/notificacoes/campanhas-de-email#cota-de-envios).

### 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](/membros/campos-customizados) 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](/membros/politica-de-convites#como-a-pessoa-convidada-recusa-ou-denuncia).

## 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

| Mensagem | O que fazer |
|---|---|
| *Envie um arquivo .xlsx ou .csv.* | Salve a planilha como .xlsx ou .csv |
| *O arquivo passa de 5 MB.* / *A planilha passa de 5.000 linhas de dados.* | Divida em partes e importe uma de cada vez |
| *Não achamos um cabeçalho claro e usamos a linha 1…* | Escolha a **Linha de cabeçalho** certa no passo Arquivo |
| Acentos trocados (*João*) | Troque a **Codificação** no passo Arquivo |
| *Escolha a coluna de e-mail para continuar.* | Mande uma coluna para **E-mail** |
| *Só uma coluna pode ir para Telefone.* | Deixe a outra em **Ignorar** ou mande para um campo customizado |
| *Marque quais valores da coluna de consentimento contam como sim.* | Marque os valores em **Contam como sim** |
| *Informe a origem da lista.* | Preencha a origem no passo 1 |
| *Marque a declaração de consentimento para importar.* | Sem coluna de consentimento, a declaração é obrigatória |
| *Outra planilha está sendo lida agora. Tente de novo em instantes.* | Espere alguns segundos e clique de novo |
| *A planilha só aceita membro ou moderador.* | Para outras funções, use **Digitar e-mails** |
| *Interrompida pela suspensão da comunidade* | A Memberfy suspendeu a entrada de membros; o que já tinha sido processado ficou. Ver [Suspensão de entrada e vendas](/membros/politica-de-convites#suspensao-de-entrada-e-vendas) |

## 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](/membros/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](/mcp/receitas#61-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](/api/referencia/member-imports) na Referência da API.

## Relacionados

- [Política de convites e importação de membros](/membros/politica-de-convites)
- [Convidar membros](/membros/convidar-membros)
- [Campos customizados](/membros/campos-customizados)
- [Grupos e organograma](/membros/grupos-e-organograma)
- [Tags](/membros/tags)