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

# Contentful

Integre o seu Workflow com Contentful

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-696c2b7d3b7c70c7f042236dcf0a7d5e51d5bff2%2Fcontentful-step-01-actions.png?alt=media" alt="Contentful Integration step with the Action dropdown listing Create Entry, Create Entry (JSON), List Entries, Get Entry, and Update Entry (JSON)"><figcaption><p>Escolha uma ação do Contentful.</p></figcaption></figure>

A integração do Contentful permite criar, listar, obter e atualizar entradas.

## Autenticação

1. **Gere um Token de Acesso Pessoal no Contentful:**
   * Inicie sessão na sua conta Contentful.
   * Navegue até às definições e, em seguida, clique em "Tokens CMA".
   * Prima o botão "Create Personal Access To".
   * Forneça um nome descritivo para o token para identificar facilmente a sua utilização.
   * Depois de o token ser gerado, certifique-se de o copiar e armazenar em segurança imediatamente, pois não voltará a ser mostrado.
2. **Adicione o Token de Acesso Pessoal ao seu espaço de trabalho:**
   * Aceda a <https://app.airops.com/account/integrations>
   * Encontre a secção da integração do Contentful e clique no botão "Configurar".
   * Na janela modal que aparece, cole o Token de Acesso Pessoal copiado no campo designado.
   * Para uma autenticação com acesso total, também pode inserir um opcional **ID do Espaço** para o armazenar com a ligação.
   * Para uma autenticação com acesso total, clique em **Testar ligação**, reveja os resultados e depois **Guardar integração**. O teste inclui o ID do Espaço quando configurado. Veja [Testar uma ligação](https://docs.airops.com/docs/pt/o-seu-espaco-de-trabalho/settings/authentications.md#test-a-connection) para detalhes dos resultados.

**Nota de segurança:** Trate o seu Token de Acesso Pessoal como uma palavra-passe. Ele concede acesso total ao seu espaço do Contentful e não deve ser partilhado. Guarde-o em segurança e utilize-o apenas em ambientes do lado do servidor ou em ambientes seguros, autenticados.

## Funções e os seus parâmetros

#### Criar Entrada

1. **Espaço**: Selecione um espaço do Contentful.
2. **Ambiente**: Selecione um ambiente do Contentful
3. **Tipo de Conteúdo**: Selecione um tipo de conteúdo do Contentful
4. **Localidade (opcional)**: Localidade do conteúdo. Por predefinição, en-US

* Depois de selecionar o Tipo de Conteúdo, novos campos aparecerão de acordo com a opção selecionada.

#### Criar entrada (JSON)

1. **ID do Espaço**: O ID do seu espaço do Contentful. ex.: yadj1kx9rmg0
2. **Ambiente**: O nome do seu ambiente. Normalmente é master
3. **ID do Tipo de Conteúdo**
4. **JSON**: Um objeto JSON contendo os campos da sua entrada, exemplo:

```
{
   "fields": {
      "title": {
         "en-US": "Olá, Mundo!"
      },
      "body": {
         "en-US": "Bacon é saudável?"
      }
   }
}
```

#### Listar Entradas

1. **ID do Espaço**: O ID do seu espaço do Contentful. ex.: yadj1kx9rmg0
2. **Ambiente**: O nome do seu ambiente. Normalmente é master
3. **Limite (opcional)**: Quantas entradas obter.
4. **Saltar (opcional)**: Quantas entradas saltar primeiro ao recolher a resposta.

#### Obter Entrada

1. **ID do Espaço**: O ID do seu espaço do Contentful. ex.: yadj1kx9rmg0
2. **Ambiente**: O nome do seu ambiente. Normalmente é master
3. **ID da Entrada**: O ID ou o slug da entrada que pretende recuperar
4. **Localidade (opcional)**: Localidade do conteúdo. Por predefinição, en-US

#### Atualizar entrada (JSON)

1. **ID do Espaço**: O ID do seu espaço do Contentful. ex.: yadj1kx9rmg0
2. **Ambiente**: O nome do seu ambiente. Normalmente é master
3. **ID do Tipo de Conteúdo**: O ID do Tipo de Conteúdo que vai criar.
4. **ID da Entrada**: O ID da entrada que pretende atualizar
5. **JSON**: Um objeto JSON contendo os campos a atualizar, exemplo:

```
{
   "title": {
      "en-US": "Olá, Mundo!"
   },
   "body": {
      "en-US": "O bacon é saudável!"
   }
}
```

#### Carregar imagem

1. **ID do Espaço**: O ID do seu espaço do Contentful. ex.: yadj1kx9rmg0
2. **Ambiente**: O nome do seu ambiente. Normalmente é master
3. **URL da imagem**
4. **Título (opcional)**
5. **Descrição (opcional)**


---

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