Minilección · Español

Cómo corregir la vista previa de tu sitio al compartir un enlace

Da título, descripción e imagen al asistente y comprueba la tarjeta que produce un enlace público real.

Comenzar la lección interactivaLeer los apuntes

¿Para quién es esta lección?

Para propietarios con vistas compartidas ausentes o engañosas. El asistente añade metadatos; tú examinas la tarjeta real.

Antes de empezar

Tu página HTTPS pública y la imagen proporcionada. El asistente puede editar/publicar archivos. Las plataformas no acceden a localhost privado y sus vistas en caché pueden requerir actualizarse.

Tiempo estimado: 15–27 min

Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. Las plataformas guardan resultados en caché y deciden qué mostrar. Una comprobación local de metadatos no demuestra una vista previa real en LinkedIn, Slack ni WhatsApp.

Qué aprenderás

  • Conecta título, descripción e imagen previstos.
  • Comprueba que la imagen sea accesible públicamente.
  • Examina la vista real de la plataforma y sus límites.

Archivos del taller

Paso 1

Elige la tarjeta a compartir

La vista se genera desde una página accesible públicamente.

Abre la página proporcionada. Se titula «Practical notes for building a website» e incluye share-card.jpg. Decide si título, descripción e imagen representan lo que abrirá el visitante.

Da al asistente tu URL HTTPS pública para conectar los valores de compartir. https://YOUR-SITE.example/ es un origen reservado de plantilla; una plataforma no puede obtener imágenes que solo viven en tu ordenador.

Un ejemplo concreto

La descripción es «Small examples, working files and clear checks for your next website feature.» Junto al título promete notas prácticas web, no una portada sin relación.

Usa página e imagen proporcionadas. Añade título y descripción específicos del artículo y URL absoluta pública de imagen conservando coherencia visible. Ayuda a comprobar página/imagen sin sesión y después una vista real compartida. Gestiona metadatos. No afirmes actualizar una plataforma solo por una imagen local o solicitud de renovar caché.

Open Graph: metadatos básicos

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Haz que un enlace compartido explique su destino

Una vista previa necesita metadatos de página y una imagen que la plataforma pueda obtener realmente.

Normalmente una plataforma compone la vista previa al obtener tu URL y leer sus metadatos. No es simplemente una captura de lo que ve tu navegador con sesión iniciada.

Esta lección proporciona una sección head del HTML completa y una nueva imagen para compartir. Sustituirás el origen reservado del ejemplo, publicarás tu propia página de práctica y examinarás qué recibe una solicitud sin autenticar.

Ejemplo resuelto

Un título útil explica lo que ofrece la página. “My site” (mi sitio) aporta mucho menos contexto que “Practical notes for building a website” (notas prácticas para crear un sitio), seguido de una descripción breve.

Open Graph: metadatos básicos

Extra implementation exercise

¿Por qué puede funcionar una miniatura en tu portátil y fallar en Slack?

Mostrar una solución desarrollada

La plataforma no puede acceder a localhost ni a tu sesión autenticada. También necesita una URL de imagen accesible y metadatos HTML correctos en la dirección exacta compartida.

  • Reconoce que la plataforma necesita acceso público por red.
  • Comprueba por separado la URL compartida y la imagen.

Paso 2

Comprueba la imagen publicada

Examina la ruta real que referencia la tarjeta.

Publica cuando esté listo y abre la URL real de imagen sin sesión. Pide confirmar que es la prevista, no un archivo ausente ni una página de acceso.

Cambiar la imagen visible no necesariamente cambia el valor aparte para compartir. Verifica la referencia entregada.

Un ejemplo concreto

Si la imagen abre la portada HTML en vez de share-card.jpg, el servidor aún puede devolver 200. La URL funciona como página, pero no proporciona una imagen.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Pon la vista previa en el HTML inicial

Utiliza URL absolutas de imagen y canónica que funcionen al obtenerlas externamente.

Examina la sección head del HTML proporcionado. og:title, og:description, og:type, og:url y og:image describen esta página exacta. La ruta de la imagen es absoluta porque un rastreador remoto necesita un destino inequívoco.

Sustituye YOUR-SITE.example en todas partes. La imagen es un archivo real incluido en el taller. No dependas de JavaScript del navegador para insertar metadatos esenciales tras la carga; los rastreadores se comportan de formas distintas.

La tarjeta horizontal mide 1672 × 941 píxeles. Las plataformas pueden recortarla o cambiar su tamaño de forma distinta; mantén los detalles importantes lejos de los bordes y examina el resultado real. Es un recurso inicial, no una promesa de recorte idéntico en todas las plataformas. Confirma que share-card.jpg está en la carpeta pública desplegada.

Antes de probar plataformas, abre sin sesión tu URL og:image desplegada exacta y verifica una respuesta image/jpeg correcta con la imagen real visible. Un archivo ausente, el origen reservado de ejemplo o una respuesta HTML de sustitución no superan esta prueba.

Ejemplo resuelto

Una imagen relativa correcta en el cuerpo no repara un og:image absoluto roto. Examina ambos destinos en vez de suponer que son el mismo.

<meta property="og:image"
  content="https://YOUR-SITE.example/share-card.jpg">
<meta property="og:type" content="website">

Extra implementation exercise

Cambiaste la imagen visible, pero dejaste og:image apuntando a un archivo ausente. ¿Qué imagen intentará obtener un rastreador?

Mostrar una solución desarrollada

Normalmente intentará la imagen de los metadatos, que sigue rota. Corrige la URL og:image y verifica su respuesta real.

  • Lee el destino de los metadatos.
  • No deduce los datos de vista previa del cuerpo representado.

Paso 3

Examina una vista real de plataforma

Considera acceso remoto y caché.

Después de publicar, revisa página e imagen sin sesión. Usa una herramienta como LinkedIn Post Inspector si existe, o comparte el enlace en privado y revisa su tarjeta. Compara título, descripción y recorte reales.

Anota la plataforma y lo que mostró. Si los archivos públicos están actualizados pero la plataforma sigue mostrando una tarjeta antigua, investiga su caché. Solicitar una actualización es un paso del proceso, no el resultado visible de la tarjeta.

Un ejemplo concreto

Ejemplo: La página ofrece nuevo título y JPEG, pero la plataforma aún muestra un título antiguo. Indica caché propia de esa plataforma, no que todas se actualizaran.

LinkedIn Post Inspector · Meta Sharing Debugger

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Comprueba la respuesta antes de culpar a la caché

Verifica el HTML original, las redirecciones y el acceso a la imagen; prueba después la plataforma.

Abre la URL compartida exacta sin sesión y examina el código fuente original. Sigue las redirecciones y comprueba el estado final. Obtén la imagen por separado: debe devolver bytes de imagen con un tipo de contenido adecuado, no HTML de sustitución.

Cuando la salida del servidor sea correcta, utiliza la herramienta de inspección de la plataforma si existe e intenta compartir de nuevo. Los mensajes existentes pueden conservar vistas previas en caché. Actualizar la caché de tu navegador no borra la de una plataforma social.

Por ejemplo, abre LinkedIn Post Inspector con tu cuenta e introduce la URL pública exacta. Meta Sharing Debugger es otra herramienta específica y puede exigir acceso. En las herramientas del navegador, selecciona la solicitud de imagen en Network y examina Headers → Content-Type y la vista previa de respuesta. Las herramientas pueden seguir no disponibles o mostrar caché.

La página y la imagen de destino deben ser accesibles para visitantes o rastreadores sin tu sesión de propietario. La herramienta de diagnóstico es distinta: LinkedIn o Meta pueden exigirte sesión para usarla. Iniciar sesión en la herramienta no hace rastreable un destino privado. Si no tienes acceso, registra la limitación y distingue las respuestas originales de una vista previa de plataforma que no observaste.

Para WhatsApp o Slack puedes compartir la URL pública de práctica en una conversación de prueba que controles y registrar la vista previa o su ausencia. No afirmes que una plataforma pasó si solo examinaste respuestas HTTP; si falta cuenta o herramienta, registra ese límite.

Ejemplo resuelto

Una solicitud de imagen que devuelve 200 text/html puede ser en realidad una respuesta de sustitución de una aplicación de página única. El estado 200 no demuestra por sí solo que se sirvió una imagen.

LinkedIn Post Inspector · Meta Sharing Debugger

Extra implementation exercise

La solicitud og:image devuelve 200 con una página de acceso. ¿Se superó la comprobación de imagen?

Mostrar una solución desarrollada

No. El rastreador recibió HTML en vez de la imagen. Corrige rutas y acceso para que la URL devuelva el archivo real sin iniciar sesión.

  • Comprueba tipo de contenido y cuerpo, además del estado.
  • Exige acceso sin autenticación a bytes de imagen reales.

Paso 4

Termina una tarjeta específica del artículo

Mantén identidad compartida y página real alineadas.

Pide al asistente que añada el artículo de referencia proporcionado, «Fix a mismatched contact link», con título, descripción y URL de compartir propios. Puede reutilizar share-card.jpg, pero su identidad debe describir ese artículo concreto, no la portada general.

Publica el artículo en tu práctica, abre su página e imagen exactas y vuelve a revisar la tarjeta. Mantén en el registro las plataformas no disponibles.

Un ejemplo concreto

El título debe ser «Fix a mismatched contact link». La descripción explica comparar href e id, arreglar el ancla y comprobarla. El título general de portada ocultaría lo que enseña este enlace.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tu tarea: obtener la vista previa de un artículo concreto

Da a un enlace profundo su propio título, descripción e imagen exactos.

Crea una página de artículo con sus metadatos y un mensaje descriptivo para compartir. Mantén canonical/og:url en ese artículo, no en la página principal.

Publica solo en tu sitio de práctica, prueba las respuestas sin autenticación y registra la vista previa real de una plataforma cuando esté disponible. Si la plataforma rechaza o conserva un resultado antiguo, documenta esa observación en vez de declarar éxito solo por el HTML.

Ejemplo resuelto

Dos artículos distintos que siempre muestran la página principal al compartirlos se pueden compartir técnicamente, pero no ayudan a entender el enlace concreto.

Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.

Extra implementation exercise

Entrega una vista previa específica del artículo y un registro de pruebas de respuesta y plataforma.

Mostrar una solución desarrollada

Sustituye el origen reservado en canonical, og:url y og:image. Publica el JPEG junto al HTML. Abre ambas URL exactas sin sesión y examina la respuesta en Network: la página debe ser HTML y la imagen bytes reales image/jpeg, no HTML de sustitución.

Para un artículo concreto, dale su propio título, descripción y URL canónica/OG en lugar de reutilizar la identidad de la página de inicio. El artículo completo de referencia muestra esa sección head independiente del HTML.

Utiliza LinkedIn Post Inspector o Meta Sharing Debugger cuando tu cuenta tenga acceso y registra el resultado real y la hora de prueba. Una vista antigua en caché es una observación distinta de una salida actual incorrecta del servidor. Examinar fuentes locales no demuestra por sí solo una vista previa real de WhatsApp.

  • Los metadatos describen el artículo exacto compartido.
  • Se verifican el HTML original y el acceso a imagen; el resultado de plataforma se registra con honestidad.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.

Sigue aprendiendo

Explora las otras lecciones