Como funcionam os bots no Bluesky
No Bluesky, um bot é uma conta normal gerida por um programa. Tem um DID, um handle e um PDS como qualquer outra conta, e publica escrevendo registos no seu repositório. O que faz dele um bot é quem o gere, e pode dizê-lo com o rótulo de automação.
Revisto pela última vez a 14 de novembro de 2026
No Bluesky não existe um tipo de conta especial para bots. Um bot é um programa que usa uma conta normal, e tudo o que faz passa pelo mesmo protocolo que a app do Bluesky.
Um bot é uma conta normal
Como qualquer conta, um bot tem um DID, o seu identificador permanente, um handle que as pessoas leem, e um PDS que aloja o seu repositório. Quando publica, dá um gosto ou segue alguém, acrescenta um registo a esse repositório, exatamente como a app faz por uma pessoa. Para o relay e a AppView, a publicação de um bot é um registo como outro qualquer.
O próprio tutorial de bots do protocolo começa da mesma forma: criar uma conta para o bot e, depois, uma palavra-passe da aplicação para ela.
Como um bot publica
Um bot fala com o seu próprio PDS, por HTTPS. Primeiro inicia sessão, de uma destas duas formas:
- com uma palavra-passe da aplicação, uma palavra-passe criada para uma só app, separada da palavra-passe principal da conta e revogável à parte. A documentação do protocolo diz que os programas de uso único, como os bots e as ferramentas de linha de comandos, podem iniciar sessão com uma palavra-passe, e uma palavra-passe da aplicação mantém a principal fora do seu código;
- com OAuth, o início de sessão padrão das apps atproto, em que a conta concede acesso sem partilhar nenhuma palavra-passe. As apps que iniciam a sessão de pessoas devem usá-lo.
Depois cria um registo, por exemplo uma publicação na sua coleção app.bsky.feed.post. O PDS assina a alteração com a chave da conta e acrescenta-a ao repositório, e a partir daí a publicação faz o mesmo percurso que qualquer outra: relay, AppView, leitores. A documentação para programadores mostra o código em TypeScript e em Python.
Para ir mais longe. Uma publicação é uma chamada a
com.atproto.repo.createRecordno PDS, com um corpo como o de baixo. O PDS escolhe a chave do registo, normalmente um TID tirado do relógio, e responde com o AT URI da publicação e o seu CID, o hash dessa versão exata.
{
"repo": "did:plc:ewvi7nxzyoun6zhxrhs64oiz",
"collection": "app.bsky.feed.post",
"record": {
"$type": "app.bsky.feed.post",
"text": "Hello from a bot!",
"createdAt": "2026-11-14T09:00:00.000Z"
}
}Como um bot escuta
Muitos bots só publicam, com um horário. Outros reagem: a uma menção, a uma resposta ou a um novo seguidor, ou a algo que acontece em qualquer ponto da rede. Há duas formas habituais de escutar:
- As notificações. O bot pede de tempos a tempos as suas próprias notificações, a mesma lista que uma pessoa vê na app, e responde às menções e respostas que encontra. O tutorial de bots do protocolo funciona assim.
- O firehose ou o Jetstream. Um bot que vigia toda a rede, por exemplo as publicações com uma palavra-chave, lê um fluxo. O firehose de um relay é binário: os seus eventos estão codificados em CBOR, e os registos que transportam estão em DAG-CBOR. O Jetstream envia as mesmas alterações em JSON simples através de um WebSocket, filtradas segundo o que o bot pede, que é o que a Bluesky recomenda à maioria dos programadores.
Os dois fluxos são públicos: lê-los não exige conta nem palavra-passe. Um bot só inicia sessão para escrever.
Para ir mais longe. As notificações vêm de
app.bsky.notification.listNotificationsna AppView, através do PDS do bot. O firehose écom.atproto.sync.subscribeReposnum relay. O Jetstream pode filtrar por coleção, comoapp.bsky.feed.post, e por conta.
O ciclo de um bot
No conjunto, a maioria dos bots segue o mesmo ciclo:
- Horário ou eventoUm temporizador, uma menção ou uma publicação vista no Jetstream.
- Código do botCorre em qualquer lado: um servidor, um portátil, uma tarefa agendada.
- O seu PDSGuarda a publicação no repositório do bot.
- A redeO relay e a AppView passam-na adiante.
- Os leitoresVeem-na nas suas timelines, feeds e notificações.
As respostas e as menções voltam ao bot como notificações, e o ciclo recomeça.
Cada passo é uma peça distinta. O código do bot pode correr em qualquer lado, num servidor, num portátil ou numa tarefa agendada, enquanto a sua conta e as suas publicações vivem no seu PDS.
Dizer que é um bot
O protocolo não marca os bots por si só: é a conta que diz que é automatizada. Há três formas habituais, e funcionam melhor em conjunto:
- O rótulo de automação. Na app do Bluesky, uma conta pode ativá-lo em Definições → Conta → Rótulo de automação. A app mostra então o rótulo ao lado do nome da conta, no seu perfil e nas suas publicações. Por baixo, é o autorrótulo
botdo registo de perfil da conta, que o tutorial de bots do protocolo recomenda como boa prática. - O perfil. Uma bio que diga que a conta é automatizada, o que publica e quem a gere.
- O handle. Um nome que diga «bot» antes de alguém abrir o perfil.
Como se encontra um bot
Um bot encontra-se como qualquer conta: na pesquisa, através de respostas e republicações, nos feeds personalizados e nas listas, e nos pacotes de iniciante, as listas de contas e feeds recomendados que as pessoas criam na app do Bluesky e partilham como uma ligação.
As regras
Os bots seguem as mesmas regras que toda a gente, mais limites que lhes importam mais. Esta página não as repete; leia-as na fonte:
- as Diretrizes da comunidade do Bluesky, que se aplicam nos serviços da Bluesky a todas as contas, automatizadas ou não, e os seus Termos de serviço;
- as Diretrizes para programadores da Bluesky, para as apps e os serviços que comunicam com os seus serviços, cuja definição de spam inclui as interações automatizadas ou em massa e os spambots;
- os limites de utilização dos PDS e dos serviços da Bluesky, que afetam sobretudo os bots muito ativos;
- as boas práticas para bots, uma lista de verificação que remete para as regras do Bluesky.
Como o Bluesky.bot usa isto
O Bluesky.bot é feito para bots. Dá a cada um um handle name.bluesky.bot, servido a partir do domínio do Bluesky.bot, por isso o bot mantém o seu DID, o seu PDS e o seu código; lista os bots num diretório público; e a sua revisão lembra os criadores de ativar o rótulo de automação. O seu labeler também acrescenta um rótulo bot às contas com um handle *.bluesky.bot ativo. O que é um bot do Bluesky?
Perguntas frequentes
- O Bluesky permite contas automatizadas?
- Sim. Uma conta automatizada pode publicar como qualquer outra, desde que siga as Diretrizes da comunidade e os Termos de serviço do Bluesky, respeite as Diretrizes para programadores da Bluesky, que consideram spam as interações automatizadas ou em massa e os spambots, e não ultrapasse os limites de utilização. Todos estão ligados em «As regras», nesta página.
- Os bots precisam de uma conta especial?
- Não. Um bot usa uma conta normal, geralmente uma sua e não a do seu criador. Inicia sessão com uma palavra-passe da aplicação ou com OAuth, por isso a palavra-passe principal da conta fica fora do seu código, e pode ativar o rótulo de automação para mostrar que é automatizado.