Como Reimportar a Lista de Seguindo do Mastodon a Partir de um CSV

Se você exportou sua lista de seguindo do Mastodon como um arquivo CSV, mas perdeu acesso à conta antiga ou precisa reconstruir sua rede em uma nova instância, reimportar essa lista economiza horas de busca manual. O Mastodon permite exportar sua lista de seguindo, seus seguidores e seus dados da conta como arquivos CSV, mas o recurso de importação é deliberadamente limitado para evitar spam e abuso. Este artigo explica como preparar um arquivo CSV para reimportação, o método correto para enviá-lo e o que fazer quando o botão de importação parece ausente ou esmaecido. Você aprenderá as etapas exatas para restaurar sua lista de seguindo em qualquer instância do Mastodon.

Por que o Mastodon exige um formato CSV específico para importações de seguindo

O Mastodon não aceita qualquer arquivo CSV que você criar. O recurso de importação espera uma estrutura muito específica para corresponder contas na rede federada. Quando você exporta sua lista de seguindo de qualquer conta do Mastodon, o sistema gera um arquivo CSV com uma única coluna chamada AccountAddress. Cada linha contém um handle de conta completo no formato @username@instance.social. Esse formato permite que o processo de importação localize cada conta no fediverso pelo seu endereço único.

A razão pela qual o Mastodon restringe o formato é para evitar seguir em massa contas inválidas ou maliciosas. Se o CSV contiver outros nomes de coluna, dados extras ou sintaxe de handle incorreta, a importação falhará silenciosamente ou pulará essas linhas. O processo de importação também respeita os limites de taxa definidos pelo administrador da instância, então você não pode seguir mais do que um certo número de contas por hora ou dia apenas através da importação. Entender essas restrições ajuda você a preparar um arquivo limpo que funcione na primeira tentativa.

Passos para reimportar sua lista de seguindo do Mastodon a partir de um arquivo CSV

1. Localize seu arquivo CSV
   Encontre o arquivo CSV que você exportou anteriormente. Se você não o tiver, exporte-o da sua conta antiga do Mastodon acessando Preferências > Importar e exportar > Exportar e clicando no botão CSV ao lado de Lista de seguindo. O nome do arquivo geralmente é following_accounts.csv.
2. Abra o arquivo CSV em um editor de texto
   Use o Bloco de Notas ou qualquer editor de texto simples. Não use Excel ou Google Sheets a menos que salve o arquivo como CSV UTF-8. Verifique se a primeira linha lê exatamente AccountAddress sem espaços ou caracteres extras.
3. Verifique cada handle no arquivo
   Cada linha após o cabeçalho deve conter um handle válido do Mastodon como @user@mastodon.social. Remova handles que contenham caracteres inválidos, @ faltando ou URLs completas. Se você vir https://mastodon.social/@user, altere para @user@mastodon.social.
4. Faça login na sua conta de destino do Mastodon
   Abra sua instância do Mastodon em um navegador e faça login na conta onde deseja restaurar a lista de seguindo.
5. Navegue até a página de importação
   Clique no ícone de perfil no canto superior direito e selecione Preferências. Na barra lateral esquerda, clique em Importar e exportar e depois na aba Importar.
6. Selecione o tipo de importação
   No menu suspenso rotulado O que você deseja importar?, escolha Lista de seguindo. Não selecione outra opção como Favoritos ou Silenciados.
7. Escolha o modo de mesclagem
   Abaixo do menu suspenso, você vê dois botões de opção: Mesclar e Sobrescrever. Selecione Mesclar para adicionar as contas importadas à sua lista de seguindo existente. Selecione Sobrescrever para substituir completamente sua lista de seguindo atual pelas contas importadas.
8. Envie o arquivo CSV
   Clique no botão Escolher arquivo e selecione seu arquivo CSV preparado no computador. Depois clique no botão Enviar.
9. Aguarde a conclusão da importação
   O Mastodon processa o arquivo em segundo plano. Você verá um banner verde de sucesso se o upload for aceito. Dependendo do número de handles, o seguimento real pode levar vários minutos ou até uma hora. Verifique sua lista de seguindo na página do seu perfil para confirmar se as contas aparecem.

Erros comuns e limitações ao reimportar listas de seguindo

O botão de importação está esmaecido ou ausente

Algumas instâncias do Mastodon desabilitam completamente o recurso de importação CSV para evitar spam. Se a aba de importação não mostrar botão de upload ou o botão estiver esmaecido, o administrador da sua instância desativou as importações. Você não pode contornar essa restrição pela sua conta. Entre em contato com o administrador da sua instância ou considere mudar para uma instância que permita importações.

Contas não aparecem após a conclusão da importação

Se a importação for bem-sucedida, mas você vir menos contas do que o esperado, a causa mais comum é a formatação inválida do handle no arquivo CSV. Abra o arquivo e verifique se cada handle usa o formato @username@instance.social. Verifique também se o nome da instância está correto e se a conta ainda existe. Contas deletadas ou suspensas são ignoradas silenciosamente durante a importação.

O arquivo CSV é muito grande para enviar

As instâncias do Mastodon geralmente limitam uploads CSV a 5.000 linhas ou 10 MB. Se o seu arquivo exceder esses limites, divida o CSV em vários arquivos menores usando um editor de texto. Por exemplo, se você tem 12.000 handles, crie três arquivos de 4.000 handles cada. Importe cada arquivo separadamente, esperando pelo menos uma hora entre as importações para respeitar os limites de taxa.

Importar duplica seus seguimentos existentes

Se você selecionar o modo Mesclar e algumas contas já estiverem na sua lista de seguindo, o Mastodon não cria duplicatas. O sistema verifica cada handle em relação à sua lista atual antes de seguir. Se você selecionar Sobrescrever, o Mastodon deixa de seguir qualquer conta que não esteja no arquivo importado e segue apenas as contas no CSV.

Item	Exportação CSV	Importação CSV
Formato do arquivo	Uma coluna: AccountAddress	Deve corresponder exatamente ao formato de exportação
Sintaxe do handle	@username@instance.social	Mesmo formato exigido
Máximo de linhas	Ilimitado	Geralmente 5.000 por arquivo
Comportamento de mesclagem	N/A	Adiciona à lista existente sem duplicatas
Comportamento de sobrescrita	N/A	Substitui toda a lista de seguindo
Efeito imediato	Download concluído imediatamente	Solicitações de seguimento processadas em segundo plano

Agora você pode restaurar sua lista de seguindo do Mastodon a partir de qualquer arquivo CSV formatado corretamente. Após a importação terminar, verifique seu contador de seguindo na página do perfil para confirmar que o processo funcionou. Se precisar importar uma lista de uma plataforma que não seja Mastodon, como Twitter, você deve converter os handles para o formato @username@instance.social primeiro. Para importações grandes, sempre divida o arquivo em partes de 5.000 linhas ou menos para evitar rejeição do upload.