Como Preencher o Histórico de Federação para uma Conta do Mastodon Recém-Seguida

Quando você segue uma nova conta no Mastodon, o servidor não busca automaticamente as postagens antigas dessa conta. Isso significa que sua linha do tempo federada pode mostrar apenas postagens novas, deixando uma lacuna no feed. A ausência de conteúdo mais antigo não é um bug, mas uma escolha de design para reduzir a carga do servidor e o uso de armazenamento. Este artigo explica como solicitar manualmente o preenchimento do histórico de federação para uma conta recém-seguida no Mastodon, permitindo que você veja as postagens públicas antigas dela.

Por que o Mastodon Não Preenche Automaticamente o Histórico de Federação

O Mastodon foi projetado para ser uma rede social federada e leve. Diferente de plataformas centralizadas que armazenam todas as postagens de todos os usuários, as instâncias do Mastodon armazenam apenas as postagens que chegam pela linha do tempo federada ou são explicitamente buscadas. Quando você segue uma nova conta, a instância recebe apenas a postagem mais recente ou um pequeno lote de postagens recentes. Isso é chamado de “handshake de follow”. O handshake transfere o ID da última postagem, mas não o histórico completo.

A razão técnica é que postagens antigas podem não estar armazenadas na instância de origem da conta seguida. O Mastodon usa um modelo de armazenamento distribuído onde cada instância mantém apenas as postagens de seus próprios usuários. Se a instância da conta seguida já removeu postagens antigas devido a limites de armazenamento, essas postagens ficam permanentemente indisponíveis. As solicitações de preenchimento pedem que a instância remota envie quaisquer postagens antigas disponíveis que ainda estejam armazenadas.

O preenchimento não é ativado por padrão porque aumenta o tráfego de saída e a carga de processamento em ambas as instâncias. Uma única solicitação de preenchimento pode transferir centenas de postagens, o que pode sobrecarregar o servidor. Por isso, o Mastodon oferece três formas de preencher: uma opção manual na interface do usuário, um endpoint de API para desenvolvedores e um comando de administrador no nível do servidor.

Passos para Preencher o Histórico de Federação de uma Conta Recém-Seguida

Os passos exatos dependem se você é um usuário comum, um desenvolvedor integrando com a API ou um administrador de servidor. Todos os métodos exigem que a conta tenha sido seguida pelo menos uma vez antes do envio da solicitação de preenchimento. Se você seguir uma conta e solicitar o preenchimento imediatamente, o servidor pode não ter concluído o handshake inicial ainda.

Método 1: Usando a Interface Web do Mastodon

Este método funciona na versão 4.0.0 ou superior do Mastodon. A opção de preenchimento está disponível diretamente na página de perfil da conta.

1. Navegue até o perfil da conta seguida
   Abra a interface web do Mastodon no seu navegador. Vá para a página de perfil da conta que você deseja preencher. Você já deve estar seguindo essa conta.
2. Abra o menu da conta
   Clique no botão de menu de três pontos localizado próximo ao botão seguir/deixar de seguir no perfil. No celular, esse botão geralmente fica no canto superior direito do cabeçalho do perfil.
3. Selecione a opção de Preenchimento
   No menu suspenso, escolha a opção “Preencher” ou “Solicitar postagens antigas”. O texto exato pode variar conforme a versão do Mastodon. Uma caixa de diálogo de confirmação aparece.
4. Confirme a solicitação
   Clique em “Confirmar” ou “Solicitar” na caixa de diálogo. O servidor envia uma solicitação de preenchimento para a instância remota. Dependendo do número de postagens, o processo pode levar vários minutos para ser concluído.

Após o processamento da solicitação, as postagens antigas aparecem na sua linha do tempo inicial e na página de perfil da conta na sua instância. Você não precisa atualizar a página manualmente. As postagens são carregadas à medida que são recebidas.

Método 2: Usando a API do Mastodon

Desenvolvedores e usuários avançados podem acionar o preenchimento via API REST do Mastodon. Este método requer um token de acesso com os escopos read:accounts e write:accounts.

1. Obtenha o ID da conta
   Use o endpoint GET /api/v1/accounts/lookup com o nome de usuário e domínio da conta para obter o ID numérico da conta. Por exemplo: GET https://mastodon.exemplo/api/v1/accounts/lookup?acct=usuario@remoto.social
2. Envie a solicitação POST de preenchimento
   Envie uma solicitação POST para POST /api/v1/accounts/:id/backfill, onde :id é o ID numérico da conta obtido no passo 1. Inclua o cabeçalho de autorização com seu token bearer. O servidor responde com HTTP 202 Accepted se a solicitação for enfileirada.
3. Monitore o status do preenchimento
   O Mastodon não fornece um endpoint dedicado para verificar o progresso do preenchimento. Você pode verificar a conclusão acessando a página de perfil da conta na sua instância. As postagens antigas aparecem automaticamente assim que o preenchimento termina.

O método da API é útil para automatizar o preenchimento de várias contas ou integrar com ferramentas de terceiros. O limite de taxa para solicitações de preenchimento é geralmente uma solicitação por conta por hora.

Método 3: Comando de Preenchimento para Administradores de Servidor

Administradores de instância podem preencher postagens de qualquer conta em seu servidor usando a ferramenta de linha de comando tootctl. Este método não exige que o usuário solicite o preenchimento manualmente.

1. Abra o terminal do servidor
   Faça login no seu servidor Mastodon via SSH. Navegue até o diretório de instalação do Mastodon, geralmente /home/mastodon/live.
2. Execute o comando de preenchimento
   Execute: RAILS_ENV=production bin/tootctl accounts backfill [username]. Substitua [username] pelo nome de usuário completo incluindo o domínio, como usuario@remoto.social. O comando enfileira um job de preenchimento para essa conta.
3. Verifique o status do job
   Use RAILS_ENV=production bin/tootctl sidekiq queues para verificar a fila do Sidekiq em busca de jobs de preenchimento. O job é processado de forma assíncrona. O tempo necessário depende do número de postagens e da velocidade de resposta do servidor remoto.

Os administradores também podem ativar o preenchimento automático para todos os novos follows definindo a variável de ambiente BACKFILL_ENABLED=true no arquivo .env.production. Essa configuração aciona o preenchimento para cada novo follow automaticamente, mas aumenta significativamente a carga do servidor.

Problemas Comuns ao Preencher o Histórico de Federação

Opção de Preenchimento Não Visível na Interface Web

Se você não vir a opção de preenchimento no menu da conta, sua instância do Mastodon pode estar executando uma versão anterior à 4.0.0. Verifique a versão da sua instância acessando /about/more na sua instância. Se a versão for mais antiga, use o método da API ou peça ao seu administrador para atualizar. Verifique também se você está seguindo a conta. A opção de preenchimento aparece apenas para contas que você já segue.

Solicitação de Preenchimento Falha ou Retorna Erro

Uma solicitação de preenchimento pode falhar se a instância remota estiver offline, com limite de taxa ou bloquear a solicitação. O Mastodon retorna HTTP 422 ou 429 nesses casos. Aguarde pelo menos uma hora antes de tentar novamente. Se a instância remota estiver bloqueando sua instância completamente, o preenchimento não é possível. A única alternativa é visualizar as postagens da conta diretamente na instância remota.

Postagens Antigas Ainda Não Aparecem Após o Preenchimento

A instância remota pode ter excluído postagens antigas devido à sua própria política de retenção de dados. As instâncias do Mastodon geralmente mantêm postagens por um tempo limitado, muitas vezes 30 dias. Se as postagens foram excluídas antes da solicitação de preenchimento, elas são perdidas permanentemente. Além disso, o processo de preenchimento busca apenas postagens públicas. Postagens restritas a seguidores ou diretas não são preenchidas.

Item	Método Interface Web	Método API
Acesso Necessário	Usuário comum seguindo a conta	Token de API com escopo read/write accounts
Versão do Mastodon	4.0.0 ou superior	Qualquer versão com suporte à API
Limite de Taxa	Uma solicitação por conta por hora	Uma solicitação por conta por hora
Confirmação de Sucesso	Postagens aparecem na linha do tempo automaticamente	HTTP 202, depois postagens aparecem automaticamente

Preencher o histórico de federação preenche lacunas na sua linha do tempo quando você segue uma nova conta no Mastodon. Use o método da interface web para solicitações pontuais. Use o método da API para automação. Use o comando de administrador para controle em todo o servidor. Se o preenchimento falhar, verifique a disponibilidade da instância remota e a política de retenção de dados. O recurso de preenchimento está disponível no Mastodon 4.0.0 e superior. Para versões anteriores, a única opção é visualizar as postagens da conta diretamente na instância de origem.