Instrucciones paso a paso para colocar un flipbook interactivo dentro de una página de Confluence con el macro Iframe: permitir el dominio, dimensionar el marco, tratar las diferencias entre Cloud y Data Center y solucionar los marcos en blanco, con tablas comparativas y ejemplos reales de equipos.
Tu equipo subió el manual del empleado a Confluence como PDF y nadie lo abre. El adjunto queda al final de la página, se descarga en lugar de mostrarse y la versión que la gente lee siempre es la de hace tres trimestres. Hay una mejor forma: convierte el PDF en un flipbook con efecto de paso de página con Flipbooks AI y muéstralo dentro de la página con el macro Iframe de Confluence. Los lectores pasan las páginas sin salir del wiki, y actualizas el archivo original una sola vez.
Este artículo recorre toda la configuración, desde permitir el dominio hasta dimensionar el marco, además de los errores que producen un recuadro en blanco en lugar de un flipbook.
Los wikis son buenos con el texto y malos con documentos largos y diseñados. Los libros de marca, los catálogos de productos, los paquetes de incorporación y los informes trimestrales se crean en herramientas de diseño y se exportan como PDF. Pegarlos como adjuntos crea tres problemas:
Un flipbook resuelve los tres. Se muestra en el navegador, se abre en la página correcta, se adapta a los teléfonos y vive en una sola URL. Cuando reemplazas el archivo original, cada página que lo incrusta muestra la nueva versión.
💡 Consejo profesional: Si tu wiki es la única fuente de información de un equipo, incrusta el flipbook en la página donde la gente ya busca, no en una página aparte de "Documentos" que nadie visita.
Un iframe es una ventana a otra página web. El macro Iframe de Confluence toma una URL y muestra esa página dentro de un rectángulo en tu página del wiki. En el caso de un flipbook, la URL es el enlace público o protegido con contraseña que genera tu plataforma de flipbooks.
| Caso de uso | Espacio típico del wiki | Por qué ayuda un flipbook |
|---|---|---|
| Manual del empleado | RR. HH. | Un documento con paso de página, siempre actualizado |
| Catálogo de productos | Habilitación de ventas | Los vendedores lo hojean sin descargarlo |
| Manual de capacitación | Incorporación | Los nuevos leen en orden, en cualquier dispositivo |
| Informe anual | Dirección | El diseño pulido se mantiene intacto |
| Kit de prensa | Marketing | Los periodistas lo previsualizan antes de descargarlo |
Aquí es donde la mayoría de las guías omiten los detalles, y donde más personas se atascan. Atlassian ofrece Confluence en dos versiones principales, y tratan los iframes de forma distinta.
| Función | Confluence Data Center / Server | Confluence Cloud |
|---|---|---|
| Macro Iframe integrado | Sí, en Insertar, Otros macros | No se ofrece como macro estándar |
| Control del dominio | Lista de permitidos del administrador | Controlado por la aplicación o por el soporte de Smart Link |
| Alternativa habitual | No hace falta | Aplicación de iframe del Marketplace, o el Smart Link de incrustación |
| Aprobación del administrador | Obligatoria para dominios nuevos | Obligatoria para instalar una aplicación |
⚠️ Atención: Atlassian cambia su editor y su catálogo de macros con regularidad. Revisa tu propia instancia antes de prometerle a un compañero una ruta de menús concreta. Los pasos siguientes describen el macro Iframe estándar de Data Center y Server, y los enfoques equivalentes para Cloud.
El macro integrado es todo lo que necesitas. Agregarás el dominio del flipbook a la lista de permitidos, luego insertarás el macro y pegarás el enlace.
Tienes dos opciones prácticas. La primera, una aplicación del Marketplace que ofrece un macro de estilo iframe, instalada por un administrador del sitio. La segunda, pegar el enlace del flipbook en una línea propia y elegir la opción de visualización incrustada de un Smart Link, cuando el dominio sea compatible. Si tu administrador no permite ninguna de las dos, una tarjeta de enlace sencilla que abre el flipbook en una pestaña nueva es la alternativa.
Antes de tocar Confluence, necesitas algo que valga la pena incrustar. Esta es la versión corta del proceso en Flipbooks AI.
La herramienta Incrustar flipbook en un sitio web explica las opciones de incrustación con más detalle.
Confluence no carga un sitio externo dentro de un iframe hasta que un administrador lo aprueba. Saltarse este paso es la razón número uno de un marco en blanco.
✅ Buena práctica: Permite el patrón más estrecho que funcione. Permitir un solo host exacto de flipbook es más seguro que permitir un dominio de nivel superior completo.
Un iframe carga la página de otra persona con tu página como contenedor. Los administradores quieren un registro de exactamente qué fuentes externas son de confianza. Es un buen hábito, no un obstáculo. Pídelo una vez, documenta el dominio aprobado en una página del wiki para tu equipo, y las incrustaciones posteriores solo requieren un clic.
Ahora viene lo principal. Abre la página de Confluence donde debe aparecer el flipbook y cambia al modo de edición.
El paso de página se lee mejor en un marco ancho. Un flipbook muestra dos páginas lado a lado en un equipo de escritorio, así que un recuadro alto y estrecho comprime la doble página.
| Diseño del wiki | Ancho sugerido | Alto sugerido | Notas |
|---|---|---|---|
| Página de ancho completo | 100% | 700 px | Ideal para catálogos e informes |
| Página estándar | 100% | 600 px | Opción segura para manuales |
| Diseño de dos columnas | 100% | 520 px | Vista de una página en columnas estrechas |
| Widget de barra lateral | 100% | 400 px | Úsalo solo para vistas previas de portada |
Definir el ancho en 100% hace que el marco llene el área de contenido de la página, sea cual sea la pantalla. Los anchos fijos en píxeles se ven bien en tu monitor y se rompen en una laptop. Usa porcentajes para el ancho y un valor en píxeles para el alto.
💡 Consejo profesional: Abre la página publicada en un teléfono antes de anunciarla. Si el flipbook se ve apretado, aumenta un poco el alto en lugar de reducir el ancho.
Una gerente de RR. HH. exporta el manual del empleado a PDF, lo convierte y lo incrusta al inicio de la página "Nuevo ingreso: empieza aquí". Los nuevos empleados lo hojean a su propio ritmo. Cuando cambia la política de licencias, RR. HH. reemplaza el archivo original y la página sigue actualizada sin ediciones. Si el manual es interno, un Flipbook de manual de capacitación con contraseña lo mantiene privado.
Una responsable de habilitación de ventas incrusta el Catálogo de productos actual en la página principal del espacio del equipo. Los vendedores lo abren antes de las llamadas, comparten el mismo enlace con los clientes y nunca vuelven a preguntar "¿cuál es la versión más reciente?".
Un equipo de finanzas publica el Informe anual como flipbook, lo incrusta en un espacio de dirección y revisa las estadísticas para ver qué secciones se leen.
| Enfoque | Experiencia del lector | Mantenimiento | Ideal para |
|---|---|---|---|
| Adjunto PDF | Descarga o vista previa pequeña | Volver a subir con cada cambio | Archivos que casi nadie lee |
| Página reconstruida en Confluence | Totalmente nativa | Pesado, se pierde el diseño | Contenido de texto breve |
| Flipbook con iframe | Paso de página, dentro de la página | Un solo enlace de origen | Documentos diseñados |
| Tarjeta de enlace al flipbook | Se abre en una pestaña nueva | Un solo enlace de origen | Cloud sin compatibilidad con iframe |
Algo saldrá mal al menos una vez. Esta es la lista de verificación, ordenada según la frecuencia con que aparece cada causa.
Es lo esperado cuando la protección está activada. Comparte la contraseña en tu mensaje de incorporación, o elige una configuración de enlace que se ajuste al espacio. Los permisos del wiki controlan quién ve la página, mientras que la contraseña del flipbook controla quién lee el documento. Usar ambas cosas es una combinación sólida para material sensible.
| Síntoma | Causa probable | Solución |
|---|---|---|
| Recuadro gris en blanco | Dominio fuera de la lista de permitidos | Agrega el dominio en la lista de permitidos del administrador |
| "Se rechazó la conexión" | El host bloquea el marco | Usa el enlace oficial para incrustar de la plataforma |
| Páginas recortadas | Marco demasiado pequeño | Aumenta el alto y define el ancho en 100% |
| Funciona solo en el equipo de escritorio | Ancho fijo en píxeles | Cambia a un ancho en porcentaje |
| La contraseña aparece en bucle | El navegador bloquea las cookies en los marcos | Permite las cookies para el dominio del flipbook |
⚠️ Advertencia: Algunos navegadores corporativos bloquean por defecto las cookies de terceros. Si un flipbook protegido con contraseña sigue pidiéndola dentro del marco, prueba en otro navegador antes de culpar a la configuración.
Un iframe carga una segunda página, así que cada incrustación añade algo de peso. Coloca un flipbook por sección, no diez en una sola página. Si necesitas varios, usa el macro de expandir de Confluence para que el marco se cargue cuando el lector lo abra, o dale a cada flipbook su propia página y enlázalas entre sí.
En el plan Professional, las estadísticas muestran qué páginas se leen y durante cuánto tiempo. Un manual donde todos se detienen en la página seis indica que el siguiente capítulo necesita una reescritura. Consulta los planes y precios para ver qué incluye cada nivel.
Un flipbook incrustado solo es útil si la gente puede leerlo de verdad. Unas pocas decisiones pequeñas marcan una gran diferencia.
Los lectores de pantalla anuncian los iframes por su título. Si tu macro o aplicación tiene un campo de título, usa algo descriptivo como "Flipbook del manual del empleado" en lugar de dejarlo en blanco. Acompaña el marco con un enlace de texto normal justo encima, para que quien no pueda usar el visor incrustado pueda abrir el documento directamente.
Agrega una frase debajo del marco como "¿Prefieres verlo en pantalla completa? Abre el flipbook en una pestaña nueva". Esto ayuda en dos situaciones: un lector en un navegador bloqueado donde los marcos están deshabilitados, y un lector que simplemente quiere la vista más grande posible. Un enlace directo también te da una copia de seguridad segura cuando un administrador quita un dominio de la lista de permitidos.
Las páginas del wiki se leen en teléfonos más de lo que la mayoría de los equipos admite. Como el diseño del flipbook es adaptable, cambia a una vista de una sola página en pantallas estrechas. Abre la página publicada en un teléfono y revisa tres cosas: que el marco quepa en el ancho, que las páginas se pasen con un deslizamiento y que la página no atrape el desplazamiento. Si el marco atrapa el desplazamiento, reduce el alto para que quede visible una parte de la página por encima y por debajo.
| Comprobación | Por qué importa |
|---|---|
| Enlace de texto descriptivo encima del marco | Ofrece una ruta alternativa |
| Ancho definido en 100% | Evita el desplazamiento lateral |
| Alto probado en laptop y teléfono | Evita páginas recortadas |
| Contraseña compartida con la audiencia | Evita preguntas de soporte |
| Archivo original con nombre claro | Facilita las actualizaciones después |
Incrustar es fácil. Mantener sano un wiki es más difícil, porque los documentos envejecen. Una pequeña rutina evita las incrustaciones desactualizadas.
Los equipos que publican material público, como un Kit de prensa o un Catálogo digital, son los que más se benefician, ya que el mismo enlace sirve para el wiki, el sitio web y las campañas de correo. Explora el directorio completo de herramientas de flipbooks para encontrar una plantilla que se ajuste a tu tipo de documento.
Ya tienes la receta completa: crea el flipbook, permite el dominio, inserta el macro Iframe, dimensiónalo con sentido y pruébalo en un teléfono. Todo el proceso toma unos quince minutos una vez que tu administrador haya aprobado el dominio, y reemplaza un montón de adjuntos PDF desactualizados por un solo documento vivo.
¿Listo para probarlo? Crea tu primer flipbook gratis en Flipbooks AI, explora las herramientas y plantillas para elegir un diseño inicial, y compara los planes y precios cuando necesites estadísticas, captación de contactos o flipbooks ilimitados. Cuando estés listo para publicar, la página Incrustar flipbook en un sitio web reúne las opciones de incrustación en un solo lugar.
Elige tu idioma
