> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/integraciones/overview/integrations/storyblok.md).

# Storyblok

Integra tu flujo de trabajo con Storyblok

El paso de integración con Storyblok te permite conectar tus flujos de trabajo de AirOps con tus espacios de Storyblok. Esta integración nativa ofrece capacidades completas de gestión de historias, componentes, fuentes de datos y carpetas directamente desde tus flujos de trabajo.

## Descripción general

Storyblok es un CMS headless con un editor visual que permite a los equipos crear y gestionar contenido estructurado para cualquier canal digital. Al conectar Storyblok con AirOps, puedes automatizar la creación, publicación y gestión de contenido en tus espacios de Storyblok.

## Autenticación

Antes de usar la integración de Storyblok en tus flujos de trabajo, primero debes conectar tu cuenta de Storyblok en la configuración de AirOps:

1. Navega a **Ajustes > Integraciones**
2. Encuentra la sección de Storyblok y haz clic en "Configurar"
3. Introduce tu **Token de gestión** — un token de acceso personal generado en tu cuenta de Storyblok en **Mi cuenta > Tokens de acceso personal**. Requerido para operaciones de escritura
4. Introduce tu **Token de acceso** — un token de la API de entrega de contenido que se encuentra en tu espacio en **Configuración > Tokens de acceso**. Se usa para leer historias
5. Introduce tu **ID del espacio** — el ID numérico de tu espacio de Storyblok, que se encuentra en **Configuración > Espacio**
6. Opcionalmente, selecciona **Región** — la región de tu espacio de Storyblok: `eu` (predeterminado), `us`, `ca`, o `ap`

{% hint style="info" %}
Las operaciones de lectura (Obtener historia, Listar historias) usan el token de la API de entrega de contenido, mientras que las operaciones de escritura (Crear, Actualizar, Eliminar, Publicar) requieren el Token de gestión.
{% endhint %}

## Acciones disponibles

### Gestión de historias

* **Crear historia** -- añade una nueva historia a un espacio de Storyblok
* **Obtener historia** -- recupera una sola historia por slug completo o ID
* **Listar historias** -- obtiene varias historias con filtros opcionales
* **Actualizar historia** -- modifica el contenido o los metadatos de una historia existente
* **Publicar historia** -- hace que una historia esté disponible públicamente
* **Despublicar historia** -- revierte una historia publicada a borrador
* **Eliminar historia** -- elimina permanentemente una historia

### Componentes

* **Obtener componente** -- recupera un solo componente por ID
* **Listar componentes** -- obtiene todos los componentes definidos en el espacio

### Fuentes de datos

* **Listar fuentes de datos** -- obtiene todas las fuentes de datos del espacio
* **Listar entradas de la fuente de datos** -- obtiene las entradas de una fuente de datos específica

### Carpetas

* **Listar carpetas** -- obtiene todas las carpetas del espacio

## Parámetros de acción

### Crear historia

1. **Nombre** (requerido) -- el nombre visible de la historia (p. ej., `Mi entrada de blog`)
2. **Slug** (requerido) -- el slug de URL de la historia (p. ej., `my-blog-post`)
3. **Contenido** -- un objeto JSON de campos de contenido que coincida con el esquema del componente de la historia (p. ej., `{"component": "article", "title": "Hello"}`)
4. **ID padre** -- el ID numérico de la carpeta padre en la que colocar la historia

### Obtener historia

1. **Slug completo o ID** (requerido) -- el slug completo (p. ej., `blog/my-post`) o el ID numérico de la historia que se va a recuperar
2. **Versión** -- qué versión devolver: `published` (predeterminado) o `borrador`

### Listar historias

1. **Empieza con** -- filtra historias cuyo slug completo empieza con una cadena dada (p. ej., `blog/`)
2. **Versión** -- qué versión devolver: `published` (predeterminado) o `borrador`
3. **Término de búsqueda** -- una consulta de búsqueda para filtrar historias por nombre, slug o contenido
4. **Con etiqueta** -- filtra historias que tengan un slug de etiqueta específico
5. **Ordenar por** -- campo y dirección para ordenar los resultados (p. ej., `name:asc`, `created_at:desc`)
6. **Por página** -- el número de historias por página (predeterminado: `25`, máximo: `100`)
7. **Página** -- el número de página para la paginación (predeterminado: `1`)

### Actualizar historia

1. **ID de la historia** (requerido) -- el ID numérico de la historia que se va a actualizar
2. **Nombre** -- el nombre visible de la historia
3. **Slug** -- el slug de URL de la historia
4. **Contenido** -- un objeto JSON de campos de contenido que coincida con el esquema del componente de la historia
5. **ID padre** -- el ID numérico de la carpeta padre

### Publicar historia

1. **ID de la historia** (requerido) -- el ID numérico de la historia que se va a publicar

### Despublicar historia

1. **ID de la historia** (requerido) -- el ID numérico de la historia que se va a despublicar

### Eliminar historia

1. **ID de la historia** (requerido) -- el ID numérico de la historia que se va a eliminar

### Obtener componente

1. **ID del componente** (requerido) -- el ID numérico del componente que se va a recuperar

### Listar componentes

No se requieren parámetros.

### Listar fuentes de datos

1. **Por página** -- el número de fuentes de datos por página (predeterminado: `25`, máximo: `100`)
2. **Página** -- el número de página para la paginación (predeterminado: `1`)

### Listar entradas de la fuente de datos

1. **ID de la fuente de datos** (requerido) -- el ID numérico de la fuente de datos
2. **Por página** -- el número de entradas por página (predeterminado: `25`, máximo: `100`)
3. **Página** -- el número de página para la paginación (predeterminado: `1`)

### Listar carpetas

1. **Por página** -- el número de carpetas por página (predeterminado: `25`, máximo: `100`)
2. **Página** -- el número de página para la paginación (predeterminado: `1`)

## Casos de uso comunes

* Crear y publicar automáticamente historias de blog a partir de contenido generado por IA
* Actualizar el contenido de historias en bloque según las condiciones del flujo de trabajo
* Obtener historias por slug para enriquecer o reescribir contenido existente
* Crear canales de contenido que generen historias en borrador y publiquen tras la revisión
* Listar historias por etiqueta o prefijo de slug para realizar auditorías o aplicar transformaciones masivas
* Recuperar esquemas de componentes para validar o generar contenido estructurado de forma programática

{% hint style="info" %}
Nota: la integración de Storyblok requiere tanto un Token de gestión como un token de la API de entrega de contenido. Asegúrate de que ambos tokens tengan los permisos adecuados para las operaciones que realizan tus flujos de trabajo.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/integraciones/overview/integrations/storyblok.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.