How-to guide

Cómo añadir una vista previa de enlace en Bluesky o Mastodon

Last updated: 2026-05-26 · Bluesky · By SocialKit Team

Las tarjetas de vista previa de enlace en Bluesky y Mastodon parecen sencillas, pero se rompen por razones distintas en cada plataforma. Esta guía explica por qué — registros embed del AT Protocol en Bluesky, carga OpenGraph en el servidor en Mastodon — y muestra cómo programar publicaciones con una tarjeta funcional en cada ocasión.

Antes de empezar

Necesitas una cuenta de Bluesky (cualquier handle) o una cuenta de Mastodon en cualquier instancia, o ambas. Para programar publicaciones con enlaces con antelación, también necesitas una cuenta de SocialKit — la prueba gratuita de 7 días (0,00 € hoy) cubre ambas plataformas.

Del lado del propietario de la página: la URL a la que enlazas debe tener etiquetas meta OpenGraph correctas (`og:title`, `og:description`, `og:image`) para que aparezca una tarjeta en cualquiera de las redes. Si eres propietario de la página destino, revisa primero esas etiquetas. Si enlazas a una URL de terceros, solo puedes influir en tu publicación — no en si su página tiene etiquetas OG — así que ajusta tus expectativas.

Step by step

  1. Entiende cómo Bluesky genera las tarjetas de enlace

    En Bluesky, una tarjeta de vista previa de enlace no es simplemente una URL renderizada — es un registro `app.bsky.embed.external` explícito adjunto a tu publicación en el momento de su creación. A junio de 2026, cuando pegas una URL en la app web de Bluesky o en un compositor de terceros compatible, el cliente obtiene las etiquetas OpenGraph de la página y empaqueta el título, la descripción y la miniatura en ese registro embed. El AT Protocol lo almacena junto al texto de la publicación. Si el registro embed está ausente, no aparece ninguna tarjeta — aunque la URL figure en el texto.

    Tip: Una URL desnuda escrita en el cuerpo de una publicación sin el registro embed aparecerá como texto plano en la mayoría de los clientes de Bluesky, no como tarjeta. Confirma siempre que la vista previa de la tarjeta se renderiza en el compositor antes de publicar.

  2. Comprueba que la URL destino tenga etiquetas OpenGraph

    Pega la URL en un navegador y ve al código fuente (Ctrl/Cmd + U), luego busca `og:title`, `og:description` y `og:image`. Las tres deben estar presentes. Si falta `og:image`, algunos clientes generan una tarjeta solo de texto; si las dimensiones de la imagen son demasiado pequeñas (Bluesky espera al menos 800 px de ancho a junio de 2026), la miniatura puede quedar en blanco o mal recortada. Para tus propias páginas, corrige las etiquetas en el CMS o el `<head>` y verifica con un validador gratuito de etiquetas OG antes de distribuir el enlace.

    Tip: Las imágenes de las tarjetas de Bluesky se muestran en proporción 1,91:1 (aproximadamente 1200 × 628 px), igual que la especificación estándar de imagen OG. Un `og:image` cuadrado aparecerá con letterbox en lugar de recortado en la mayoría de los clientes — usa una imagen de 1200 × 628 px para el mejor resultado.

  3. Redacta tu publicación de Bluesky en SocialKit y confirma la vista previa

    Abre el compositor de SocialKit y selecciona tu cuenta de Bluesky conectada como destino. Pega tu URL en el cuerpo de la publicación. A junio de 2026, SocialKit obtiene los datos OpenGraph de la página y muestra una vista previa en vivo de la tarjeta en el compositor para que puedas confirmar el título, la descripción y la miniatura antes de programar. Si la tarjeta aparece en blanco o muestra texto de marcador, el problema probablemente son las etiquetas OG de la página destino — corrígelas primero (ver Paso 2) y luego actualiza el compositor.

    Tip: Si enlazas a una página que ha cambiado recientemente sus etiquetas OG, algunas cachés de CDN o de vista previa pueden tardar minutos o incluso horas en actualizarse. Añadir un parámetro de cache-busting (p. ej. `?v=2`) fuerza una carga nueva en la mayoría de los compositores, pero cambia la URL canónica — úsalo solo en páginas que poseas y donde el cambio de URL sea aceptable.

  4. Entiende cómo Mastodon genera las tarjetas de enlace

    Las tarjetas de enlace de Mastodon funcionan de forma diferente a Bluesky. Cuando tu instancia principal recibe una publicación con una URL, su servidor la carga de forma asíncrona y analiza las etiquetas OpenGraph — normalmente en unos pocos segundos, a veces hasta un minuto en instancias con mucho tráfico o límites de velocidad. La tarjeta aparece cuando esa carga del lado del servidor se completa. A junio de 2026 esto significa: (a) la tarjeta puede no aparecer de inmediato aunque las etiquetas OG sean correctas; (b) si la URL destino está detrás de un CAPTCHA que bloquea bots o de un desafío Cloudflare, la instancia puede no poder cargarla y la tarjeta nunca aparecerá; (c) el comportamiento de las tarjetas puede variar entre versiones de Mastodon (la línea estable actual es la 4.x).

    Tip: Mastodon no almacena la tarjeta en el registro de la publicación como hace Bluesky — se genera bajo demanda desde la URL cada vez que un cliente carga la publicación. Esto significa que corregir una etiqueta OG rota en la página destino acabará reparando la tarjeta en todas las publicaciones pasadas de Mastodon que enlacen a ella, una vez que la instancia actualice su caché.

  5. Redacta tu publicación de Mastodon en SocialKit y prográmala

    En el compositor de SocialKit, selecciona tu cuenta de Mastodon conectada junto a Bluesky (o en su lugar). Escribe el texto de tu publicación y pega la URL. Usa la personalización por plataforma para adaptar el pie de foto si publicas en ambas redes a la vez — el límite de caracteres por defecto de Mastodon es 500 (algunas instancias lo aumentan; comprueba el límite de tu instancia en la configuración de tu cuenta), mientras que el de Bluesky es 300 grafemas a junio de 2026. Establece una hora concreta o usa los datos de mejor momento, luego programa. SocialKit publica automáticamente en Mastodon a la hora programada; no se requiere interacción con el teléfono.

    Tip: El campo de Advertencia de Contenido (CW) de Mastodon es un cuadro de texto separado que oculta el contenido de la publicación tras un clic. Se usa habitualmente para spoilers, temas sensibles o hilos largos — no para publicaciones de enlace estándar. Déjalo en blanco a menos que las normas de tu comunidad lo requieran.

  6. Añade parámetros UTM para rastrear los clics de cada red por separado

    Si el enlace de tu publicación apunta a una página que posees, añade parámetros UTM para que Google Analytics 4 (o cualquier plataforma de análisis) separe los clics de Bluesky de los de Mastodon. Un conjunto mínimo tiene este aspecto: `?utm_source=bluesky&utm_medium=social&utm_campaign=tu-campaña`. Usa el generador UTM gratuito de SocialKit para crearlos sin errores tipográficos, luego pega la URL etiquetada en el compositor antes de que se cargue la tarjeta de vista previa. La tarjeta mostrará los metadatos de la página destino aunque la URL incluya parámetros.

    Tip: Tanto Bluesky como Mastodon pasan las URLs sin modificar — ninguno elimina los parámetros UTM como hacen algunas plataformas. La miniatura y el título de la tarjeta provienen de las etiquetas OG de la página destino independientemente de la cadena de consulta, por lo que las URLs con etiquetas UTM generan vistas previas de tarjeta correctas.

  7. Comparte la misma publicación con enlace en X, Threads u otras plataformas

    Aún en la misma sesión del compositor de SocialKit, añade X (Twitter), Threads o cualquiera de las otras nueve plataformas compatibles como destinos adicionales. Cada una tiene su propio campo de pie de foto — mantén Bluesky por debajo de 300 grafemas, Mastodon por debajo del límite de tu instancia, X (Twitter) por debajo de 280 caracteres (cuentas estándar, a junio de 2026; los planes premium difieren) y Threads por debajo de 500 caracteres. El comportamiento de las tarjetas de enlace varía por plataforma: X renderiza una tarjeta de vista previa y no cuenta la URL en el límite; Threads y Bluesky muestran tarjetas integradas; Mastodon carga una de forma asíncrona. Programa todos los destinos de una sola sesión.

Best practices

  • Incluye siempre las tres etiquetas OpenGraph principales — `og:title`, `og:description` y `og:image` — en cualquier página que planees enlazar. Que falte cualquiera de ellas degrada o elimina la tarjeta en Bluesky y Mastodon.
  • Usa una imagen de 1200 × 628 px para `og:image`. Esta proporción 1,91:1 es el estándar en Bluesky, Mastodon y la mayoría de las otras redes, y evita el letterboxing o recorte según el cliente.
  • En Bluesky, confirma que la tarjeta se renderiza en el compositor de SocialKit antes de programar — una vez publicado un post en el AT Protocol, el registro embed queda fijado y no puede editarse sin eliminar y volver a publicar.
  • En Mastodon, espera hasta 60 segundos tras la publicación de un post antes de asumir que la tarjeta está rota — especialmente en instancias más pequeñas o con mucho tráfico a junio de 2026.
  • Usa URLs con etiquetas UTM para cada publicación con enlace y mantén una convención de nomenclatura coherente (`utm_source=bluesky`, `utm_source=mastodon`) para que tus análisis separen limpiamente el tráfico de protocolo abierto de otros canales.
  • Programa las publicaciones con enlaces durante las horas activas de tu audiencia usando los datos de mejor momento de SocialKit — una tarjeta correcta que llega cuando nadie está en línea sigue teniendo un rendimiento inferior. Consulta /best-time-to-post/bluesky y /best-time-to-post/mastodon para ventanas de partida actuales.

Good to know

Por qué «pegué la URL pero no hay tarjeta» — las dos causas más comunes

En Bluesky: la causa más común es que el compositor no generó un registro embed, ya sea porque la carga OG falló (bloqueo de bots, servidor lento, etiquetas faltantes) o porque pegaste la URL después de escribir otro texto y el cliente no volvió a activar una carga. Para solucionarlo, limpia la publicación, pega primero la URL, espera a que aparezca la vista previa de la tarjeta y luego añade el texto del pie de foto a su alrededor. Si la tarjeta sigue sin aparecer, las etiquetas OG de la página destino faltan o devuelven errores.

En Mastodon: la causa más común es que tu instancia aún no ha terminado la carga asíncrona, o el servidor destino bloqueó la solicitud de la instancia (Cloudflare, CAPTCHA o bloqueo a nivel IP). No hay solución alternativa para una URL destino bloqueada que no sea usar una redirección o un destino diferente. Esperar 30–60 segundos y actualizar la publicación suele resolver una situación de carga lenta a junio de 2026.

Edición de publicaciones en Bluesky y el registro embed

A junio de 2026, Bluesky no admite la edición de registros de publicación tras su publicación — es una decisión de diseño deliberada del AT Protocol sobre la inmutabilidad de las publicaciones y la integridad de la federación. Si una publicación sale con una tarjeta rota o faltante, tu única opción es eliminarla y volver a publicar con el embed corregido. Esto hace que confirmar la tarjeta en la vista previa de SocialKit antes de programar sea más importante en Bluesky que en cualquier otra plataforma.

Mastodon sí admite la edición de publicaciones en instancias con la versión 3.5.0 o posterior; las publicaciones editadas muestran un distintivo de historial de edición en los clientes que lo soportan. Sin embargo, si editar una publicación de Mastodon actualiza la caché de la tarjeta de enlace depende de la instancia a junio de 2026.

Do it in SocialKit

El compositor de SocialKit obtiene datos OpenGraph y muestra una vista previa en vivo de la tarjeta antes de que programes — para que detectes las vistas previas rotas antes de que se publiquen. Programa en Bluesky, Mastodon y otras nueve plataformas desde un solo calendario. Publicaciones programadas ilimitadas en todos los planes, prueba gratuita de 7 días, 0,00 € hoy.

Programa publicaciones con enlaces en Bluesky y Mastodon con SocialKit
All 11 platforms included

Try it free

Schedule and cross-post to all 11 networks from one calendar on one flat plan. 7-day free trial — €0.00 due today.

Empezar mi prueba gratis

0,00 € hoy · cancela cuando quieras · garantía de reembolso de 7 días

FAQ

Frequently asked questions

The questions people ask before they schedule — answered honestly, hedged where platform behavior changes.

Empezar mi prueba gratis

0,00 € hoy · cancela cuando quieras · garantía de reembolso de 7 días