> 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/builder-io.md).

# Builder.io

Integre o seu Workflow com Builder.io

A etapa de Integração com o Builder.io permite conectar os seus workflows do AirOps com os seus espaços do Builder.io. Esta integração nativa oferece capacidades abrangentes de criação de conteúdo e gestão de modelos diretamente a partir dos seus workflows.

## Visão geral

O Builder.io é um CMS headless visual e um criador de páginas que permite às equipas criar e gerir conteúdo estruturado para qualquer canal digital. Ao ligar o Builder.io ao AirOps, pode automatizar a criação de conteúdo, a publicação e a gestão de modelos em todos os seus espaços do Builder.io.

## Autenticação

Antes de usar a integração do Builder.io nos seus workflows, primeiro deve ligar a sua conta Builder.io nas Definições do AirOps:

1. Navegue para **Definições > Integrações**
2. Encontre a secção Builder.io e clique em "Configurar"
3. Introduza o seu **Chave de API Privada** — encontrada no seu espaço Builder.io em **Definições da conta > Espaço**. Necessária para todas as operações de escrita e para ler conteúdo não publicado
4. Opcionalmente, introduza a sua **Chave de API Pública** — usada para ler entradas de conteúdo publicado sem autenticação

{% hint style="info" %}
A Chave de API Privada é necessária para criar, atualizar e eliminar conteúdo e modelos. A Chave de API Pública só é necessária se os seus workflows lerem conteúdo publicamente acessível.
{% endhint %}

## Ações disponíveis

### Gestão de Conteúdo

* **Criar Conteúdo** -- adicionar uma nova entrada de conteúdo a um modelo Builder.io
* **Obter Conteúdo** -- recuperar uma única entrada de conteúdo por ID
* **Listar Conteúdo** -- obter várias entradas de conteúdo de um modelo com filtros opcionais
* **Atualizar Conteúdo** -- modificar os campos ou o estado de uma entrada de conteúdo existente
* **Eliminar Conteúdo** -- remover permanentemente uma entrada de conteúdo

### Gestão de Modelos

* **Criar Modelo** -- definir um novo modelo de conteúdo no seu espaço Builder.io
* **Obter Modelo** -- recuperar um único modelo por ID ou nome
* **Listar Modelos** -- obter todos os modelos no seu espaço
* **Atualizar Modelo** -- modificar a configuração ou os campos de um modelo existente

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-00cae0b01651149d76eac35cbd242cd76b220cdf%2Fbuilder-io-01-actions.png?alt=media" alt="Builder.io Integration step with the Action dropdown listing Create Content, Get Content, List Content, Update Content, Delete Content, Create Model, Get Model, List Models, Update Model"><figcaption><p>Escolha uma ação do Builder.io.</p></figcaption></figure>

## Parâmetros da Ação

### Criar Conteúdo

1. **Nome do Modelo** (obrigatório) -- o nome de API do modelo Builder.io em que criar a entrada (por ex., `blog-post`)
2. **Nome** (obrigatório) -- o título legível da entrada de conteúdo
3. **Dados** -- um objeto JSON de valores de campos personalizados (por ex., `{"title": "Olá", "body": "..."}`)
4. **Publicado** -- o estado de publicação da entrada: `rascunho`, `publicado`, ou `arquivado`

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-d1e1107393110c69ecf9f42b2397b9156b852268%2Fbuilder-io-02-create-content.png?alt=media" alt="Builder.io Create Content action with a model name, entry name, JSON data, and draft status"><figcaption><p>Crie uma entrada Builder.io em rascunho a partir das saídas do fluxo de trabalho.</p></figcaption></figure>

### Obter Conteúdo

1. **Nome do Modelo** (obrigatório) -- o nome de API do modelo Builder.io
2. **ID da Entrada** (obrigatório) -- o ID da entrada de conteúdo a recuperar

### Listar Conteúdo

1. **Nome do Modelo** (obrigatório) -- o nome de API do modelo Builder.io
2. **Incluir Não Publicado** -- se deve incluir entradas em rascunho: `verdadeiro` ou `falso` (predefinição: `falso`)
3. **Campos** -- caminhos de campos separados por vírgulas para incluir na resposta (por ex., `id,name,data.title`)
4. **Omitir** -- caminhos de campos separados por vírgulas para excluir da resposta (por ex., `data.blocks`)
5. **Ordenar** -- um objeto JSON que especifica os campos de ordenação e a direção, em que `1` é ascendente e `-1` é descendente (por ex., `{"data.publishedDate": -1}`)
6. **Limite** -- o número de entradas por página (predefinição: `30`, máximo: `100`)
7. **Deslocamento** -- o número de entradas a ignorar para paginação (predefinição: `0`)

### Atualizar Conteúdo

1. **Nome do Modelo** (obrigatório) -- o nome de API do modelo Builder.io
2. **ID da Entrada** (obrigatório) -- o ID da entrada de conteúdo a atualizar
3. **Nome** -- o novo título legível da entrada
4. **Dados** -- um objeto JSON de campos a atualizar. Apenas os campos especificados são modificados
5. **Publicado** -- o novo estado de publicação: `rascunho`, `publicado`, ou `arquivado`

### Eliminar Conteúdo

1. **Nome do Modelo** (obrigatório) -- o nome de API do modelo Builder.io
2. **ID da Entrada** (obrigatório) -- o ID da entrada de conteúdo a eliminar. Esta ação não pode ser desfeita

### Criar Modelo

1. **Nome** (obrigatório) -- o nome de API do novo modelo em kebab-case (por ex., `blog-post`)
2. **Tipo** (obrigatório) -- o tipo de modelo: `data`, `página`, `componente`, `secção`, ou `símbolo`
3. **Texto de Ajuda** -- uma descrição do modelo mostrada na interface do Builder.io
4. **Singleton** -- se só pode existir uma entrada para este modelo: `verdadeiro` ou `falso`
5. **Repetível** -- se são permitidas várias entradas: `verdadeiro` ou `falso`
6. **Legível Publicamente** -- se as entradas podem ser lidas sem autenticação: `verdadeiro` ou `falso`
7. **Escrevível Publicamente** -- se as entradas podem ser escritas sem autenticação: `verdadeiro` ou `falso`
8. **Campos** -- um array JSON de definições de campos, cada um com um `nome` quanto no `tipo` (por ex. `[{"name": "title", "type": "string"}]`)

### Obter Modelo

1. **Pesquisar Por** -- como identificar o modelo: `id` (predefinição) ou `nome`
2. **Valor da Pesquisa** (obrigatório) -- o ID ou nome do modelo a procurar

### Listar Modelos

1. **Limite** -- o número de modelos por página (predefinição: `100`)
2. **Deslocamento** -- o número de modelos a ignorar para paginação (predefinição: `0`)

### Atualizar Modelo

1. **ID do Modelo** (obrigatório) -- o ID do modelo a atualizar
2. **Nome** -- o novo nome de API em kebab-case
3. **Tipo** -- o novo tipo de modelo: `data`, `página`, `componente`, `secção`, ou `símbolo`
4. **Texto de Ajuda** -- a nova descrição do modelo
5. **Singleton** -- atualizar a definição de singleton: `verdadeiro` ou `falso`
6. **Repetível** -- atualizar a definição de repetível: `verdadeiro` ou `falso`
7. **Legível Publicamente** -- atualizar a definição de legível publicamente: `verdadeiro` ou `falso`
8. **Escrevível Publicamente** -- atualizar a definição de escrevível publicamente: `verdadeiro` ou `falso`
9. **Arquivada** -- definir para `verdadeiro` para arquivar o modelo
10. **Campos** -- um array JSON de definições de campos para substituir os campos existentes do modelo

## Casos de uso comuns

* Criar automaticamente e publicar entradas de conteúdo a partir de texto gerado por IA
* Atualizar em lote os estados das entradas de conteúdo com base nas condições do workflow
* Obter entradas por modelo para enriquecer ou reescrever conteúdo existente
* Criar pipelines de conteúdo que criam entradas em rascunho e publicam após revisão
* Criar novos modelos Builder.io programaticamente como parte de um workflow de configuração de site
* Listar entradas de um modelo para executar auditorias ou aplicar transformações em lote

{% hint style="info" %}
Nota: A integração com o Builder.io requer uma Chave de API Privada com acesso ao espaço de destino. Certifique-se de que a sua chave tem as permissões necessárias para as operações que os seus workflows 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/builder-io.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.
