> 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/craft-cms.md).

# Craft CMS

Integre o seu Workflow com Craft CMS

A etapa de Integração com o Craft CMS permite ligar os seus fluxos de trabalho do AirOps à sua instância do Craft CMS. Esta integração nativa oferece capacidades abrangentes de gestão de entradas e ativos diretamente a partir dos seus fluxos de trabalho.

## Visão geral

O Craft CMS é um sistema de gestão de conteúdo flexível e fácil de usar, criado para a criação de experiências digitais personalizadas. Ao ligar o Craft CMS ao AirOps, pode automatizar a criação de conteúdo, a publicação e a gestão de ativos em todos os seus projetos Craft.

## Autenticação

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

1. Navegue para **Definições > Integrações**
2. Encontre a secção do Craft CMS e clique em "Configurar"
3. Introduza o seu **Token GraphQL** — um token com permissões de escrita gerado no painel de controlo do seu Craft CMS em **GraphQL > Tokens**
4. Introduza o seu **URL do Site** — o URL base da sua instância do Craft CMS (por ex. `https://example.com`)
5. Opcionalmente, introduza um **ID do Autor Predefinido** — o ID numérico do utilizador do Craft CMS a atribuir como autor das entradas por defeito. As ações individuais podem substituir este valor

{% hint style="info" %}
O seu token GraphQL tem de ter permissões para ler e escrever entradas e ativos nas secções que pretende usar.
{% endhint %}

## Ações disponíveis

### Gestão de Entradas

* **Criar Entrada** -- adicionar uma nova entrada a uma secção do Craft CMS
* **Atualizar Entrada** -- modificar os campos, estado ou metadados de uma entrada existente
* **Obter Entrada** -- recuperar uma única entrada por ID ou slug
* **Listar Entradas** -- obter várias entradas de uma secção com filtros opcionais
* **Eliminar Entrada** -- remover permanentemente uma entrada

### Gestão de Ativos

* **Obter Ativo** -- recuperar um único ativo por ID
* **Listar Ativos** -- obter ativos de um volume com filtros opcionais
* **Associar Ativo à Entrada** -- associar ativos existentes a um campo de ativos de uma entrada
* **Eliminar Ativo** -- remover permanentemente um ativo de um volume

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-bb42b640dca84f5966c32335d30eba5ea932bd8d%2Fcraft-cms-01-actions.png?alt=media" alt="Craft CMS Integration step with the Action dropdown listing Create Entry, Update Entry, Get Entry, List Entries, Delete Entry, Get Asset, List Assets, Attach Asset to Entry, Delete Asset"><figcaption><p>Escolha uma ação do Craft CMS.</p></figcaption></figure>

## Parâmetros da Ação

### Criar Entrada

1. **Secção** (obrigatório) -- o handle da secção a que a entrada pertence (por ex. `blog`, `news`)
2. **Tipo de Entrada** -- o handle do tipo de entrada (por ex. `default`, `article`). O padrão é `default`
3. **Título** -- o título da entrada
4. **Slug** -- o slug de URL da entrada
5. **Status** -- estado da entrada: `ativa` ou `desativada`
6. **Data de Publicação** -- a data em que a entrada deve ser publicada (formato ISO 8601)
7. **Data de Expiração** -- a data em que a entrada deve expirar (formato ISO 8601)
8. **Campos Personalizados** -- um objeto JSON de valores de campos personalizados, indexado pelo handle do campo
9. **ID do Autor** -- o ID numérico do autor da entrada. Substitui o ID do Autor Predefinido definido nas credenciais

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-e53edbdf840569145aef2d402172a288ffcd58c9%2Fcraft-cms-02-create-entry.png?alt=media" alt="Craft CMS Create Entry action with section, entry type, title, slug, status, and custom fields"><figcaption><p>Crie uma entrada do Craft CMS a partir dos resultados do fluxo de trabalho.</p></figcaption></figure>

### Atualizar Entrada

1. **ID da Entrada** (obrigatório) -- o ID numérico da entrada a atualizar
2. **Secção** -- o handle da secção a que a entrada pertence
3. **Tipo de Entrada** -- o handle do tipo de entrada
4. **Título** -- o título da entrada
5. **Slug** -- o slug de URL da entrada
6. **Status** -- estado da entrada: `ativa` ou `desativada`
7. **Data de Publicação** -- a data em que a entrada deve ser publicada
8. **Data de Expiração** -- a data em que a entrada deve expirar
9. **Campos Personalizados** -- um objeto JSON de valores de campos personalizados, indexado pelo handle do campo
10. **ID do Autor** -- o ID numérico do autor da entrada. Substitui o ID do Autor Predefinido definido nas credenciais

### Obter Entrada

1. **Pesquisar Por** (obrigatório) -- como identificar a entrada: `id` ou `slug`
2. **Valor da Pesquisa** (obrigatório) -- o valor do ID ou slug a procurar
3. **Tipo de Entrada** -- o handle do tipo de entrada, usado para construir fragmentos de campos personalizados
4. **Campos** -- lista separada por vírgulas de handles de campos personalizados a incluir na resposta (por ex. `heroImage,body`)

### Listar Entradas

1. **Secção** -- o handle da secção para filtrar
2. **Tipo de Entrada** -- o handle do tipo de entrada, usado para construir fragmentos de campos personalizados
3. **Campos** -- lista separada por vírgulas de handles de campos personalizados a incluir na resposta
4. **Pesquisar** -- uma string de consulta de pesquisa para filtrar entradas
5. **Limite** -- o número máximo de entradas a devolver
6. **Deslocamento** -- o número de entradas a ignorar (para paginação)

### Eliminar Entrada

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

### Obter Ativo

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

### Listar Ativos

1. **Volume** -- o handle do volume para filtrar ativos por (por ex. `images`, `documents`)
2. **Pesquisar** -- uma string de consulta de pesquisa para filtrar ativos
3. **Limite** -- o número máximo de ativos a devolver

### Associar Ativo à Entrada

1. **ID da Entrada** (obrigatório) -- o ID numérico da entrada à qual anexar ativos
2. **Secção** (obrigatório) -- o handle da secção a que a entrada pertence
3. **Tipo de Entrada** -- o handle do tipo de entrada
4. **Handle do Campo** (obrigatório) -- o handle do campo de Ativos na entrada (por ex. `heroImage`, `images`)
5. **IDs dos Ativos** (obrigatório) -- lista separada por vírgulas de IDs de ativos a anexar (por ex. `123,456`). Substitui quaisquer ativos existentes no campo
6. **ID do Autor** -- o ID numérico do autor da entrada. Substitui o ID do Autor Predefinido definido nas credenciais

### Eliminar Ativo

1. **ID do Ativo** (obrigatório) -- o ID numérico do ativo a eliminar

## Casos de uso comuns

* Criar e publicar automaticamente entradas de blogue a partir de conteúdo gerado por IA
* Atualizar em massa os estados das entradas com base nas condições do fluxo de trabalho
* Anexar imagens geradas ou carregadas às entradas como ativos principais
* Obter entradas por slug para enriquecer ou reescrever conteúdo existente
* Criar pipelines de conteúdo que criam entradas em rascunho e publicam após revisão
* Limpar programaticamente entradas e ativos expirados ou obsoletos

{% hint style="info" %}
Nota: a integração do Craft CMS requer um token GraphQL com as permissões adequadas. Certifique-se de que o seu token concede acesso às secções e volumes que pretende usar.
{% 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/craft-cms.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.
