> 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 do Builder.io permite ligar os seus fluxos de trabalho da AirOps aos seus espaços Builder.io. Esta integração nativa disponibiliza capacidades abrangentes de gestão de entradas de conteúdo e de modelos diretamente a partir dos seus fluxos de trabalho. ## Visão geral O Builder.io é um CMS headless visual e um construtor de páginas que permite às equipas criar e gerir conteúdo estruturado para qualquer canal digital. Ao ligar o Builder.io à AirOps, pode automatizar a criação de conteúdo, a publicação e a gestão de modelos em todos os seus espaços Builder.io. ## Autenticação Antes de utilizar a integração do Builder.io nos seus fluxos de trabalho, deve primeiro ligar a sua conta Builder.io nas Definições da AirOps: 1. Navegue até **Definições > Integrações** 2. Encontre a secção Builder.io e clique em "Configurar" 3. Insira sua **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. Introduza opcionalmente a sua **Chave de API pública** — utilizada para ler entradas de conteúdo publicadas 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 fluxos de trabalho lerem conteúdo acessível publicamente. {% 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** -- obter uma única entrada de conteúdo pelo 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** -- obter um único modelo pelo 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 ## Parâmetros da Ação ### Criar conteúdo 1. **Nome do modelo** (obrigatório) -- o nome de API do modelo Builder.io para o qual criar a entrada (ex.: `blog-post`) 2. **Nome** (obrigatório) -- o título legível por humanos da entrada de conteúdo 3. **Dados** -- um objeto JSON de valores de campos personalizados (ex.: `{"title": "Olá", "body": "..."}`) 4. **Publicado** -- o estado de publicação da entrada: `rascunho`, `publicado`, ou `arquivado` ### 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 obter ### Listar conteúdo 1. **Nome do modelo** (obrigatório) -- o nome de API do modelo Builder.io 2. **Incluir não publicados** -- se incluir entradas de rascunho: `true` ou `false` (predefinição: `false`) 3. **Campos** -- caminhos de campos separados por vírgulas a incluir na resposta (ex.: `id,name,data.title`) 4. **Omitir** -- caminhos de campos separados por vírgulas a excluir da resposta (ex.: `data.blocks`) 5. **Ordenar** -- um objeto JSON que especifica os campos de ordenação e a direção, onde `1` é ascendente e `-1` é descendente (ex.: `{"data.publishedDate": -1}`) 6. **Limite** -- o número de entradas por página (predefinição: `30`, máx: `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 por humanos da entrada 4. **Dados** -- um objeto JSON dos 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 (ex.: `blog-post`) 2. **Tipo** (obrigatório) -- o tipo de modelo: `dados`, `page`, `componente`, `seção`, ou `símbolo` 3. **Texto de ajuda** -- uma descrição do modelo mostrada na interface do Builder.io 4. **Único** -- se apenas uma entrada pode existir para este modelo: `true` ou `false` 5. **Repetível** -- se são permitidas várias entradas: `true` ou `false` 6. **Legível publicamente** -- se as entradas podem ser lidas sem autenticação: `true` ou `false` 7. **Gravável publicamente** -- se as entradas podem ser escritas sem autenticação: `true` ou `false` 8. **Campos** -- uma matriz JSON de definições de campos, cada uma com um `nome` como no `tipo` (por ex. `[{"name": "title", "type": "string"}]`) ### Obter modelo 1. **Pesquisar Por** -- como identificar o modelo: `id` (predefinição) ou `nome` 2. **Valor de 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: `dados`, `page`, `componente`, `seção`, ou `símbolo` 4. **Texto de ajuda** -- a nova descrição do modelo 5. **Único** -- atualizar a definição singleton: `true` ou `false` 6. **Repetível** -- atualizar a definição repetível: `true` ou `false` 7. **Legível publicamente** -- atualizar a definição legível publicamente: `true` ou `false` 8. **Gravável publicamente** -- atualizar a definição gravável publicamente: `true` ou `false` 9. **Arquivada** -- definir para `true` para arquivar o modelo 10. **Campos** -- uma matriz JSON de definições de campos para substituir os campos existentes do modelo ## Casos de Utilização Comuns * Criar e publicar automaticamente 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 fluxo de trabalho * Obter entradas por modelo para enriquecer ou reescrever conteúdo existente * Construir 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 fluxo de trabalho de configuração de site * Listar entradas em todos os modelos para executar auditorias ou aplicar transformações em lote {% hint style="info" %} Nota: a integraçã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 fluxos de trabalho realizam. {% 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=&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.