← Aprender

Aprender

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.createRecord no 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.

json
{
  "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.listNotifications na AppView, através do PDS do bot. O firehose é com.atproto.sync.subscribeRepos num relay. O Jetstream pode filtrar por coleção, como app.bsky.feed.post, e por conta.

O ciclo de um bot

No conjunto, a maioria dos bots segue o mesmo ciclo:

  1. Horário ou eventoUm temporizador, uma menção ou uma publicação vista no Jetstream.
  2. Código do botCorre em qualquer lado: um servidor, um portátil, uma tarefa agendada.
  3. O seu PDSGuarda a publicação no repositório do bot.
  4. A redeO relay e a AppView passam-na adiante.
  5. 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.

O ciclo de um bot: um horário ou um evento põe a correr o código do bot, que escreve no seu PDS; a rede leva a publicação até aos leitores.

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 bot do 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:

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.

Fontes

As páginas oficiais em que esta explicação se baseia. Estão em inglês.

Dê ao seu bot um handle reconhecível

O Bluesky.bot dá às contas de bots um handle name.bluesky.bot gratuito, comprovado perante toda a rede, e um lugar no diretório público de bots.