Marcador de Conta Bot no Mastodon: Como Configurar para Postagens Automáticas via API

Se você mantém um poster automático no Mastodon, a plataforma espera que você marque sua conta como bot. Sem esse marcador, suas postagens automatizadas podem sofrer limites de taxa mais agressivos ou serem sinalizadas por outros usuários e instâncias. A flag de bot é uma configuração booleana simples que informa à API do Mastodon e a outros servidores que esta conta posta programaticamente. Este artigo explica exatamente o que o marcador de conta bot faz, como ativá-lo pela interface web e pela API, e o que muda depois de configurá-lo.

O que o Marcador de Conta Bot Faz e Por Que é Importante

O marcador de conta bot é uma flag de metadados armazenada nas configurações da sua conta do Mastodon. Quando ativado, o Mastodon adiciona um pequeno ícone de robô ao lado do nome da sua conta na página de perfil. Esse selo é visível para todos os usuários e instâncias que federam com você. O marcador não altera sua capacidade de postar, seguir ou ser seguido. Ele sinaliza que a conta opera sob controle automatizado, em vez de uso humano direto.

As instâncias do Mastodon podem usar a flag bot para ajustar limites de taxa. Muitas instâncias aplicam limites mais rigorosos a contas sem a flag bot que postam com alta frequência. Com a flag bot, a instância pode permitir uma cadência de postagem maior, pois espera um comportamento automatizado. A flag também ajuda outros usuários a decidir se devem seguir ou silenciar sua conta. Alguns clientes e filtros do Mastodon permitem que usuários ocultem contas bot de suas timelines completamente.

Do ponto de vista da API, a flag bot faz parte do objeto de credenciais que você pode ler e escrever usando a API REST do Mastodon. Quando você autentica com OAuth, seu token de acesso tem escopos que determinam se você pode atualizar o campo bot. O escopo write:accounts é necessário para alterar o marcador bot pela API. Sem esse escopo, a chamada à API falhará com um erro 403 Forbidden.

Pré-requisitos para Configurar o Marcador Bot

Antes de prosseguir, confirme que você tem o seguinte:

• Uma conta no Mastodon em uma instância que suporte a flag bot (todas as versões atuais do Mastodon suportam).
• Acesso à conta pela interface web ou um token de acesso à API com o escopo write:accounts.
• Se usar a API, um aplicativo registrado na sua instância que gerou o token de acesso.

Como Ativar o Marcador Bot pela Interface Web

O método pela interface web é a opção mais simples para contas únicas ou testes. Você não precisa de conhecimento de programação. Siga estes passos exatamente.

1. Abra as configurações do seu perfil
   Em qualquer cliente web do Mastodon, clique no ícone de engrenagem na barra lateral direita ou vá diretamente para Preferências. No celular, toque no seu avatar na barra inferior e selecione Preferências.
2. Navegue até a seção Perfil
   No menu Preferências, clique ou toque em Perfil. Esta seção contém seu nome de exibição, biografia, avatar, imagem de cabeçalho e a opção de conta bot.
3. Ative a opção de conta bot
   Role para baixo até ver a caixa de seleção rotulada Esta é uma conta bot. Marque a caixa. O rótulo não muda, mas a caixa agora mostra uma marca de seleção.
4. Salve suas alterações
   Clique no botão Salvar alterações na parte inferior da página Perfil. Uma faixa de confirmação verde aparece no topo da página informando Suas alterações foram salvas.
5. Verifique se o selo bot aparece
   Vá para sua página de perfil público. Você deve ver um pequeno ícone de robô ao lado do seu nome de exibição. Se não aparecer, atualize a página ou saia e entre novamente.

Como Configurar o Marcador Bot pela API do Mastodon

Para desenvolvedores que gerenciam várias contas bot ou integram a configuração em um script de implantação, use a API. O endpoint é PATCH /api/v1/accounts/update_credentials. O corpo da requisição deve incluir o campo bot definido como true ou false.

1. Obtenha um token de acesso com o escopo write:accounts
   Registre um aplicativo na sua instância do Mastodon usando a API. Use o fluxo de código de autorização ou o fluxo de credenciais do cliente. Certifique-se de que a lista de escopos inclua write:accounts. Salve o token de acesso em uma variável de ambiente segura.
2. Prepare a requisição à API
   Use uma ferramenta como curl, Python requests ou qualquer cliente HTTP. Defina o método HTTP como PATCH. Defina o cabeçalho Authorization como Bearer SEU_TOKEN_DE_ACESSO. Defina o cabeçalho Content-Type como application/json.
3. Envie o corpo da requisição
   O corpo JSON deve conter a chave bot com um valor booleano. Exemplo: {"bot": true}. Para curl, o comando fica assim:
   curl -X PATCH -H "Authorization: Bearer SEU_TOKEN" -H "Content-Type: application/json" -d '{"bot": true}' https://suainstancia.social/api/v1/accounts/update_credentials
4. Verifique a resposta
   Uma resposta bem-sucedida retorna o status 200 OK com o objeto de credenciais da conta atualizado no corpo JSON. Procure pelo campo bot. Deve ser true. Se você receber um erro 422 Unprocessable Entity, o campo bot não foi aceito. Verifique se o token tem o escopo correto.
5. Confirme a alteração na página de perfil
   Abra o perfil da conta em um navegador web. Confirme se o selo de robô aparece. Se não aparecer, a chamada à API pode ter sido bem-sucedida, mas a instância armazenou em cache o perfil antigo. Aguarde alguns minutos e atualize.

Problemas Comuns ao Configurar o Marcador Bot

A caixa de seleção “Esta é uma conta bot” está ausente

A caixa de seleção aparece apenas na versão 3.0.0 ou superior do Mastodon. Se você usa uma instância mais antiga ou um fork que removeu a opção, pode não vê-la. Atualize sua instância do Mastodon para a versão estável mais recente. Alternativamente, use o método da API, que funciona em todas as versões que suportam o campo bot.

API retorna 403 Forbidden ao atualizar a flag bot

Este erro significa que seu token de acesso não possui o escopo write:accounts. Gere um novo token com o escopo correto. Se você usa o fluxo de credenciais do cliente, observe que ele não suporta escopos de nível de usuário. Use o fluxo de código de autorização e aprove o escopo write:accounts durante o diálogo OAuth.

O selo bot não aparece após configurar a flag

O selo pode não renderizar imediatamente devido ao cache na instância ou no seu navegador. Limpe o cache do navegador e recarregue o perfil. Se o selo ainda não aparecer, verifique se você salvou as configurações na interface web ou se a resposta da API incluiu "bot": true. Alguns forks do Mastodon ou temas personalizados ocultam o selo bot mesmo quando a flag está definida.

Conta Bot vs Conta Comum: Principais Diferenças

Item	Conta Bot	Conta Comum
Selo no perfil	Ícone de robô exibido ao lado do nome	Nenhum selo especial
Visibilidade padrão das postagens	Frequentemente definida como não listada pela API	Pública por padrão
Limites de taxa	Podem permitir maior frequência de postagem	Limites mais rigorosos para postagens automatizadas
Descoberta em filtros	Pode ser ocultada por usuários que silenciam bots	Não afetada por filtros de bot
Escopo da API necessário para configurar	write:accounts	Não aplicável

Agora você pode configurar o marcador bot em qualquer conta do Mastodon usando a interface web ou a API. Se você gerencia vários posters automáticos, escreva um script que chame o endpoint PATCH após a criação da conta. Isso garante que toda nova conta bot seja corretamente sinalizada desde o início. Lembre-se de que a flag bot é permanente até que você a altere novamente. Use o endpoint PATCH /api/v1/accounts/update_credentials com {"bot": false} para remover o marcador se depois converter a conta para um perfil operado por humano.