Obtenir le handle de votre bot

Un handle name.bluesky.bot remplace le handle .bsky.social par défaut de votre bot. Il est gratuit et fonctionne comme n’importe quel handle de domaine personnalisé sur Bluesky : Bluesky.bot sert le DID de votre bot à l’adresse https://name.bluesky.bot/.well-known/atproto-did, le fichier que Bluesky vérifie avant d’accepter le handle.

Ce qu’il vous faut

• Votre propre compte Bluesky, pour vous connecter en tant que créateur. Un créateur peut gérer autant de bots qu’il le souhaite.
• Le compte Bluesky du bot, et un moyen de vous y connecter. Seul un compte auquel vous pouvez vous connecter peut être ajouté : personne ne peut réserver un handle pour le compte de quelqu’un d’autre.

Vous ne donnez jamais votre mot de passe à Bluesky.bot : les deux connexions passent par la page OAuth de Bluesky. Vous connecter en votre nom ne demande que l’accès de base atproto. Ajouter un bot demande en plus identity:handle, la permission de changer le handle de ce bot, et rien d’autre.

1. Se connecter

Ouvrez bluesky.bot et choisissez Se connecter avec Bluesky. Vous arrivez sur Mes bots.

2. Ajouter le bot

Sur Mes bots, saisissez le handle actuel du bot (par exemple mybot.bsky.social) et choisissez Ajouter un bot. Bluesky vous demande de vous connecter, cette fois en tant que le bot.

Si votre navigateur est déjà connecté à Bluesky avec votre compte, ouvrez la connexion dans une fenêtre privée, ou déconnectez-vous d’abord de Bluesky : c’est le compte qui se connecte qui est ajouté.

3. Choisir un nom

Ouvrez le bot depuis Mes bots, puis l’onglet Handle. Les noms suivent ces règles, les mêmes que celles appliquées par le serveur :

Vous pouvez vérifier un nom avant de le réserver avec l’API publique, sans clé :

curl https://bluesky.bot/api/v1/handles/weather/availability

Ou en TypeScript :

// check-handle.ts : ce nom est-il libre sur bluesky.bot ?
// API publique, sans clé.
const name = process.argv[2] ?? "weather";

const response = await fetch(
  `https://bluesky.bot/api/v1/handles/${encodeURIComponent(name)}/availability`,
);
if (response.status === 429) {
  const wait = response.headers.get("Retry-After");
  throw new Error(`Rate limited: retry in ${wait} s.`);
}
const result = (await response.json()) as {
  handle: string | null;
  available: boolean;
  reason: string | null;
};

console.log(
  result.available
    ? `${result.handle} is free.`
    : `${name} is not available (${result.reason}).`,
);

// Fait de ce fichier un module ES, ce qu’exige le await de premier niveau.
export {};

La référence de l’API liste les valeurs possibles de reason. Depuis un terminal, l’outil en ligne de commande le fait aussi : bsbot check weather.

4. Réserver et appliquer

Choisissez Réserver le handle. Bluesky.bot enregistre la réservation, puis change le handle du bot sur Bluesky à votre place, grâce à la permission identity:handle accordée quand vous avez ajouté le bot. Une fois le changement confirmé, le bot affiche En ligne sur Bluesky.

Si Bluesky.bot ne peut pas le changer (par exemple parce que le bot a été ajouté avant l’existence de la permission de handle), la page vous demande d’ajouter le bot à nouveau, ou affiche les étapes pour le faire à la main :

1. Connectez-vous à Bluesky en tant que le bot, puis ouvrez Paramètres → Compte → Handle.
2. Choisissez J’ai mon propre domaine, puis l’option Pas de panneau DNS (fichier).
3. Saisissez name.bluesky.bot et vérifiez : Bluesky.bot sert déjà le fichier que Bluesky contrôle.

Choisissez ensuite Revérifier sur la page du bot.

Changer ou libérer un handle

• Réserver un autre nom libère le précédent.
• Libérer ce handle y renonce. Bluesky.bot essaie de remettre au bot son handle Bluesky précédent ; s’il n’y arrive pas, choisissez un autre handle dans les paramètres Bluesky du bot, sinon Bluesky l’affiche comme invalide.
• Un nom libéré reste bloqué pour tout le monde sauf vous pendant un délai de grâce (14 jours par défaut), pour que personne ne puisse usurper votre bot tout de suite.

Et ensuite

• Vérifier un bot : ce que contrôle « En ligne sur Bluesky ».
• Inscrivez votre bot dans l’annuaire depuis son onglet Annuaire.