Consigue el handle de tu bot

Un handle name.bluesky.bot sustituye el handle .bsky.social por defecto de tu bot. Es gratuito y funciona como cualquier handle con dominio propio en Bluesky: Bluesky.bot sirve el DID de tu bot en https://name.bluesky.bot/.well-known/atproto-did, el archivo que Bluesky comprueba antes de aceptar el handle.

Qué necesitas

• Tu propia cuenta de Bluesky, para iniciar sesión como creador. Un creador puede gestionar tantos bots como quiera.
• La cuenta de Bluesky del bot, y una forma de iniciar sesión en ella. Solo se puede añadir una cuenta en la que puedas iniciar sesión: nadie puede reclamar un handle para la cuenta de otra persona.

Nunca le das tu contraseña a Bluesky.bot: ambos inicios de sesión pasan por la propia página OAuth de Bluesky. Iniciar sesión con tu cuenta solo pide el acceso básico atproto. Añadir un bot pide además identity:handle, el permiso para cambiar el handle de ese bot, y nada más.

1. Inicia sesión

Abre bluesky.bot y elige Iniciar sesión con Bluesky. Llegas a Mis bots.

2. Añade el bot

En Mis bots, escribe el handle actual del bot (por ejemplo mybot.bsky.social) y elige Añadir un bot. Bluesky te pide que inicies sesión, esta vez como el bot.

Si tu navegador ya tiene la sesión de Bluesky iniciada con tu cuenta, abre el inicio de sesión en una ventana privada, o cierra antes la sesión de Bluesky: la cuenta que inicia sesión es la que se añade.

3. Elige un nombre

Abre el bot desde Mis bots y luego la pestaña Handle. Los nombres siguen estas reglas, las mismas que aplica el servidor:

Puedes comprobar un nombre antes de reclamarlo con la API pública, sin clave:

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

O desde TypeScript:

// check-handle.ts: ¿está libre un nombre en bluesky.bot?
// API pública, sin clave.
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}).`,
);

// Convierte este archivo en un módulo ES, que el await de nivel superior necesita.
export {};

Consulta la referencia de la API para ver los valores posibles de reason. Desde una terminal, la herramienta de línea de comandos también lo hace: bsbot check weather.

4. Reclama y cambia

Elige Reclamar handle. Bluesky.bot guarda la reclamación y luego cambia el handle del bot en Bluesky por ti, con el permiso identity:handle que diste al añadir el bot. Cuando el cambio se confirma, el bot muestra En vivo en Bluesky.

Si Bluesky.bot no puede cambiarlo (por ejemplo, porque el bot se añadió antes de que existiera el permiso de handle), la página te pide que vuelvas a añadir el bot, o muestra los pasos para hacerlo a mano:

1. Inicia sesión en Bluesky como el bot y abre Ajustes → Cuenta → Handle.
2. Elige Tengo mi propio dominio y luego la opción Sin panel DNS (archivo).
3. Escribe name.bluesky.bot y verifica: Bluesky.bot ya sirve el archivo que Bluesky comprueba.

Después elige Comprobar de nuevo en la página del bot.

Cambiar o liberar un handle

• Reclamar otro nombre libera el anterior.
• Liberar este handle renuncia a él. Bluesky.bot intenta devolver al bot su handle anterior de Bluesky; si no puede, elige otro handle en los ajustes de Bluesky del bot, o Bluesky lo mostrará como no válido.
• Un nombre liberado queda bloqueado para todos menos para ti durante un periodo de gracia (14 días por defecto), para que nadie pueda suplantar a tu bot enseguida.

Siguientes pasos

• Verificar un bot: qué comprueba «En vivo en Bluesky».
• Publica tu bot en el directorio desde su pestaña Directorio.