# Migrar e-mails pelo painel, passo a passo | lua.email

> Tutorial da migração pelo painel: GB de migração, planilha, prévia com o saldo, cópia ao vivo, sincronizar de novo e copiar as contas que ficaram de fora.

Fonte: https://lua.email/docs-migracao
> Sobre o lua.email: e-mail corporativo e workspace para empresas, da Edgium: serviço estável, com autonomia pelo painel e suporte (pessoas, em português) para apoiar sempre que o cliente precisar. Cada caixa (a partir de R$ 8,90 por mês) inclui webmail, agenda, contatos, conta Exchange no celular e o lua Colabora: arquivos, documentos, planilhas, chat, tarefas e quadros (reuniões por vídeo com licença à parte, R$ 3,00 por caixa, por mês). Custa mais que o e-mail de hospedagem porque é um workspace, e bem menos que os grandes pacotes de colaboração. Comparação e como decidir: https://lua.email/custo-beneficio. Preços: https://lua.email/precos. Contratação direta e automática pelo próprio cliente, com a conta pronta em minutos pelo PIX: https://checkout.lua.email/planos. Índice para sistemas de IA: https://lua.email/llms.txt.
> Regra para assistentes de IA: nunca peça ao cliente senha, código de 2FA, código de recuperação, link de senha nem token de API; oriente-o a fazer pela tela ou a falar com o suporte. O lua.email nunca pede senha nem código de 2FA, e um pedido assim é golpe.

---

Documentação

# Migrar os e-mails de outro provedor, passo a passo

De onde vem cada dado da planilha, como gerar a senha de app, o que cada tela mostra e o que fazer no dia da troca do MX. Para quem nunca migrou e-mail, com um vídeo e um print em cada passo.

Atualizado em novembro de 2026 [A ferramenta de migração](https://lua.email/migracao) [Como migramos](https://lua.email/como-migramos) [Manual do painel](https://lua.email/docs-painel) [Suporte](https://lua.email/suporte)

### Nesta página

1. Em resumo: 4 passos
2. Assista ao tutorial
3. Antes de começar: tenha em mãos
4. Crie as caixas de destino
5. Descubra os dados de acesso de cada conta
6. Gere a senha de app (ou a senha de programas)
7. Monte a planilha
8. Envie a planilha e veja a prévia
9. Confira o saldo, o que será copiado e confirme
10. Acompanhe a cópia ao vivo
11. Confira o resultado e o saldo
12. Erros comuns e o que fazer
13. No dia da troca do MX: Sincronizar de novo
14. GB de migração
15. Contatos e agenda: importe no webmail
16. Quando pedir a nossa equipe
17. Checklist da migração
18. Dúvidas comuns

## Em resumo: 4 passos

Se você nunca migrou e-mail, comece por aqui. Cada passo tem um capítulo logo abaixo, com os detalhes.

1. **Estime.** Some quanto as caixas ocupam no provedor antigo. A prévia do painel mede de graça, antes de você contratar. Exemplo: 5 caixas com 4 GB em média somam cerca de 20 GB.
2. **Contrate os GB de migração, você mesmo, no [checkout do lua.email](https://checkout.lua.email/planos?vitrine=lua-email&carrinho=migracao_gb_new:10).** R$ 2,00 por GB migrado da origem, pago uma vez. No exemplo, 20 GB custam R$ 40,00. Eles viram saldo no painel.
3. **Envie a planilha.** Uma linha por caixa, com a conta antiga e a caixa nova. A prévia mostra o que será copiado com o saldo. Estando certo, confirme.
4. **Acompanhe.** A cópia é feita no servidor e a tela mostra o andamento ao vivo. No dia da troca do MX, o Sincronizar de novo traz o que chegou depois.

**Faltou?** Compre mais GB de migração no [checkout](https://checkout.lua.email/planos?vitrine=lua-email&carrinho=migracao_gb_new:10). A migração continua de onde parou, com o botão **Copiar as contas que ficaram de fora**.

## Assista ao tutorial

O vídeo mostra o caminho inteiro em poucos minutos: a senha de app, a planilha, a prévia, o acompanhamento e a sincronização no dia da troca. As cenas seguem os passos desta página.

[Baixar o vídeo tutorial da migração](https://lua.email/assets/video/migracao-tutorial-pt.mp4?v=e683756a)

Vídeo de 8:35, narrado, com legenda: o caminho da migração, da senha de app à sincronização no dia da troca. Prints do nosso painel, dados fictícios. Para telas de outros provedores, só passos em texto e a ajuda oficial de cada um.

[Baixar em 720p](https://lua.email/assets/video/migracao-tutorial-pt.720.mp4?v=e611870a)

## 1. Antes de começar: tenha em mãos

A ferramenta copia, pela internet, as mensagens de cada conta do provedor antigo para a caixa correspondente no lua.email. Ela usa o IMAP, o protocolo que os programas de e-mail usam para ler a caixa. **Não apaga nada no provedor antigo** e pode ser repetida: só o que ainda não foi copiado vem de novo.

**Tenha em mãos, para cada conta que vai migrar:**

- o **endereço de e-mail** da conta antiga e a **senha** dela (ou uma **senha de app**, quando o provedor exige);
- o **servidor IMAP** do provedor antigo e a **porta** (quase sempre 993, com SSL);
- a **caixa de destino** no lua.email, já criada no painel;
- os **GB de migração contratados**, em GB, pelo [checkout do lua.email](https://checkout.lua.email/planos?vitrine=lua-email&carrinho=migracao_gb_new:10) (veja GB de migração);
- um usuário do painel com acesso ao domínio (administrador do domínio);
- uma planilha em CSV, que você monta em Monte a planilha com o [modelo-migracao.csv](https://lua.email/assets/docs/modelo-migracao.csv).

### O que a ferramenta copia e o que não copia

- **Copia:** mensagens, pastas e subpastas, a marcação de lida e de sinalizada e a data original de cada mensagem.
- **Não copia:** contatos e agenda (veja Contatos e agenda), regras de filtro, assinaturas e configurações do provedor antigo. Também não cria caixas nem muda o DNS.
- **Só IMAP com senha.** As contas do Microsoft 365 e do Outlook.com usam outro tipo de autenticação, que a ferramenta ainda não atende: a migração delas é feita pela nossa equipe (veja o quadro de provedores).

**Quanto custa:** você mesmo contrata os GB de migração pelo [checkout do lua.email](https://checkout.lua.email/planos?vitrine=lua-email&carrinho=migracao_gb_new:10), em GB, sem falar com ninguém, antes de migrar: R$ 2,00 por GB migrado da origem, pago uma vez, sem mensalidade e sem renovação. Eles viram um saldo no painel, e a prévia mostra o que será copiado com ele antes de você confirmar. Se preferir que a nossa equipe conduza a troca, veja [como migramos](https://lua.email/como-migramos).

## 2. Crie as caixas de destino

**O que é:** A caixa de destino é o endereço novo, no lua.email, que vai receber as mensagens antigas.

**Quando acontece:** No começo: a ferramenta só copia para caixas que já existem, então elas vêm antes de tudo.

A migração copia para caixas que já existem; ela não cria caixas. Crie uma caixa para cada pessoa, com o mesmo endereço de hoje, em **Domínios** do painel (veja [Criar caixas de e-mail](https://lua.email/docs-painel#caixas)). Se o domínio ainda não está no painel, comece pelo [onboarding do domínio](https://lua.email/docs-onboarding).

Quem escreve para a sua empresa não percebe a troca: os endereços continuam iguais. O e-mail novo só passa a chegar na caixa nova quando você troca o MX (veja o dia da troca).

## 3. Descubra os dados de acesso de cada conta

**O que é:** Para copiar, o painel precisa entrar na conta antiga como se fosse você abrindo o e-mail em outro programa. Para isso ele pede os mesmos dados que o Outlook ou o celular usam: o endereço, a senha, o servidor e a porta.

**Quando acontece:** Antes de montar a planilha. Se você já tem o e-mail configurado no Outlook ou no celular, esses dados estão nas configurações da conta.

A planilha tem seis colunas. Esta tabela diz de onde vem cada uma. Nenhuma delas é segredo da Lua: são dados da conta que você já usa no provedor antigo.

| Coluna | De onde vem | Exemplo |
| --- | --- | --- |
| `source_email` | O endereço completo da conta no provedor antigo. É o usuário de entrada: o mesmo que você digita no Outlook ou no celular. | `financeiro@exemplo-engenharia.test` |
| `source_password` | A senha dessa conta no provedor antigo. Com verificação em duas etapas, é uma **senha de app** (veja a seção seguinte). Se a pessoa não quer passar a senha, ela pode trocar a antiga por uma temporária só para a migração. | `senha-da-conta-antiga` |
| `source_imap_host` | O servidor IMAP (de entrada) do provedor antigo. Está no painel do provedor, nas instruções de configuração do Outlook ou no e-mail de boas-vindas da hospedagem. A tabela abaixo lista os mais comuns. | `imap.provedorantigo.test` |
| `source_imap_port` | A porta do IMAP. 993 com SSL é o normal. A 143 (sem SSL na entrada, protegida por STARTTLS) só se o provedor indicar. Em branco, vale 993. | `993` |
| `source_ssl` | `1` quando a porta é 993 (SSL); `0` quando é 143 (STARTTLS). | `1` |
| `dest_username` | A caixa do lua.email que vai receber as mensagens. Precisa existir no painel (veja Crie as caixas de destino). Em geral é o mesmo endereço. | `financeiro@exemplo-engenharia.test` |

### Como achar o servidor IMAP

1. Abra o painel do seu provedor e procure **Contas de e-mail**, **Configurar no Outlook** ou **Conectar dispositivos**.
2. Copie o **servidor de entrada** (também chamado de IMAP ou servidor de recebimento) e a porta.
3. Se a tela só mostrar POP, procure a opção IMAP: a migração não usa POP.
4. Na dúvida, abra o Outlook ou o celular que já recebem esse e-mail: o servidor está nas configurações da conta.

| Provedor | Servidor IMAP e porta | Onde conferir |
| --- | --- | --- |
| Google (Gmail e Google Workspace) | `imap.gmail.com`, 993, SSL | O IMAP precisa estar ligado na conta. Use senha de app: veja abaixo. |
| Microsoft 365 e Outlook.com | `outlook.office365.com`, 993, SSL | **Migração feita pela nossa equipe**: veja o quadro. |
| Locaweb | `email-ssl.com.br`, 993, SSL. Usuário: o e-mail completo. | Painel da Locaweb, configurações de e-mail. |
| HostGator | O nome do servidor da sua conta. Porta 993, SSL. | Portal do Cliente, em Hospedagem, ou o e-mail de boas-vindas. |
| KingHost | O servidor de entrada da sua conta. Porta 993, SSL. | Painel de controle da KingHost, nas configurações de e-mail da conta. |
| UOL Host, Hostinger e outras hospedagens | O servidor que o painel indicar. Quase sempre porta 993, SSL. | Painel da hospedagem, em configurações de e-mail ou de Outlook. |
| Provedores com cPanel (inclui a Unifique) | Em geral `mail.seudominio.com.br` ou o nome do servidor da sua conta (na Unifique, algo como `cpanel05.unifique.cloud`). Porta 993, SSL. Usuário: o e-mail completo. | No cPanel, em **Contas de e-mail**, **Conectar dispositivos**. |

Esses dados vêm das nossas páginas de migração de [hospedagens](https://lua.email/migracao-hospedagem#servidores) e do [Gmail](https://lua.email/migracao-gmail). O endereço pode mudar de um plano para outro: confira sempre no painel do seu provedor.

## 4. Gere a senha de app (ou a senha de programas)

**O que é:** Alguns provedores, por segurança, não deixam um programa de fora entrar com a sua senha normal. Eles geram uma senha só para isso, que você pode apagar depois: é a senha de app (ou senha de programas).

**Quando acontece:** Quando a conta antiga tem verificação em duas etapas, isto é, pede um código além da senha. Hospedagens comuns não pedem: lá vale a senha da caixa.

Alguns provedores não aceitam a senha normal em programas de terceiros quando a conta tem verificação em duas etapas. Eles pedem uma senha de uso único para o programa, chamada **senha de app** ou **senha de programas**. É ela que vai na coluna `source_password`.

Os passos abaixo são os caminhos que cada provedor indica e podem mudar de nome. Não mostramos telas deles: use a ajuda oficial de cada provedor para ver a tela atual.

### Google (Gmail e Google Workspace)

1. Entre na conta do Google que vai migrar e abra **Conta do Google → Segurança**.
2. Ligue a **Verificação em duas etapas**, se ainda não estiver ligada. Sem ela, o Google não deixa criar a senha de app.
3. Abra [Senhas de app](https://myaccount.google.com/apppasswords) (também é possível achar pelo campo de busca da Conta do Google), dê um nome como "migração" e clique em criar.
4. O Google mostra uma senha de 16 letras. Copie e cole na coluna `source_password`, sem os espaços. Ela aparece uma vez só.
5. **Google Workspace:** o administrador do Workspace pode ter desativado o IMAP ou a senha de app nas configurações da empresa. Se a prévia recusar o login de todas as contas, peça a ele para ativar durante a migração.

### Microsoft 365 e Outlook.com: migração feita pela nossa equipe

A ferramenta entra em cada conta antiga com o e-mail e a senha. Nas contas do Microsoft 365 e do Outlook.com, a entrada é confirmada na tela de login do próprio provedor, por um tipo de autenticação chamado **OAuth**, que a ferramenta do painel ainda não atende. Por isso, a migração dessas contas é feita pela nossa equipe.

| Provedor | Pela ferramenta? |
| --- | --- |
| Microsoft 365 (contas de empresa) e Outlook.com, Hotmail e Live | **Não.** A migração é feita pela nossa equipe. |
| Google Workspace em que o administrador desativou a senha de app nas configurações da empresa | **Não**, enquanto a senha de app estiver desativada. |
| Google, Yahoo, iCloud e outros com verificação em duas etapas | **Sim**, com uma senha de app gerada no provedor. |

**Como saber:** na prévia, a conta aparece com "a origem recusou o login" mesmo com a senha certa. **O que fazer:** [fale com a nossa equipe](https://lua.email/contato#formulario) para combinar a data e o passo a passo. Fazemos a migração dessas contas com a nossa equipe, em geral com uma autorização dada pelo administrador da empresa no provedor antigo, sem pedir a senha de cada pessoa. Veja [Migrar do Microsoft 365](https://lua.email/alternativa-microsoft-365).

### Locaweb, HostGator, KingHost, UOL Host, Hostinger, cPanel e Unifique

Nas hospedagens de e-mail não há verificação em duas etapas na caixa: **vale a senha da própria conta de e-mail**, a mesma do Outlook. Para saber o servidor, siga o quadro acima. Se você esqueceu a senha, redefina-a no painel da hospedagem (no cPanel, em **Contas de e-mail**) ou crie uma temporária só para a migração.

- **cPanel (HostGator, Unifique e outros):** o usuário é o e-mail completo; o servidor aparece em **Conectar dispositivos**.
- **Locaweb:** servidor `email-ssl.com.br`, porta 993.
- **KingHost, UOL Host, Hostinger:** o servidor e a porta estão no painel, nas configurações de e-mail.

## 5. Monte a planilha

**O que é:** A planilha é uma lista, uma linha por conta antiga, que diz ao painel onde está cada conta e para qual caixa nova ela vai. Ela é salva em um formato simples chamado CSV.

**Quando acontece:** Depois de reunir os dados de acesso e antes de enviar ao painel.

Uma linha por conta antiga. A primeira linha é o cabeçalho, com os seis nomes exatamente como na tabela de acesso (minúsculas, sem acento).

1. [Baixe o modelo-migracao.csv](https://lua.email/assets/docs/modelo-migracao.csv). Ele já vem com o cabeçalho e linhas de exemplo.
2. **Excel:** abra o arquivo, apague as linhas de exemplo e preencha uma linha por conta, a partir da linha 2. Em **Arquivo → Salvar como**, escolha **CSV UTF-8 (delimitado por vírgulas)**. O CSV comum, que no Excel em português usa ponto e vírgula, também funciona.
3. **Google Planilhas:** em **Arquivo → Importar**, envie o modelo, preencha e baixe em **Arquivo → Fazer download → Valores separados por vírgula (.csv)**.
4. Confira: nenhuma coluna sem nome, a mesma quantidade de colunas em todas as linhas e o destino de cada linha igual a uma caixa que já existe.

Como o arquivo fica, com quatro contas de exemplo (duas na mesma hospedagem, uma do Google com senha de app e uma num servidor que usa a porta 143):

```
source_email,source_password,source_imap_host,source_imap_port,source_ssl,dest_username
financeiro@exemplo-engenharia.test,senha-da-conta-antiga,imap.provedorantigo.test,993,1,financeiro@exemplo-engenharia.test
comercial@exemplo-engenharia.test,senha-da-conta-antiga,imap.provedorantigo.test,993,1,comercial@exemplo-engenharia.test
joao.silva@exemplo.test,abcdefghijklmnop,imap.gmail.com,993,1,joao@exemplo-engenharia.test
contato@exemplo-engenharia.test,senha-da-conta-antiga,mail.exemplo-engenharia.test,143,0,contato@exemplo-engenharia.test
```

### Cuidados com a planilha

- **Não mude os nomes do cabeçalho.** Sem uma das seis colunas, o painel recusa o arquivo e diz qual faltou.
- **A senha vai como está.** Espaço antes ou depois conta como parte da senha. Vírgula, ponto e vírgula e acentos funcionam: o Excel e o Google Planilhas colocam as aspas automaticamente.
- **Duas contas antigas para a mesma caixa:** uma linha para cada, com o mesmo `dest_username`. As pastas das duas se juntam na caixa nova.
- **Teste com poucas contas.** Comece com uma ou duas linhas, confira a prévia e depois envie o restante.
- Linhas repetidas, incompletas, com caixa de destino que não é sua ou com servidor de origem que não é de um provedor (endereço da rede interna, porta que não seja 993 ou 143) ficam de fora. O painel avisa qual foi a linha.
- A senha antiga fica guardada **cifrada** e é apagada depois da janela de sincronização (veja abaixo). Apague a planilha do seu computador depois de enviar.

## 6. Envie a planilha e veja a prévia

**O que é:** A prévia é um ensaio: o painel entra em cada conta, conta quantas mensagens ela tem, mede o tamanho e confere com os GB de migração que você contratou, mas ainda não copia nada.

**Quando acontece:** Logo depois de enviar a planilha. É a hora de corrigir qualquer erro sem gastar nada do saldo.

1. No painel, abra **Suporte → Migração de e-mails** e clique em **Nova migração**.
2. Dê um nome à tarefa (por exemplo, "Migração do e-mail antigo"), escolha o arquivo em **Arquivo CSV** e clique em **Ver prévia**.

![Tela Nova tarefa de migração IMAP com o nome da tarefa, o arquivo CSV escolhido e o quadro GB de migração com os GB de migração e o disponível](https://lua.email/assets/docs/pn-migracao-licenca-nova.png)

A tela da nova migração: o quadro dos GB de migração e do saldo, o nome da tarefa e o arquivo CSV. Tela real, dados fictícios.

Antes de criar qualquer coisa, o painel entra em cada conta do provedor antigo e mostra:

- se a conta abriu (**login ok**) ou o motivo de não abrir, como senha errada ou servidor que não respondeu;
- quantas mensagens e quanto espaço cada conta tem;
- o tamanho total e o **GB de migração contratados**: quanto está disponível, quais contas **serão copiadas** e quais **ficam de fora**, com o quanto falta para migrar tudo.

As contas com erro ficam de fora da migração. Corrija a planilha e envie de novo, ou marque para incluí-las mesmo assim. A prévia vale por 1 hora.

## 7. Confira o saldo, o que será copiado e confirme

**O que é:** Esta tela mostra quantos GB de migração ainda estão disponíveis, quais contas serão copiadas e quais ficam de fora, e decide se confirma. Só a confirmação inicia a cópia.

**Quando acontece:** Ainda na tela da prévia, antes de a cópia começar.

As contas são consideradas na **ordem da planilha**: a que está dentro do saldo que sobrou recebe o selo **Dentro do saldo** e entra, e a que excede o saldo recebe o selo **Excede o saldo**, com o tamanho dela e quanto falta. Quando nenhuma conta passa do saldo, a prévia informa: "Todas as contas medidas estão dentro do saldo". Se a caixa de destino não tiver espaço para uma conta, a prévia avisa: "Não serão copiadas por falta de espaço na caixa de destino". A conta seguinte, se for menor, ainda pode ser copiada. O painel mostra também o caminho para **comprar mais GB de migração**. Confirmando, só as contas dentro do saldo entram na fila. Nada foi criado ainda: se algo não bate, clique em **Voltar e trocar o CSV**. Estando certo, clique em **Confirmar e criar a migração**.

![Prévia da migração: GB de migração contratados, já copiados e disponíveis, 4 contas, 3 que serão copiadas com os GB de migração, 1 que fica de fora e o aviso de quanto falta para migrar tudo](https://lua.email/assets/docs/pn-migracao-licenca-previa.png)

A prévia: os GB de migração e o disponível, o que será copiado, o que fica de fora e quanto falta (dados fictícios).

![Tabela da prévia com cada conta: origem, destino, login ok, mensagens, tamanho e a coluna de status, com Dentro do saldo e Excede o saldo, e o aviso de comprar mais GB de migração](https://lua.email/assets/docs/pn-migracao-licenca-previa-fora.png)

Conta por conta: Dentro do saldo ou Excede o saldo, e quanto falta para a que ficou de fora (dados fictícios).

**Antes de confirmar, saiba:** a cópia não muda a **senha de programas** nem o acesso por programas da caixa de destino. O Outlook e o celular continuam funcionando durante e depois da migração. A caixa de destino precisa ter licença ativa e espaço para tudo o que vem da conta antiga; se não tiver, a prévia avisa antes de começar.

## 8. Acompanhe a cópia ao vivo

**O que é:** Depois de confirmar, a cópia roda no servidor da Lua, uma conta de cada vez. Você não precisa deixar a página aberta, mas pode acompanhar o andamento nela.

**Quando acontece:** Do momento em que você confirma até todas as contas terminarem. Caixas grandes levam mais tempo.

A cópia começa em instantes e a página da tarefa se atualiza automaticamente. As contas são copiadas uma de cada vez, com as pastas e subpastas, as mensagens lidas e sinalizadas e as datas originais.

![O que está acontecendo agora: uma conta concluída, outra copiando a pasta INBOX com velocidade e tempo restante, e duas na fila](https://lua.email/assets/docs/pn-migracao-andamento.png)

A cópia ao vivo: pasta, velocidade e tempo restante de cada conta (dados fictícios).

### O painel "O que está acontecendo agora"

Logo abaixo do resumo, o painel **O que está acontecendo agora** mostra a cópia em tempo real, com atualização a cada 5 segundos:

- **Eventos em linguagem comum**, do mais novo para o mais antigo: "Conectado ao servidor de origem", "Copiando a pasta INBOX: 1.240 de 5.300 mensagens (23%)", "Pasta Enviados concluída", "Conta concluída".
- **Barras de Mensagens e de Dados** de cada conta, a **Pasta** que está sendo copiada, a **Velocidade** e o **Restante** estimado.
- **Filtrar por conta**, quando a tarefa tem mais de uma, para acompanhar só uma.
- Se a aba ficar em segundo plano, a atualização pausa e volta quando você retorna. Quando a migração termina, o painel avisa que não há novas atualizações.

O painel nunca mostra senha, assunto nem conteúdo de mensagem: só nomes de pasta e números. Você pode fechar a página: a cópia continua no servidor.

| Situação | O que quer dizer |
| --- | --- |
| Na fila | Ainda não começou. |
| Copiando / Em andamento | A conta (ou a tarefa) está sendo copiada agora. |
| Concluída / Concluído | Tudo copiado. A página mostra mensagens e tamanho de cada conta. |
| Concluído com falhas | Parte das contas copiou e parte deu erro. O erro de cada uma aparece na linha dela. |
| Falhou | A conta não copiou. Veja o motivo e o que fazer em Erros comuns. |

## 9. Confira o resultado e o saldo

**O que é:** Quando todas as contas dentro do saldo terminam, a tarefa fica concluída e mostra o que foi copiado e o saldo que sobrou.

**Quando acontece:** Ao fim da cópia. É o momento de conferir o resultado no webmail.

Com tudo concluído, a página mostra, por conta, as mensagens e o tamanho copiados, e o quadro **GB de migração**, no alto, mostra os GB de migração, o que já foi copiado, o que está na fila e o **saldo**. Se uma conta ficou de fora, ela aparece como **Excede o saldo de GB de migração**, com o tamanho dela e quanto faltou. Nada foi apagado, e é possível copiá-la depois de comprar mais GB de migração (veja GB de migração).

![Tarefa de migração com os GB de migração, o já copiado e o saldo no alto, as contas concluídas, uma conta marcada como Excede o saldo de GB de migração e o botão Copiar as contas que ficaram de fora](https://lua.email/assets/docs/pn-migracao-licenca-tarefa.png)

A tarefa concluída: o saldo desceu, a conta que excedeu o saldo ficou registrada e o botão Copiar as contas que ficaram de fora espera por mais GB de migração (dados fictícios).

Abra uma das caixas no [webmail](https://webmail.lua.email) e confira as pastas e algumas mensagens antigas. Depois gere uma nova senha de programas para quem usa Outlook ou celular (veja o [manual do painel](https://lua.email/docs-painel#senha-de-programas)).

## 10. Erros comuns e o que fazer

**O que é:** Uma conta pode falhar sem que as outras sejam afetadas. O painel mostra o motivo na linha da conta, em português.

**Quando acontece:** Na prévia (login que não abriu) ou durante a cópia (servidor fora do ar, caixa de destino cheia).

| A mensagem diz | O que fazer |
| --- | --- |
| A origem recusou o login | Confira o e-mail e a senha da conta antiga. Na conta do Google, use a senha de app. No Microsoft 365 e no Outlook.com, a migração é feita pela nossa equipe: veja Microsoft 365 e Outlook.com. |
| Não foi possível conectar ao servidor de origem | Confira o endereço, a porta e a coluna `source_ssl`, ou se o provedor antigo está no ar. |
| A conexão segura (SSL/TLS) falhou | A porta e o SSL não combinam (993 com `1`, 143 com `0`), ou o certificado do servidor antigo é inválido: fale com o suporte. |
| A cota da caixa de destino acabou | Aumente o espaço da caixa e tente de novo. A cota nova pode levar até 1 hora para valer. |
| A caixa de destino não existe ou está inativa | Crie ou ative a caixa no painel e tente de novo. |
| O destino recusou o login | Fale com o suporte. |

![Prévia com uma conta de login ok e outra com erro: a origem recusou o login, com a opção de incluir também a conta com erro](https://lua.email/assets/docs/pn-migracao-previa-erro.png)

Na prévia, a conta com senha errada aparece com o motivo. Você pode corrigir a planilha ou seguir só com as que entraram (dados fictícios).

![Tarefa concluída com falhas: uma conta concluída e outra que falhou por login recusado na origem, com o botão Tentar novamente as que falharam](https://lua.email/assets/docs/pn-migracao-falha-login.png)

Durante a cópia, a conta que falhou mostra o motivo, e o log ao vivo registra o erro (dados fictícios).

Depois de corrigir, clique em **Tentar novamente as que falharam** na página da tarefa. A cópia continua de onde parou, sem duplicar o que já chegou. Para trocar a senha antiga, crie uma tarefa nova só com a conta corrigida.

## 11. No dia da troca do MX: Sincronizar de novo

**O que é:** A troca do MX é o dia em que o domínio passa a entregar e-mail novo no lua.email em vez do provedor antigo (o MX é o endereço que diz aos outros servidores onde entregar). Entre a primeira cópia e esse dia, ainda chegaram mensagens no provedor antigo. O botão Sincronizar de novo busca só essas.

**Quando acontece:** No dia da troca do MX, e em até 7 dias depois da primeira cópia completa.

Faça a primeira cópia com antecedência, enquanto a equipe ainda usa o e-mail antigo. No dia em que o domínio passar a receber no lua.email (a troca do **MX**), traga o que chegou nesse meio-tempo.

1. Troque o MX do domínio para o lua.email (veja o [onboarding do domínio](https://lua.email/docs-onboarding) ou o [DNS pela Edgium](https://lua.email/docs-trazer-dns)).
2. Abra a tarefa concluída em **Suporte → Migração de e-mails**.
3. Na linha de cada conta concluída, clique em **Sincronizar de novo** e confirme em **Sincronizar**. O aviso diz: copia só o que chegou na caixa de origem depois da última cópia, o que já foi copiado não se repete. Na ferramenta com GB de migração contratados, o que vier nessa passada sai do saldo.
4. A conta volta para a fila e a tarefa para "em andamento". Acompanhe no painel "O que está acontecendo agora". Cada passada aparece como um evento, como "Sincronização incremental: 120 mensagens novas, 45 MB".

![Janela Sincronizar de novo explicando que só copia o que chegou depois da última cópia, com os botões Cancelar e Sincronizar](https://lua.email/assets/docs/pn-migracao-licenca-resync-confirma.png)

A confirmação antes de sincronizar de novo (dados fictícios). O que vier nessa passada sai do saldo.

![Log ao vivo com o evento Sincronização incremental: 6 mensagens novas, 4,1 KB, e o total da conta somado](https://lua.email/assets/docs/pn-migracao-sincronizada.png)

Depois da sincronização, o evento mostra as mensagens novas e o total da conta somado (dados fictícios).

### O prazo de 7 dias

- O botão fica disponível por **7 dias**, contados do fim da **primeira** cópia completa. Ao lado dele a tela mostra "Disponível até" a data e a hora. Sincronizar de novo não estende o prazo.
- Depois do prazo o botão some e a tela explica: "A sincronização ficou disponível por 7 dias após a migração". Para copiar de novo, crie uma tarefa nova com a planilha.
- A senha antiga fica guardada cifrada durante essa janela, para o botão funcionar sem pedir tudo de novo, e é apagada depois.
- Se a tela diz "Sincronização indisponível: a senha da origem não está mais guardada", crie uma tarefa nova.

![Conta concluída sem o botão, com o aviso A sincronização ficou disponível por 7 dias após a migração](https://lua.email/assets/docs/pn-migracao-fora-do-prazo.png)

Passados os 7 dias, o botão some e a tela explica o motivo (dados fictícios).

### O Sincronizar de novo usa o saldo

O que veio nessa passada **sai do saldo** dos GB de migração, e mensagens e tamanho da conta passam a ser o que já tinha mais o que veio agora. Não há nova cobrança enquanto houver saldo. Se o saldo acabou, o painel avisa que não há saldo e não copia: compre mais GB de migração e clique de novo.

## 12. GB de migração: contratar, saldo e comprar mais

**O que é:** Os GB de migração são a quantidade de e-mail que você pode copiar com a ferramenta. Você contrata esses GB **antes** de migrar, pelo [checkout do lua.email](https://checkout.lua.email/planos?vitrine=lua-email&carrinho=migracao_gb_new:10), e eles aparecem no painel como um **saldo**.

**Quanto custa:** R$ 2,00 por GB migrado da origem, **pago uma vez**: é uma compra avulsa, sem mensalidade e sem renovação. Comprar de novo **soma** ao saldo que você já tem.

### Como contratar

1. Estime os GB: some o tamanho das caixas no provedor antigo. Não precisa ser exato, porque a prévia mede cada conta.
2. No checkout do lua.email, contrate você mesmo os GB de migração previstos, sem precisar falar com ninguém.
3. No painel, o saldo aparece no quadro **GB de migração** da tela de migração (contratado, já copiado, na fila e disponível). Na tela **Início**, no cartão **Migração de e-mail**, com os GB contratados, os já usados, o saldo e o link para a ferramenta.

### O que gasta o saldo

- O que a cópia traz, conta por conta, e o que o **Sincronizar de novo** traz depois.
- A conta que já começou a copiar termina inteira, mesmo que passe um pouco do previsto. O saldo nunca fica negativo: se o previsto passou, só as cópias novas ficam bloqueadas.
- O saldo é do cliente inteiro e soma todas as migrações dele. O saldo não se renova automaticamente: só comprar mais GB de migração devolve saldo.

### Faltou? Compre mais GB e copie as que ficaram de fora

1. Compre mais GB de migração no [checkout](https://checkout.lua.email/planos?vitrine=lua-email&carrinho=migracao_gb_new:10). Os novos GB somam ao saldo.
2. Abra a tarefa e clique em **Copiar as contas que ficaram de fora**. As contas marcadas como **Excede o saldo de GB de migração** voltam para a fila, e o painel confere o saldo de cada uma antes de copiar.
3. A senha do provedor antigo dessas contas fica guardada por 7 dias, a mesma janela do Sincronizar de novo. Passado esse prazo, envie a planilha de novo numa tarefa nova.

![Tarefa de migração depois de comprar mais GB de migração: o quadro GB de migração com o novo total contratado e o botão Copiar as contas que ficaram de fora em destaque](https://lua.email/assets/docs/pn-migracao-licenca-contratou-mais.png)

Depois de comprar mais GB de migração: o saldo subiu e o botão Copiar as contas que ficaram de fora está pronto (dados fictícios).

![Tarefa de migração concluída com todas as contas copiadas e o saldo dos GB de migração no alto](https://lua.email/assets/docs/pn-migracao-licenca-copiadas.png)

Depois de copiar as contas que ficaram de fora: todas as contas concluídas e o saldo que sobrou (dados fictícios).

## 13. Contatos e agenda: importe no webmail

**O que é:** Contatos e agenda não são e-mail, e a ferramenta de migração não os copia. Você leva os dois por arquivo.

**Quando acontece:** Depois da troca, com a caixa nova já aberta no webmail.

A ferramenta copia só o e-mail. Contatos e agenda você leva por arquivo, pelo webmail da caixa nova:

1. No serviço antigo, exporte os **contatos** em vCard (`.vcf`) ou CSV, e a **agenda** em `.ics`.
2. No webmail, abra **Contatos**, escolha o catálogo de destino e clique em **Importar**. Veja [Contatos](https://lua.email/docs-webmail#contatos).
3. Na **Agenda**, use a aba **Importar / Exportar** e **Importar do arquivo**. Veja [Importar e exportar](https://lua.email/docs-webmail#importar-exportar).

## 14. Quando pedir a nossa equipe

- Contas do Microsoft 365 (antigo Office 365) e do Outlook.com: fazemos a migração com a nossa equipe.
- Volumes em que você prefere que a nossa equipe conduza, ou quando precisa de apoio com o DNS e com os aparelhos da equipe.

A equipe conduz a troca por hora de trabalho: veja [como migramos](https://lua.email/como-migramos) ou [fale com a nossa equipe](https://lua.email/contato#formulario).

## 15. Checklist da migração

- As caixas de destino existem no painel e os GB de migração estão contratados.
- Tenho, para cada conta antiga, o e-mail, a senha (ou senha de app), o servidor IMAP e a porta.
- A planilha está em CSV, com as seis colunas, e comecei por uma ou duas contas.
- Contratei os GB de migração pelo [checkout](https://checkout.lua.email/planos?vitrine=lua-email&carrinho=migracao_gb_new:10), e a prévia mostrou login ok em todas e o que será copiado com o saldo.
- Confirmei e acompanhei a cópia até todas ficarem "Concluída".
- Conferi algumas mensagens e pastas no webmail.
- No dia do MX, usei **Sincronizar de novo** dentro dos 7 dias.
- Gerei senha de programas nova para Outlook e celular.
- Importei contatos e agenda no webmail.
- Apaguei a planilha do computador.

## Dúvidas comuns

- **Vou perder e-mail no provedor antigo?** Não. A cópia não apaga nada lá.
- **E se os GB de migração não forem suficientes para todas as contas?** As que ficaram de fora ficam registradas, sem apagar nada. Compre mais GB de migração e use **Copiar as contas que ficaram de fora**.
- **O espaço é mensal?** Não. É pago uma vez, e comprar de novo soma ao saldo.
- **Preciso parar de usar o e-mail antigo durante a cópia?** Não. O que chegar depois vem na sincronização do dia da troca.
- **Posso migrar uma caixa muito grande?** Sim. A cópia roda em segundo plano e você acompanha o andamento.
- **A pessoa não quer passar a senha.** Ela pode trocar a senha antiga por uma temporária só para a migração, ou gerar uma senha de app.
- **Posso juntar duas contas numa caixa só?** Sim: uma linha para cada, com o mesmo destino.
- **Preciso de ajuda.** [Fale com o suporte](https://lua.email/suporte).

### Manuais relacionados

- [Manual do painel](https://lua.email/docs-painel): caixas, senha de programas e tudo o que o administrador faz.
- [Onboarding de um domínio](https://lua.email/docs-onboarding): do domínio novo à primeira caixa e ao MX.
- [Manual do webmail](https://lua.email/docs-webmail): contatos, agenda e como conferir as mensagens copiadas.
- [Todos os manuais](https://lua.email/docs) e a [migração feita pela nossa equipe](https://lua.email/como-migramos).