# Migrar de outra plataforma

> Como trazer para a Memberfy os membros de outra plataforma de comunidade ou de cursos, com os grupos, as tags, os campos do perfil, os badges que cada pessoa já tinha e os pontos iniciais, sem disparar avisos, com uma planilha de exemplo.

Vindo de outra plataforma, você não precisa começar do zero: uma planilha traz cada pessoa com o que ela já tinha lá, inclusive os **badges** e os **pontos**, para ninguém perder o que conquistou. Os posts antigos vêm por outra planilha, com a data e o autor originais.

*Papel: proprietário ou administrador.*

## O que dá para trazer

| O quê | Como |
|---|---|
| Pessoas (e-mail, nome, telefone, cargo, biografia) | [Importar membros por planilha](/membros/importar-membros) |
| Grupos, tags e campos do perfil | Na mesma planilha, uma coluna para cada. Grupo que não existe é criado; campo novo também |
| Badges que cada pessoa já tinha | Na mesma planilha, coluna **Badges**, com os nomes do catálogo da comunidade |
| Pontos que cada pessoa já tinha | Na mesma planilha, coluna **Pontos iniciais** |
| Posts e artigos, com a data e o autor originais | [Importar conteúdo por planilha](/espacos/importar-conteudo) |

## Antes de importar

1. **Monte a estrutura**: seções, espaços e grupos. Ver [Monte a estrutura](/primeiros-passos/monte-a-estrutura).
2. **Crie os badges** em **Administração › Engajamento**, visão **Badges**, **Novo badge**, com os **mesmos nomes** da plataforma antiga. Só entram badges que estão no catálogo: um nome que não existe trava a importação até você criá-lo ou marcá-lo para ignorar. Ver [O catálogo](/membros/engajamento#o-catalogo).
3. **Ligue a [gamificação](/membros/gamificacao)** e, se quiser, monte os níveis. Com ela desligada, os pontos da planilha são ignorados.
4. **Exporte a planilha** da plataforma antiga, em .xlsx ou .csv, com uma linha por pessoa.

## A planilha de exemplo

Baixe a [planilha de exemplo (.csv)](/exemplos/migrar-membros-pt.csv) e troque pelos seus dados:

| E-mail | Nome | Sobrenome | Cargo | Grupo | Badges | Pontos | Aceito participar |
|---|---|---|---|---|---|---|---|
| maria@memberfy.net | Maria | Souza | Product Manager | Fundadores | Fundadora; Mentora | 1.500 | Sim |
| joao@memberfy.net | João | Lima | Engenheiro de dados | Fundadores | Mentor | 820 | Sim |
| ana@memberfy.net | Ana | Costa | Designer | | Primeiro post | 250 | Sim |
| pedro@memberfy.net | Pedro | Alves | Analista | | | | Sim |

- **Badges:** vários na mesma célula, separados por `;`. A vírgula pode fazer parte do nome. Maiúsculas e acentos não importam.
- **Pontos:** um número inteiro de 1 a 100.000. Valem `1.500`, `1,500` e `250.0`; vazio ou 0 não dá pontos. Um valor com casas decimais (`12,5`) ou que não é número é inválido: a pessoa entra sem os pontos, com aviso na linha.

## Importar

1. **Administração › Membros**, **Convidar Membros**, aba **Importar planilha**.
2. Escreva a **Origem da lista** (*Membros da plataforma antiga*), escolha o arquivo e siga para **Colunas**.
3. Mande cada coluna para o destino: *E-mail* para **E-mail**, *Nome* e *Sobrenome*, *Cargo*, *Grupo* para **Grupos**, *Badges* para **Badges**, *Pontos* para **Pontos iniciais** e *Aceito participar* para **Consentimento**, com *Sim* contando como sim.
4. No **Resumo**, confira os badges que não estão no catálogo (crie ou ignore), os pontos inválidos, quem já recebeu pontos de outra importação e **em que nível** as pessoas vão ficar.
5. **Importar**.

## O que acontece

- **Pessoas novas** recebem o convite por e-mail com **Definir minha senha**, como em toda importação; quem já é membro não recebe nada.
- **Badges e pontos chegam em silêncio:** nada de e-mail ou aviso no sino, e nenhum workflow dispara (**Recebeu badge**, **Subiu de nível**, **Atingiu N pontos**). O [webhook](/api/eventos-de-webhook) de badge recebido sai, com a origem importação.
- **Pontos uma vez só por pessoa**, somando todas as importações: se você importar de novo, quem já recebeu não ganha outra vez.
- **Quem já tem o badge** continua com ele.
- O nível de cada pessoa sai dos pontos. Quem chega pela importação ainda não tem atividade da semana, então um nível que pede atividade só vem quando ela participar.

## Exemplo

Uma comunidade de 1.200 pessoas sai de outra plataforma. Antes, cria no catálogo os badges *Fundadora*, *Mentora* e *Primeiro post* e liga a gamificação. A planilha traz um badge *Beta tester* que não existe mais: no resumo, ela o marca para ignorar. O resumo mostra 900 pessoas no nível 1, 280 no nível 3 e 20 no nível 5. Importa: os convites saem, os badges e os pontos aparecem no perfil de cada um, e ninguém recebe aviso de badge.

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| *Estes badges não estão no catálogo: …* | Crie cada badge com esse nome no catálogo ou marque-o para ignorar |
| A pessoa entrou sem os pontos | O valor tinha casas decimais ou não era número; corrija e ajuste à mão em **Ajustar pontos**. Importar de novo não dá os pontos a quem já recebeu de uma importação |
| Ninguém recebeu pontos | A gamificação estava desligada |
| O badge não veio | O nome não bate com o catálogo, ou estava marcado para ignorar |

## Relacionados

- [Importar membros por planilha](/membros/importar-membros)
- [Importar conteúdo por planilha](/espacos/importar-conteudo)
- [Engajamento e badges](/membros/engajamento#badges)
- [Gamificação](/membros/gamificacao)