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

# Framer

Integre o seu Workflow com Framer

A etapa de Integração com o Framer permite ligar os seus fluxos de trabalho da AirOps diretamente ao seu projeto Framer. Esta integração permite gerir coleções do CMS, criar e atualizar itens de coleções e publicar o seu site de forma programática.

### Como configurar a etapa de Integração com o Framer

#### Autenticação

Antes de utilizar a integração do Framer nos seus fluxos de trabalho, deve primeiro ligar o seu projeto Framer nas Definições da AirOps:

1. Navegue para ⚙ Definições > Integrações
2. Encontre a secção Framer e clique em "Configurar"
3. Insira sua **URL do projeto** (por ex. `https://my-site.framer.app`)
4. Insira sua **Token de acesso pessoal** do Framer

Para gerar um Token de acesso pessoal no Framer, aceda às definições da sua conta Framer e crie um novo token com acesso ao seu projeto.

#### Tipos de ação

A integração do Framer suporta as seguintes ações:

* **Listar Coleções**: Obtenha todas as coleções do CMS no seu projeto Framer
* **Obter campos da coleção**: Obtenha as definições dos campos de uma coleção específica
* **Listar Itens da Coleção**: Obtenha todos os itens de uma coleção
* **Criar/atualizar item da coleção**: Crie um novo item de coleção ou atualize um existente
* **Eliminar itens da coleção**: Remova um ou mais itens de uma coleção
* **Publicar site**: Publique o seu site Framer

#### Parâmetros específicos da ação

**Listar Coleções**

Não são necessários parâmetros adicionais. Devolve todas as coleções do projeto com os respetivos IDs, nomes e tipo de gestão.

**Obter campos da coleção**

* **Coleção**: A coleção da qual obter os campos (obrigatório)

Devolve todas as definições de campos da coleção, incluindo IDs dos campos, nomes e tipos.

**Listar Itens da Coleção**

* **Coleção**: A coleção da qual listar itens (obrigatório)

Devolve todos os itens da coleção com os respetivos IDs, slugs e estado de rascunho. Nota: os dados dos campos não estão incluídos na resposta.

**Criar/atualizar item da coleção**

* **Coleção**: A coleção na qual criar ou atualizar um item (obrigatório)
* **Slug**: Identificador legível por URL para o item — deve ser único dentro da coleção (obrigatório)
* **ID do item (opcional)**: O ID de um item existente a atualizar. Se omitido, é criado um novo item.
* **Dados dos campos (opcional)**: Um objeto JSON que mapeia IDs de campos para valores tipados. Exemplo:

  ```json
  {
    "fieldId": { "type": "string", "value": "Olá Mundo" }
  }
  ```
* **Estado (opcional)**: Defina o item como `Publicado` ou `Rascunho`. Os itens em rascunho são excluídos do conteúdo publicado.

**Eliminar itens da coleção**

* **Coleção**: A coleção da qual eliminar itens (obrigatório)
* **IDs dos itens**: Lista de IDs de itens separados por vírgulas a eliminar (obrigatório). Exemplo: `item-1, item-2, item-3`

**Publicar site**

Não são necessários parâmetros adicionais. Publica todo o site Framer e devolve informações de implementação.

### Casos de Utilização Comuns

* Gerar conteúdo escrito por IA e publicá-lo diretamente numa coleção do CMS do Framer
* Manter um site Framer sincronizado com uma fonte de dados externa
* Automatizar atualizações de produtos ou portefólio através da criação/atualização de itens de coleção a partir de uma folha de cálculo ou base de dados
* Acionar a publicação do site no final de um pipeline de conteúdo, após a conclusão de todas as atualizações

### Tratamento de erros

Por predefinição, a etapa Integração com o Framer termina o fluxo de trabalho se falhar. Pode configurá-la para continuar selecionando "Continuar" em vez de "Terminar fluxo de trabalho" nas definições da etapa.


---

# 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/framer.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.