> 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-bd0c2de47e75490999fcfd4e7a92fd92f81bdcb7%2FCleanShot%202025-03-20%20at%2006.27.24%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

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

## Autenticação

1. **Gere um Token de Acesso Pessoal a partir do Contentful:**
   * Inicie sessão na sua conta Contentful.
   * Navegue até às definições e, em seguida, clique em "CMA Tokens".
   * Carregue no botão "Criar acesso pessoal".
   * 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 guardar imediatamente de forma segura, pois não será novamente apresentado.
2. **Adicione o Token de Acesso Pessoal ao seu Espaço de Trabalho:**
   * Vá para <https://app.airops.com/account/integrations>
   * Encontre a secção da integração com 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 introduzir um opcional **ID do Espaço** para o guardar com a ligação.
   * Para uma autenticação com acesso total, clique **Testar ligação**, reveja os resultados e, em seguida, **Guardar integração**. Os testes incluem o ID do Espaço quando configurado. Consulte [Testar uma ligação](/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 fornece acesso total ao seu espaço 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 e autenticados.

## Funções e Seus Parâmetros

#### Criar Entrada

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

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

#### Criar entrada (JSON)

1. **ID do Espaço**: O ID do seu espaço 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": "O bacon é saudável?"
      }
   }
}
```

#### Listar Entradas

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

#### Obter Entrada

1. **ID do Espaço**: O ID do seu espaço Contentful. ex.: yadj1kx9rmg0
2. **Ambiente**: O nome do seu ambiente. Normalmente, é master
3. **ID da Entrada**: O ID ou slug da entrada que pretende obter
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 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!"
   }
}
```

#### Enviar imagem

1. **ID do Espaço**: O ID do seu espaço 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.
