# Migrar de outra plataforma

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

Vindo de outra plataforma, não precisa de começar do zero: uma folha de cálculo traz cada pessoa com o que ela já tinha lá, incluindo os **badges** e os **pontos**, para ninguém perder o que conquistou. As publicações antigas vêm por outra folha de cálculo, 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 folha de cálculo](/membros/importar-membros) |
| Grupos, etiquetas e campos do perfil | Na mesma folha, uma coluna para cada. Um grupo que não existe é criado; um campo novo também |
| Badges que cada pessoa já tinha | Na mesma folha, coluna **Badges**, com os nomes do catálogo da comunidade |
| Pontos que cada pessoa já tinha | Na mesma folha, coluna **Pontos iniciais** |
| Publicações e artigos, com a data e o autor originais | [Importar conteúdo por folha de cálculo](/espacos/importar-conteudo) |

## Antes de importar

1. **Monte a estrutura**: secções, espaços e grupos. Ver [Monte a estrutura](/primeiros-passos/monte-a-estrutura).
2. **Crie os badges** em **Administração › Envolvimento**, vista **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 bloqueia a importação até o criar ou o marcar 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 folha são ignorados.
4. **Exporte a folha de cálculo** da plataforma antiga, em .xlsx ou .csv, com uma linha por pessoa.

## A folha de cálculo de exemplo

Descarregue a [folha de cálculo de exemplo (.csv)](/exemplos/migrar-membros-pt.csv) e substitua 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. Aceitam-se `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**, separador **Importar folha de cálculo**.
2. Escreva a **Origem da lista** (*Membros da plataforma antiga*), escolha o ficheiro e avance para **Colunas**.
3. Envie 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* a contar como sim.
4. No **Resumo**, confirme 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 a minha palavra-passe**, como em qualquer importação; quem já é membro não recebe nada.
- **Badges e pontos chegam em silêncio:** nada de e-mail nem 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 única vez por pessoa**, somando todas as importações: se 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, por isso um nível que exige 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 folha traz um badge *Beta tester* que já não existe: no resumo, marca-o 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 corresponde ao catálogo, ou estava marcado para ignorar |

## Relacionados

- [Importar membros por folha de cálculo](/membros/importar-membros)
- [Importar conteúdo por folha de cálculo](/espacos/importar-conteudo)
- [Envolvimento e badges](/membros/engajamento#badges)
- [Gamificação](/membros/gamificacao)