// Integración social · 3 pasos · ~2 min

Configuración de Bluesky

La más sencilla de todas las configuraciones sociales. Bluesky está construido sobre protocolos abiertos: nada de programa para desarrolladores, nada de revisión de aplicaciones, nada de baile de OAuth. En dos minutos lo tienes listo.

// Con qué terminarás
  • social_bluesky_handle, tu handle como artdrop.bsky.social o un dominio personalizado
  • social_bluesky_password, una contraseña de aplicación de 19 caracteres con el formato xxxx-xxxx-xxxx-xxxx
// Una cosa importante

Bluesky solo muestra la contraseña de aplicación una vez. Cópiala de inmediato en cuanto aparezca. Si cierras el cuadro de diálogo sin guardarla, no podrás recuperarla y tendrás que revocarla y crear una nueva. La misma regla que con cualquier clave de API.

  1. 1
    Bluesky

    Conoce tu handle

    Tu handle es lo que escribes al iniciar sesión. Incluye el dominio completo, sin el prefijo @.

    • Formato por defecto: tunombre.bsky.social
    • Dominio personalizado (si configuraste uno): mike.stanhattie.com

    Comprueba el tuyo abriendo tu perfil de Bluesky; el handle aparece debajo de tu nombre para mostrar. Copia el texto completo, incluido el dominio.

    No incluyas el símbolo @. ArtDrop rechaza @artdrop.bsky.social y acepta artdrop.bsky.social.

  2. 2
    Contraseña de aplicación

    Crea una contraseña de aplicación en bsky.app

    Funciona igual en la web y en el móvil:

    1. Abre bsky.app e inicia sesión.
    2. Menú de hamburguesa (arriba a la izquierda en la web, toca el avatar en el móvil) y luego Settings.
    3. Abre Privacy and Security.
    4. Toca App Passwords.
    5. Haz clic en Add App Password.
    6. Ponle un nombre que reconozcas más adelante. Sugerido: ArtDrop.
    7. Haz clic en Create App Password.
    8. Copia la contraseña de inmediato. Se muestra una sola vez en un cuadro de diálogo como abcd-efgh-ijkl-mnop, 19 caracteres con guiones.

    Los guiones son parte de la contraseña, no los quites. Trátala como una clave de API: no la subas a git, no la publiques en Slack.

  3. 3
    Pega y guarda

    Introduce ambos valores en ArtDrop

    De vuelta en la página Social de ArtDrop, en la sección de Bluesky:

    • Handle: tu handle del Paso 1 (sin @, incluye el dominio completo).
    • Contraseña de aplicación: la cadena xxxx-xxxx-xxxx-xxxx del Paso 2.

    Pulsa Guardar. ArtDrop crea una sesión con com.atproto.server.createSession al instante, así que un inicio de sesión fallido aparece de inmediato.

// Qué pueden (y qué no pueden) hacer las contraseñas de aplicación

Las contraseñas de aplicación de Bluesky están limitadas a propósito. Con esta contraseña, ArtDrop puede:

  • Publicar, responder, dar me gusta, repostear, seguir y leer en tu nombre.

ArtDrop no puede:

  • Cambiar tu correo ni tu contraseña principal.
  • Eliminar tu cuenta ni migrarla.
  • Crear más contraseñas de aplicación.

Si la contraseña se filtra alguna vez, revócala desde la misma pantalla de App Passwords y crea una nueva. La revocación es instantánea, sin periodo de espera.

// Problemas comunes
  • Formato del handle: sin @, debe incluir el dominio completo. user.bsky.social funciona, @user.bsky.social no, y user tampoco.
  • Los guiones de la contraseña son parte de ella. Algunos creen que son separadores, pero no lo son. Copia la cadena completa de 19 caracteres.
  • "Invalid identifier or password": o el handle o la contraseña de aplicación están mal. Revisa ambos con cuidado; si tienes dudas, revoca la contraseña de aplicación y crea una nueva, porque no puedes recuperar una existente.
  • Handles con dominio personalizado: si configuraste un dominio personalizado (tu.example.com), ese es tu handle, no el antiguo tu.bsky.social. Técnicamente ambos siguen funcionando, pero usa el canónico.
  • Los límites de frecuencia se aplican a la cuenta, no a la contraseña de aplicación. Revocarla y volver a crearla no los reinicia.
  • Usuarios con PDS autoalojado: si estás en un PDS personalizado (no bsky.social), ArtDrop lo detectará automáticamente mediante la resolución del DID, sin configuración adicional. Menciónalo en un ticket de soporte si algo no se resuelve.
// ¿Atascado?

La configuración de Bluesky casi nunca da problemas. Si ArtDrop rechaza una contraseña que acabas de crear, pégala manualmente en la página de inicio de sesión de bsky.app para confirmar que funciona. Si eso también falla, revócala y vuelve a intentarlo. En cualquier otro caso, escribe a support@getartdrop.com.

Referencia oficial: documentación de Bluesky, AT Protocol.