> 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/acoes/grids/create-a-grid/import-from-contentful.md).

# Importar do Contentful

Pode criar uma Grid importando entradas diretamente do seu espaço do Contentful, permitindo-lhe trabalhar com o seu conteúdo existente no AirOps. Se ainda não tiver ligado o seu espaço do Contentful ao seu workspace do AirOps, ser-lhe-á pedido que o faça.

### Como Importar Dados do Contentful

1. Clique no botão "+" na sua página Grid
2. Selecione **Contentful** no menu suspenso de opções de importação
3. Ligue-se ao seu espaço do Contentful:
   * Selecione uma autenticação existente do Contentful no menu suspenso ou configure uma nova introduzindo os seus:
     * **ID do Espaço**: Encontrado no seu painel do Contentful em Definições > Definições gerais
     * **Token CDA**: Token da API de Entrega de Conteúdo para aceder a conteúdo publicado
     * **Token CPA**: Token da API de Pré-visualização de Conteúdo para aceder a conteúdo em rascunho
   * Clique em **Continuar**
4. Selecione o tipo de conteúdo a importar:
   * Escolha o tipo de conteúdo do Contentful (por exemplo, "Publicação de blogue", "Página") no menu suspenso
   * Clique em **Continuar**
5. Selecione quais colunas de dados importar:
   * Marque as caixas junto aos campos que pretende incluir
   * Cada campo mostrará o seu tipo de dados e uma pré-visualização de dados de exemplo
   * Nota: Há um limite máximo de 100 colunas
6. Clique em **Continuar** para importar os seus dados para a Grid

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9a7c8282eea9d29f94940c96d8bee1bdfafdc200%2Fgrid-import-contentful-01-select-fields.png?alt=media" alt="Import from Contentful field selection with data types and sample values for the Blog Post content type"><figcaption><p>Escolha os campos do Contentful a importar.</p></figcaption></figure>

### O que é importado

Assim que a importação estiver concluída, as seguintes colunas são criadas automaticamente no seu Grid:

* **Importação do Contentful**: Mostra o estado da importação para cada linha
* **ID da entrada do Contentful**: Armazena o identificador único da entrada do Contentful (sys.id) para cada entrada importada
* **Criado em**: A data de criação da entrada no Contentful (sys.createdAt)
* **Atualizado em**: A data da última atualização da entrada no Contentful (sys.updatedAt)
* **Primeira publicação em**: A data em que a entrada foi publicada pela primeira vez no Contentful (sys.firstPublishedAt)
* **Estado do Contentful**: Uma coluna de seleção única que indica se a entrada está **Publicado** ou **Rascunho**
* **Os campos selecionados**: Cada campo que escolheu durante a configuração é mapeado para o tipo de coluna do Grid apropriado

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9d693eae625b98b6e6455716e182a2ed653edbbc%2Fgrid-import-contentful-02-imported-grid.png?alt=media" alt="Grid imported from Contentful with entry ID, dates, and Published or Draft status columns"><figcaption><p>Cada importação adiciona colunas de estado, ID, data e estado de publicação.</p></figcaption></figure>

### Mapeamento de tipos de campos

Os tipos de campos do Contentful são automaticamente mapeados para os tipos de coluna da Grid que melhor correspondem:

| Tipo de campo do Contentful | Tipo de coluna do Grid |
| --------------------------- | ---------------------- |
| Símbolo (texto curto)       | Texto                  |
| Texto (texto longo)         | Texto                  |
| Inteiro                     | Número                 |
| Número                      | Número                 |
| Data                        | Data e hora            |
| Booleano                    | Texto                  |
| Texto enriquecido           | HTML                   |
| Localização                 | JSON                   |
| Ligação                     | JSON                   |
| Matriz                      | JSON                   |
| Objeto                      | JSON                   |

### Entradas em rascunho e publicadas

O Contentful mantém estados separados de rascunho e publicado para as entradas. O AirOps usa a API de Pré-visualização de Conteúdo para obter todas as entradas (incluindo rascunhos) e reflete o estado de publicação de cada entrada na **Estado do Contentful** coluna com base em ter sido publicada.

### Conteúdo localizado

O Contentful suporta campos de conteúdo localizado. Durante a importação, o AirOps extrai o valor da localização predefinida do seu espaço. Se os seus campos contiverem conteúdo localizado, será importado o valor da localização predefinida.

### Executar novamente as importações

Pode voltar a executar uma importação a qualquer momento para sincronizar os dados mais recentes do Contentful. As linhas existentes são atualizadas com base no ID da entrada do Contentful, e as novas entradas são adicionadas como novas linhas. As entradas que já não existirem no Contentful terão as respetivas células limpas.

Depois de importado, o seu conteúdo do Contentful aparecerá na sua Grid, pronto para ser melhorado com fluxos de trabalho do AirOps para otimização de conteúdo, melhoria de SEO, reescritas potenciadas por IA e muito mais.


---

# 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/acoes/grids/create-a-grid/import-from-contentful.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.
