> 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/pt/integracoes/overview/integrations/storyblok.md).

# Storyblok

Integre o seu Workflow com Storyblok

O passo da Integração com Storyblok permite ligar os seus fluxos de trabalho do AirOps aos seus espaços do Storyblok. Esta integração nativa oferece capacidades abrangentes de gestão de stories, componentes, datasources e pastas diretamente a partir dos seus fluxos de trabalho.

## Visão geral

Storyblok é um CMS headless com um editor visual que permite às equipas criar e gerir conteúdo estruturado para qualquer canal digital. Ao ligar o Storyblok ao AirOps, pode automatizar a criação, publicação e gestão de conteúdo em todos os seus espaços do Storyblok.

## Autenticação

Antes de utilizar a integração do Storyblok nos seus fluxos de trabalho, tem primeiro de ligar a sua conta Storyblok nas Definições do AirOps:

1. Navegue para **Definições > Integrações**
2. Encontre a secção Storyblok e clique em "Configurar"
3. Introduza o seu **Token de Gestão** — um Token de Acesso Pessoal gerado na sua conta Storyblok em **A Minha Conta > Tokens de Acesso Pessoal**. Necessário para operações de escrita
4. Introduza o seu **Token de Acesso** — um token da Content Delivery API encontrado no seu espaço em **Definições > Tokens de Acesso**. Utilizado para ler stories
5. Introduza o seu **ID do Espaço** — o ID numérico do seu espaço Storyblok, encontrado em **Definições > Espaço**
6. Opcionalmente, selecione uma **Região** — a região do seu espaço Storyblok: `eu` (predefinição), `us`, `ca`, ou `ap`

{% hint style="info" %}
As operações de leitura (Obter Story, Listar Stories) usam o token da Content Delivery API, enquanto as operações de escrita (Criar, Atualizar, Eliminar, Publicar) exigem o Token de Gestão.
{% endhint %}

## Ações disponíveis

### Gestão de Stories

* **Criar Story** -- adicionar uma nova story a um espaço Storyblok
* **Obter Story** -- obter uma única story por slug completo ou ID
* **Listar Stories** -- obter várias stories com filtros opcionais
* **Atualizar Story** -- modificar o conteúdo ou os metadados de uma story existente
* **Publicar Story** -- tornar uma story publicamente disponível
* **Despublicar Story** -- reverter uma story publicada para rascunho
* **Eliminar Story** -- remover permanentemente uma story

### Componentes

* **Obter Componente** -- obter um único componente por ID
* **Listar Componentes** -- obter todos os componentes definidos no espaço

### Datasources

* **Listar Datasources** -- obter todas as datasources no espaço
* **Listar Entradas da Datasource** -- obter entradas de uma datasource específica

### Pastas

* **Listar Pastas** -- obter todas as pastas no espaço

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-d000412c8d08139155e0dda1c415e143dd2f3bdb%2Fstoryblok-01-actions.png?alt=media" alt="Storyblok Integration step with the Action dropdown listing Create Story, Get Story, List Stories, Update Story, Publish Story, Unpublish Story, Delete Story, Get Component, List Components, List Datasources, List Datasource Entries, List Folders"><figcaption><p>Escolha uma ação do Storyblok.</p></figcaption></figure>

## Parâmetros da Ação

### Criar Story

1. **Nome** (obrigatório) -- o nome a apresentar da story (por exemplo, `O Meu Artigo do Blogue`)
2. **Slug** (obrigatório) -- o slug do URL para a story (por exemplo, `my-blog-post`)
3. **Conteúdo** -- um objeto JSON de campos de conteúdo que corresponde ao esquema do componente da story (por exemplo, `{"component": "article", "title": "Olá"}`)
4. **ID da Pasta Pai** -- o ID numérico da pasta pai onde colocar a story

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-89f653187dd7e4bd09913ed3436f9b6008866ff6%2Fstoryblok-02-create-story.png?alt=media" alt="Storyblok Create Story action with name, slug, content JSON, and parent folder"><figcaption><p>Criar uma story do Storyblok a partir dos resultados do Workflow.</p></figcaption></figure>

### Obter Story

1. **Slug Completo ou ID** (obrigatório) -- o slug completo (por exemplo, `blog/meu-artigo`) ou o ID numérico da story a obter
2. **Versão** -- que versão devolver: `publicado` (predefinição) ou `rascunho`

### Listar Stories

1. **Começa Com** -- filtrar stories cujo slug completo comece com uma determinada string (por exemplo, `blog/`)
2. **Versão** -- que versão devolver: `publicado` (predefinição) ou `rascunho`
3. **Termo de Pesquisa** -- uma consulta de pesquisa para filtrar stories por nome, slug ou conteúdo
4. **Com Etiqueta** -- filtrar stories que tenham um slug de etiqueta específico
5. **Ordenar Por** -- campo e direção para ordenar os resultados (por exemplo, `nome:asc`, `criado_em:desc`)
6. **Por Página** -- o número de stories por página (predefinição: `25`, máximo: `100`)
7. **Página** -- o número da página para paginação (predefinição: `1`)

### Atualizar Story

1. **ID da Story** (obrigatório) -- o ID numérico da story a atualizar
2. **Nome** -- o nome a apresentar da story
3. **Slug** -- o slug do URL para a story
4. **Conteúdo** -- um objeto JSON de campos de conteúdo que corresponde ao esquema do componente da story
5. **ID da Pasta Pai** -- o ID numérico da pasta pai

### Publicar Story

1. **ID da Story** (obrigatório) -- o ID numérico da story a publicar

### Despublicar Story

1. **ID da Story** (obrigatório) -- o ID numérico da story a despublicar

### Eliminar Story

1. **ID da Story** (obrigatório) -- o ID numérico da story a eliminar

### Obter Componente

1. **ID do Componente** (obrigatório) -- o ID numérico do componente a obter

### Listar Componentes

Não são necessários parâmetros.

### Listar Datasources

1. **Por Página** -- o número de datasources por página (predefinição: `25`, máximo: `100`)
2. **Página** -- o número da página para paginação (predefinição: `1`)

### Listar Entradas da Datasource

1. **ID da Datasource** (obrigatório) -- o ID numérico da datasource
2. **Por Página** -- o número de entradas por página (predefinição: `25`, máximo: `100`)
3. **Página** -- o número da página para paginação (predefinição: `1`)

### Listar Pastas

1. **Por Página** -- o número de pastas por página (predefinição: `25`, máximo: `100`)
2. **Página** -- o número da página para paginação (predefinição: `1`)

## Casos de uso comuns

* Criar e publicar automaticamente stories de blog a partir de conteúdo gerado por IA
* Atualizar o conteúdo das stories em massa com base nas condições do fluxo de trabalho
* Obter stories por slug para enriquecer ou reescrever conteúdo existente
* Criar pipelines de conteúdo que criam stories em rascunho e publicam após revisão
* Listar stories por etiqueta ou prefixo de slug para executar auditorias ou aplicar transformações em massa
* Obter esquemas de componentes para validar ou gerar conteúdo estruturado programaticamente

{% hint style="info" %}
Nota: a integração Storyblok requer tanto um Token de Gestão como um token da Content Delivery API. Certifique-se de que ambos os tokens têm as permissões adequadas para as operações que os seus fluxos de trabalho executam.
{% 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/pt/integracoes/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.
