> 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 A etapa de Integração Storyblok permite ligar os seus fluxos de trabalho AirOps aos seus espaços Storyblok. Esta integração nativa oferece capacidades abrangentes de gestão de publicações, componentes, fontes de dados 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 Storyblok. ## Autenticação Antes de utilizar a integração Storyblok nos seus fluxos de trabalho, primeiro tem de ligar a sua conta Storyblok nas Definições do AirOps: 1. Navegue até **Definições > Integrações** 2. Encontre a secção Storyblok e clique em "Configurar" 3. Insira sua **Token de Gestão** — um Token de Acesso Pessoal gerado na sua conta Storyblok em **A Minha Conta > Tokens de Acesso Pessoais**. Necessário para operações de escrita 4. Insira sua **Token de acesso** — um token da API de Entrega de Conteúdo encontrado no seu espaço em **Definições > Tokens de Acesso**. Usado para ler publicações 5. Insira sua **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` (padrão), `us`, `ca`, ou `ap` {% hint style="info" %} As operações de leitura (Obter publicação, Listar publicações) usam o token da API de Entrega de Conteúdo, enquanto as operações de escrita (Criar, Atualizar, Eliminar, Publicar) exigem o Token de Gestão. {% endhint %} ## Ações disponíveis ### Gestão de Publicações * **Criar Publicação** -- adicionar uma nova publicação a um espaço Storyblok * **Obter Publicação** -- obter uma única publicação pelo slug completo ou ID * **Listar Publicações** -- obter várias publicações com filtros opcionais * **Atualizar Publicação** -- modificar o conteúdo ou os metadados de uma publicação existente * **Publicar Publicação** -- tornar uma publicação disponível publicamente * **Despublicar Publicação** -- reverter uma publicação publicada para rascunho * **Eliminar Publicação** -- remover permanentemente uma publicação ### Componentes * **Obter Componente** -- obter um único componente por ID * **Listar Componentes** -- obter todos os componentes definidos no espaço ### Fontes de Dados * **Listar Fontes de Dados** -- obter todas as fontes de dados no espaço * **Listar Entradas da Fonte de Dados** -- obter entradas para uma fonte de dados específica ### Pastas * **Listar Pastas** -- obter todas as pastas no espaço ## Parâmetros da Ação ### Criar Publicação 1. **Nome** (obrigatório) -- o nome de apresentação da publicação (p. ex. `A Minha Publicação no Blog`) 2. **Slug** (obrigatório) -- o slug de URL da publicação (p. ex. `my-blog-post`) 3. **Conteúdo** -- um objeto JSON de campos de conteúdo que corresponde ao esquema do componente da publicação (p. ex. `{"component": "article", "title": "Olá"}`) 4. **ID da Pasta Principal** -- o ID numérico da pasta principal na qual colocar a publicação ### Obter Publicação 1. **Slug Completo ou ID** (obrigatório) -- o slug completo (p. ex. `blog/my-post`) ou o ID numérico da publicação a obter 2. **Versão** -- qual versão devolver: `publicado` (predefinição) ou `rascunho` ### Listar Publicações 1. **Começa Com** -- filtrar publicações cujo slug completo começa com uma determinada string (p. ex. `blog/`) 2. **Versão** -- qual versão devolver: `publicado` (predefinição) ou `rascunho` 3. **Termo de Pesquisa** -- uma consulta de pesquisa para filtrar publicações por nome, slug ou conteúdo 4. **Com Etiqueta** -- filtrar publicações que tenham um slug de etiqueta específico 5. **Ordenar Por** -- campo e direção para ordenar os resultados (p. ex. `name:asc`, `created_at:desc`) 6. **Por Página** -- o número de publicações por página (predefinição: `25`, máx: `100`) 7. **Página** -- o número da página para paginação (predefinição: `1`) ### Atualizar Publicação 1. **ID da Publicação** (obrigatório) -- o ID numérico da publicação a atualizar 2. **Nome** -- o nome de apresentação da publicação 3. **Slug** -- o slug de URL da publicação 4. **Conteúdo** -- um objeto JSON de campos de conteúdo que corresponde ao esquema do componente da publicação 5. **ID da Pasta Principal** -- o ID numérico da pasta principal ### Publicar Publicação 1. **ID da Publicação** (obrigatório) -- o ID numérico da publicação a publicar ### Despublicar Publicação 1. **ID da Publicação** (obrigatório) -- o ID numérico da publicação a despublicar ### Eliminar Publicação 1. **ID da Publicação** (obrigatório) -- o ID numérico da publicação 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 Fontes de Dados 1. **Por Página** -- o número de fontes de dados por página (predefinição: `25`, máx: `100`) 2. **Página** -- o número da página para paginação (predefinição: `1`) ### Listar Entradas da Fonte de Dados 1. **ID da Fonte de Dados** (obrigatório) -- o ID numérico da fonte de dados 2. **Por Página** -- o número de entradas por página (predefinição: `25`, máx: `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áx: `100`) 2. **Página** -- o número da página para paginação (predefinição: `1`) ## Casos de Utilização Comuns * Criar e publicar automaticamente publicações de blog a partir de conteúdo gerado por IA * Atualizar em massa o conteúdo de publicações com base nas condições do fluxo de trabalho * Obter publicações por slug para enriquecer ou reescrever conteúdo existente * Construir pipelines de conteúdo que criam publicações em rascunho e publicam após revisão * Listar publicações 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 API de Entrega de Conteúdo. Certifique-se de que ambos os tokens têm as permissões apropriadas 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=&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.