> 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 do AirOps diretamente ao seu projeto Framer. Esta integração permite gerir coleções CMS, criar e atualizar itens de coleção e publicar o seu site programaticamente.

### Como Configurar a Etapa de Integração com o Framer

#### Autenticação

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

1. Aceda a ⚙ Configurações > Integrações
2. Encontre a secção Framer e clique em "Configurar"
3. Introduza o seu **URL do projeto** (por ex. `https://my-site.framer.app`)
4. Introduza o seu **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 com o Framer suporta as seguintes ações:

* **Listar coleções**: Obter todas as coleções CMS no seu projeto Framer
* **Obter Campos da Coleção**: Obter as definições dos campos para uma coleção específica
* **Listar itens da coleção**: Obter todos os itens de uma coleção
* **Criar ou atualizar item da coleção**: Criar um novo item da coleção ou atualizar um existente
* **Eliminar Itens da Coleção**: Remover um ou mais itens de uma coleção
* **Publicar Site**: Publicar o seu site Framer

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9bb12a5b84888b35a74c506045e5088ed8930e72%2Fframer-01-actions.png?alt=media" alt="Framer Integration step with the Action dropdown listing List Collections, Get Collection Fields, List Collection Items, Upsert Collection Item, Delete Collection Items, Publish Site"><figcaption><p>Escolha uma ação do Framer.</p></figcaption></figure>

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

**Listar coleções**

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

**Obter Campos da Coleção**

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

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

**Listar itens da coleção**

* **Coleção**: A coleção da qual listar os 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 ou atualizar item da coleção**

* **Coleção**: A coleção na qual criar ou atualizar um item (obrigatório)
* **Slug**: Identificador amigável para URL do item — tem de ser único dentro da coleção (obrigatório)
* **ID do item (Opcional)**: O ID de um item existente a atualizar. Se for 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 publicação.

### Casos de uso comuns

* Gerar conteúdo escrito por IA e enviá-lo diretamente para uma coleção CMS do Framer
* Manter um site Framer sincronizado com uma fonte de dados externa
* Automatizar atualizações de produtos ou portefólio ao criar/atualizar itens da coleção a partir de uma folha de cálculo ou base de dados
* Acionar a publicação de um site no final de um pipeline de conteúdo, depois de todas as atualizações estarem concluídas

### Tratamento de erros

Por predefinição, a etapa de Integração com o Framer terminará o fluxo de trabalho se falhar. Pode configurá-la para continuar selecionando "Continuar" em vez de "Terminar o 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.
