{"id":8434,"date":"2026-10-08T10:17:08","date_gmt":"2026-10-08T08:17:08","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/article\/guia-de-integracion-con-storyblok\/"},"modified":"2026-10-08T10:17:08","modified_gmt":"2026-10-08T08:17:08","slug":"guia-de-integracion-con-storyblok","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/es\/article\/guia-de-integracion-con-storyblok\/","title":{"rendered":"Gu\u00eda de integraci\u00f3n con Storyblok"},"content":{"rendered":"<p>Con la integraci\u00f3n de Kontainer con Storyblok, tus editores pueden elegir im\u00e1genes, v\u00eddeos y archivos directamente desde tu DAM sin subir archivos a Storyblok. Storyblok solo guarda una referencia al archivo; el archivo en s\u00ed permanece en Kontainer y se entrega a trav\u00e9s de la CDN.<\/p>\n<p>Ve a la <a href=\"https:\/\/kontainer.com\/es\/integraciones\" target=\"_blank\" rel=\"noopener\">p\u00e1gina de integraciones<\/a> de Kontainer para saber m\u00e1s sobre los casos de uso, las ventajas y m\u00e1s.<\/p>\n<h2>Requisitos<\/h2>\n<ul>\n<li>Un espacio (space) de Storyblok y derechos de <strong>administrador<\/strong> sobre \u00e9l: la extensi\u00f3n no se puede instalar sin ellos<\/li>\n<li>Una cuenta de Kontainer (https:\/\/yourcompany.kontainer.com)<\/li>\n<li>La integraci\u00f3n con Storyblok activada en tu cuenta de Kontainer: confirma con tu responsable de cuenta que est\u00e1 incluida en tu plan<\/li>\n<\/ul>\n<h2>\u00bfQu\u00e9 se guarda y d\u00f3nde?<\/h2>\n<p>Tus archivos se quedan en Kontainer. No se sube nada a la biblioteca de archivos de Storyblok. Storyblok guarda un valor de archivo est\u00e1ndar que apunta a la CDN de Kontainer, con la referencia de Kontainer a su lado:<\/p>\n<ul>\n<li><code>filename<\/code>: la URL de la CDN, incluida la plantilla de descarga que hayas elegido<\/li>\n<li><code>alt, title<\/code>: se toman de la descripci\u00f3n del archivo en Kontainer<\/li>\n<li><code>focus<\/code>: el punto focal que has definido en Kontainer, en el formato propio de Storyblok<\/li>\n<li><code>meta_data.kontainer_file_id, kontainer_folder_id, kontainer_url<\/code>: identificadores para recuperar el archivo<\/li>\n<li><code>meta_data.kontainer_thumbnail_url, kontainer_extension, kontainer_type<\/code><\/li>\n<\/ul>\n<p>Como el texto alternativo y el punto focal viajan con la referencia, los editores no tienen que volver a escribir los metadatos en Storyblok, y al sustituir un archivo en Kontainer se actualiza en todos los lugares donde se usa.<\/p>\n<h2>Primeros pasos<\/h2>\n<h3>1. Activa la integraci\u00f3n en Kontainer<\/h3>\n<p>Pide a tu responsable de cuenta que active la integraci\u00f3n con Storyblok en tu cuenta de Kontainer. Esto permite que Storyblok incruste el selector de archivos de Kontainer y es necesario para que el selector se abra.<\/p>\n<h3>2. Instala la extensi\u00f3n en Storyblok<\/h3>\n<p>Abre el enlace de instalaci\u00f3n, elige el espacio en el que quieres instalarla y confirma:<\/p>\n<pre><code>https:\/\/app.storyblok.com\/#\/install\/kontainer@asset-picker<\/code><\/pre>\n<p>Necesitas derechos de administrador en el espacio de destino. Inst\u00e1lala una vez por espacio.<\/p>\n<h3>3. A\u00f1ade el campo de Kontainer a un bloque<\/h3>\n<p>En tu espacio, ve a <strong>\u00abBlock Library\u00bb<\/strong> (biblioteca de bloques), abre el bloque en el que quieras el selector y a\u00f1ade un campo nuevo. Define su tipo como <strong>\u00abPlugin\u00bb<\/strong> y elige <code>kontainer<\/code> en la lista.<\/p>\n<h3>4. Apunta el campo a tu Kontainer<\/h3>\n<p>Con el campo seleccionado, a\u00f1ade la opci\u00f3n <code>kontainerHost<\/code> y define su valor como tu dominio de Kontainer, por ejemplo <code>yourcompany.kontainer.com<\/code> (con o sin <code>https:\/\/<\/code>).<\/p>\n<p>Storyblok guarda las opciones de los plugins por campo, as\u00ed que repite este paso en todos los campos que usen el selector. Storyblok no traslada los valores de las opciones de un espacio a otro, as\u00ed que cada espacio se configura por separado.<\/p>\n<h3>5. Elige archivos<\/h3>\n<p>Abre una historia (story) que use el bloque y haz clic en <strong>\u00abSelect from Kontainer\u00bb<\/strong> (elegir desde Kontainer) en el campo. La primera vez, inicia sesi\u00f3n con tu nombre de usuario y tu contrase\u00f1a habituales de Kontainer. Navega, busca y filtra tu biblioteca como siempre, aplica opcionalmente una plantilla de descarga (recorte, cambio de tama\u00f1o, formato) y elige el archivo.<\/p>\n<p>El campo muestra entonces una vista previa y el nombre del archivo. <strong>\u00abReplace asset\u00bb<\/strong> (reemplazar el archivo) elige otro archivo y <strong>\u00abRemove asset\u00bb<\/strong> (quitar el archivo) vac\u00eda el campo. Los archivos que no son im\u00e1genes, como PDF y v\u00eddeos, muestran una tarjeta con el tipo de archivo en lugar de una vista previa.<\/p>\n<h2>Opciones del campo<\/h2>\n<table>\n<tr>\n<th>Opci\u00f3n<\/th>\n<th>Obligatoria<\/th>\n<th>Valor<\/th>\n<\/tr>\n<tr>\n<td><code>kontainerHost<\/code><\/td>\n<td>S\u00ed<\/td>\n<td>Tu dominio de Kontainer, por ejemplo <code>yourcompany.kontainer.com<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>mode<\/code><\/td>\n<td>No<\/td>\n<td><code>external<\/code> (predeterminado) enlaza el archivo en Kontainer. <code>import<\/code> lo copia a la biblioteca de archivos de Storyblok.<\/td>\n<\/tr>\n<tr>\n<td><code>storyblokRegion<\/code><\/td>\n<td>Solo con import<\/td>\n<td><code>eu<\/code> (predeterminado), <code>us<\/code>, <code>ca<\/code>, <code>ap<\/code> o <code>cn<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>storyblokManagementToken<\/code><\/td>\n<td>Solo con import<\/td>\n<td>Un token de acceso personal de Storyblok con acceso de escritura a los archivos<\/td>\n<\/tr>\n<tr>\n<td><code>maxImportMb<\/code><\/td>\n<td>No<\/td>\n<td>El archivo m\u00e1s grande que acepta la importaci\u00f3n; por defecto <code>50<\/code><\/td>\n<\/tr>\n<\/table>\n<h2>Opcional: importar archivos a Storyblok<\/h2>\n<p>Algunos equipos exigen que todos los archivos est\u00e9n alojados en el propio Storyblok. Si defines <code>mode<\/code> como <code>import<\/code>, el archivo se copia a la biblioteca de archivos del espacio en lugar de enlazarse. El archivo es entonces un archivo normal de Storyblok y el servicio de im\u00e1genes de Storyblok puede transformarlo.<\/p>\n<p>Dos cosas que debes tener en cuenta antes de pasar un campo al modo de importaci\u00f3n:<\/p>\n<ul>\n<li>La copia deja de actualizarse cuando el archivo cambia en Kontainer.<\/li>\n<li>El token de gesti\u00f3n es una opci\u00f3n del campo, lo que significa que se entrega al navegador de todos los editores que usan ese campo. Crea para ello un token <strong>con alcance limitado<\/strong>: en Storyblok, dale solo el alcance de archivos (Assets) y restr\u00edngelo al \u00fanico espacio que lo necesita. No reutilices un token que tenga acceso a toda tu cuenta.<\/li>\n<\/ul>\n<h2>Usar el archivo en tu frontend<\/h2>\n<p>El campo devuelve un objeto de archivo est\u00e1ndar de Storyblok, as\u00ed que se comporta como cualquier otro campo de archivo:<\/p>\n<pre><code>const { filename, alt, focus } = story.content.hero;<\/code><\/pre>\n<p>Solicita el archivo desde <code>filename<\/code>: se sirve desde la CDN de Kontainer.<\/p>\n<p>El servicio de im\u00e1genes de Storyblok no cambia el tama\u00f1o ni recorta una URL externa, as\u00ed que usa los par\u00e1metros de transformaci\u00f3n propios de Kontainer, o una plantilla de descarga elegida al seleccionar el archivo, para controlar el tama\u00f1o y el formato entregados. El punto focal est\u00e1 disponible tanto como valor <code>focus<\/code> de Storyblok como en coordenadas de p\u00edxeles sin procesar en <code>meta_data<\/code>.<\/p>\n<h2>Soporte<\/h2>\n<p>Si necesitas ayuda para configurar el plugin de Storyblok, nuestro equipo de soporte te ayudar\u00e1 encantado.<\/p>\n<p>Escribe a: <a href=\"mailto:support@kontainer.com\">support@kontainer.com<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Con la integraci\u00f3n de Kontainer con Storyblok, tus editores pueden insertar im\u00e1genes, v\u00eddeos y archivos directamente desde tu DAM en el Visual Editor de Storyblok, sin descargarlos ni volver a subirlos.<\/p>\n","protected":false},"author":16,"featured_media":0,"menu_order":0,"comment_status":"","ping_status":"closed","template":"","article-category":[208,211],"article-tag":[215,220,222],"class_list":["post-8434","article","type-article","status-publish","hentry","article-category-ajustes-de-administracion","article-category-integraciones-y-plugins","article-tag-funcion-adicional","article-tag-planes-premium","article-tag-dam"],"translations":{"da":{"id":8010,"title":"Integrationsguide til Storyblok","url":"https:\/\/helpdesk.kontainer.com\/da\/article\/integrationsguide-til-storyblok\/"},"de":{"id":7755,"title":"Storyblok-Integrationsleitfaden","url":"https:\/\/helpdesk.kontainer.com\/de\/article\/storyblok-integrationsleitfaden\/"},"en":{"id":7754,"title":"Storyblok Integration Guide","url":"https:\/\/helpdesk.kontainer.com\/article\/storyblok-integration-guide\/"},"es":{"id":8434,"title":"Gu\u00eda de integraci\u00f3n con Storyblok","url":"https:\/\/helpdesk.kontainer.com\/es\/article\/guia-de-integracion-con-storyblok\/"},"fr":{"id":8312,"title":"Guide d\u2019int\u00e9gration de Storyblok","url":"https:\/\/helpdesk.kontainer.com\/fr\/article\/guide-dintegration-storyblok\/"},"nl":{"id":8135,"title":"Integratiegids voor Storyblok","url":"https:\/\/helpdesk.kontainer.com\/nl\/article\/integratiegids-voor-storyblok\/"},"sv":{"id":7857,"title":"Integrationsguide f\u00f6r Storyblok","url":"https:\/\/helpdesk.kontainer.com\/sv\/article\/integrationsguide-for-storyblok\/"}},"_links":{"self":[{"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/article\/8434","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/types\/article"}],"author":[{"embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/comments?post=8434"}],"version-history":[{"count":0,"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/article\/8434\/revisions"}],"wp:attachment":[{"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/media?parent=8434"}],"wp:term":[{"taxonomy":"article-category","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/article-category?post=8434"},{"taxonomy":"article-tag","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/es\/wp-json\/wp\/v2\/article-tag?post=8434"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}