Techsy
Contacto
Começar
Voltar ao blog
guides

Guia do Contentful CMS: Funcionalidades, Preços, API GraphQL e Exemplos de Código [2026]

Escrito por Mert Batur Gürbüz
Apr 6, 2026
22 min de leitura
Índice
Guia do Contentful CMS: Funcionalidades, Preços, API GraphQL e Exemplos de Código [2026]

Guia do Contentful CMS: Funcionalidades, Preços, API GraphQL e Exemplos de Código [2026]

O Contentful é um headless CMS API-first que armazena o seu conteúdo num hub central e o entrega através de APIs REST e GraphQL a qualquer frontend — web, mobile, IoT, sinalização digital, seja o que for que esteja a construir. Este guia cobre tudo o que a concorrência ignora: exemplos de código reais, números de preços reais e limitações honestas.

Usamos o Sanity (um concorrente direto do Contentful) em produção em quatro websites e dez idiomas, por isso abordamos isto da perspetiva de quem o usa na prática, não de um discurso de vendas.

Resumo Rápido

DetalheInformação
TipoHeadless CMS (API-first)
Fundação2013, Berlim
Ideal ParaEquipas empresariais, conteúdo multicanal, projetos com forte localização
Não Ideal ParaProgramadores a solo com orçamentos apertados, blogs simples, equipas que precisam de edição visual de origem
Nível GratuitoSim -- 10 utilizadores, 100K chamadas de API/mês, 1 espaço
Planos PagosDesde $300/mês (Lite) até Enterprise personalizado
APIsREST (CDA, CMA, CPA) + GraphQL
Modelação de ConteúdoEstruturada: tipos de conteúdo, campos, referências, validações
Funcionalidades de IAAI Actions, Contentful Studio, personalização Ninetailed
LocalizaçãoSuporte nativo de idiomas, sem gestão de tradução integrada
Open SourceNão
Principais ConcorrentesSanity, Strapi, Storyblok, Payload, Hygraph

O Que É o Contentful?

O Contentful é um headless CMS cloud-native e API-first, ou, como a empresa agora lhe chama, uma "plataforma de conteúdo composável". Ao contrário de sistemas tradicionais como o WordPress, que juntam a gestão de conteúdo a um frontend, o Contentful armazena conteúdo estruturado de forma centralizada e entrega-o através de APIs a qualquer canal que precise.

O conceito-chave é a arquitetura desacoplada. O seu conteúdo vive na cloud do Contentful. O seu frontend — seja um site Next.js, uma app React Native ou um ecrã inteligente — obtém conteúdo através das APIs do Contentful em tempo de compilação ou em tempo de execução. O conteúdo não sabe nem quer saber onde vai parar.

Fundado em Berlim em 2013, o Contentful tornou-se um dos maiores fornecedores de headless CMS do mercado. Marcas como Spotify, Vodafone, Chanel e Atlassian gerem as suas operações de conteúdo nesta plataforma. Não é open source e não existe opção de alojamento próprio — é apenas SaaS, o que importa se tiver restrições de conformidade quanto à residência de dados.

De acordo com a documentação oficial do Contentful, a plataforma posiciona-se como infraestrutura para conteúdo — um hub de conteúdo que fica entre a sua equipa editorial e as suas experiências digitais.

Como Funciona o Contentful?

O Contentful segue uma arquitetura de três camadas: define o seu Modelo de Conteúdo (o esquema), cria Conteúdo (as entradas) e entrega-o através de APIs. O conteúdo é agnóstico em relação ao canal — o mesmo artigo de blog pode alimentar o seu website, a sua app móvel e a sua newsletter de email sem qualquer duplicação.

Tudo flui através de APIs. Não há renderização do lado do servidor integrada, nem templates, nem camada de temas. Constrói o frontend como quiser, e o Contentful trata do armazenamento e entrega do conteúdo.

As Três APIs

O Contentful oferece três APIs distintas, cada uma com o seu propósito e autenticação:

  • Content Delivery API (CDA): Acesso apenas de leitura a conteúdo publicado. Suportada pela CDN da Fastly, pelo que os pedidos em cache são rápidos e ilimitados. Os pedidos sem cache estão limitados a 55 por segundo.
  • Content Management API (CMA): Acesso de leitura e escrita para criar e atualizar conteúdo programaticamente. Limitada a 10 pedidos por segundo. É o que usaria para migrações, importações em massa ou pipelines de CI/CD.
  • Content Preview API (CPA): Igual à CDA, mas serve conteúdo em rascunho. Perfeita para criar modos de pré-visualização no seu frontend — os editores podem ver alterações não publicadas antes de publicarem.

As três suportam tanto REST como GraphQL. A autenticação é feita através de tokens Bearer, com tokens separados para entrega e gestão.

Ambientes e Espaços

Pense nos Espaços como projetos e nos Ambientes como branches de git para o seu conteúdo. Pode ter um ambiente master para produção e um ambiente staging onde os editores podem trabalhar sem afetar o conteúdo em produção.

Os ambientes suportam aliasing — pode apontar o alias master para um novo ambiente para promoções de conteúdo sem tempo de inatividade. Se está a escolher uma framework de frontend para combinar com o Contentful, este modelo de ambientes funciona bem com deploys de pré-visualização em plataformas como Vercel ou Netlify.

Os webhooks permitem desencadear builds, sincronizar com sistemas externos ou iniciar fluxos de trabalho sempre que o conteúdo muda. A maioria das equipas liga-os ao seu pipeline de CI/CD para reconstruir o site estático a cada evento de publicação.

Modelação de Conteúdo no Contentful

A modelação de conteúdo é onde define a estrutura do seu conteúdo — o "esquema" que determina que campos existem, que tipos de dados contêm e como os tipos de conteúdo se relacionam entre si. Na nossa experiência, é aqui que o Contentful realmente brilha face a opções de CMS mais simples.

Está essencialmente a desenhar um esquema de conteúdo, semelhante a tabelas de base de dados, mas mais flexível. Um tipo de conteúdo "Artigo de Blog" pode ter um título (texto curto), um corpo (texto rico), um autor (referência a um tipo de conteúdo Autor) e etiquetas (array de strings). Cada entrada que criar segue esta estrutura.

Tipos de Campo e Validações

O Contentful oferece uma gama sólida de tipos de campo:

  • Texto curto (Symbol): Títulos, slugs, etiquetas, até 256 caracteres
  • Texto longo (Text): Markdown ou texto simples, sem limite de caracteres
  • Texto rico: Baseado em JSON (não HTML), dá-lhe controlo total sobre a renderização
  • Número: Inteiro ou decimal
  • Data/Hora: Formato ISO 8601
  • Booleano: Interruptores de verdadeiro/falso
  • Media (Asset): Imagens, vídeos, documentos, armazenados no pipeline de assets do Contentful
  • Referência (Link): Liga entradas a outras entradas ou assets
  • Objeto JSON: Dados estruturados de forma livre
  • Localização: Pares de latitude/longitude

Cada campo suporta validações: obrigatório, único, padrões de regex, limites de tamanho e mensagens de validação personalizadas. Também pode definir opções de aparência que controlam como o campo é apresentado na interface do editor.

Referências e Entradas Ligadas

As referências são a forma de ligar tipos de conteúdo. Uma referência de "Autor" num Artigo de Blog liga a uma entrada de Autor. Um campo "Artigos Relacionados" pode referenciar várias entradas de Artigo de Blog. Isto cria um grafo de conteúdo — entradas ligadas a entradas, consultáveis numa única chamada de API.

Eis o aspeto real de uma definição de tipo de conteúdo de Artigo de Blog quando a cria através da Content Management API:

json
{
  "name": "Blog Post",
  "fields": [
    { "id": "title", "type": "Symbol", "required": true },
    { "id": "slug", "type": "Symbol", "validations": [{ "unique": true }] },
    { "id": "body", "type": "RichText" },
    { "id": "author", "type": "Link", "linkType": "Entry" },
    { "id": "publishDate", "type": "Date" },
    { "id": "tags", "type": "Array", "items": { "type": "Symbol" } }
  ]
}

Este é o tipo de coisa que guardaria em controlo de versão e aplicaria através de scripts de migração. Zero concorrentes mostram isto nos seus guias do Contentful — falam sobre modelação de conteúdo em abstrato, sem mostrar o aspeto real em código.

Consultar Conteúdo: APIs REST e GraphQL

O Contentful fornece APIs REST e GraphQL para obter conteúdo. O REST é direto para consultas simples. O GraphQL é melhor quando precisa de dados aninhados, vários tipos de conteúdo num só pedido, ou quer evitar over-fetching. Ambos usam os mesmos tokens de autenticação.

O endpoint GraphQL é gerado automaticamente a partir do seu modelo de conteúdo. Cada tipo de conteúdo que criar torna-se um tipo consultável no esquema, com filtragem, ordenação e paginação integradas. O endpoint fica em:

text
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}

De acordo com a documentação de GraphQL do Contentful, o esquema atualiza-se automaticamente sempre que modifica os seus tipos de conteúdo — sem necessidade de gestão manual do esquema.

Exemplos de Consultas GraphQL

Eis uma consulta básica para obter os seus dez artigos de blog mais recentes com os respetivos autores:

graphql
query {
  blogPostCollection(limit: 10, order: publishDate_DESC) {
    items {
      title
      slug
      publishDate
      author {
        name
      }
    }
  }
}

Precisa de filtrar por etiqueta e obter conteúdo em alemão? Adicione uma cláusula where e um parâmetro locale:

graphql
query {
  blogPostCollection(
    where: { tags_contains_some: ["javascript"] }
    locale: "de"
  ) {
    items {
      title
      body {
        json
      }
    }
  }
}

Uma coisa a ter em atenção: as consultas GraphQL têm limites de complexidade. Consultas profundamente aninhadas com várias referências ligadas podem atingir o teto. O Contentful calcula a complexidade com base no número de nós e na profundidade da sua consulta. Se estiver a obter artigos de blog com autores, categorias, artigos relacionados e o autor de cada artigo relacionado, isso acumula-se depressa.

Noções Básicas da API REST

A API REST é mais simples, mas requer mais pedidos para dados aninhados. Uma consulta básica de artigos de blog acede a https://cdn.contentful.com/spaces/{SPACE_ID}/entries?content_type=blogPost. Recebe JSON com um array items plano e um objeto includes separado para as entradas ligadas, que terá de resolver do lado do cliente.

Se trabalha com TypeScript, o SDK contentful.js do Contentful trata da resolução de links e da geração de tipos automaticamente. Para chamadas fetch simples, eis o JavaScript mínimo para consultar a API GraphQL:

javascript
const response = await fetch(
  `https://graphql.contentful.com/content/v1/spaces/${SPACE_ID}`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${CDA_TOKEN}`,
    },
    body: JSON.stringify({ query }),
  }
);
const { data } = await response.json();

E é isto. Sem necessidade de SDK, sem etapa de compilação, sem dependências. Isto funciona em Node.js, Deno, Cloudflare Workers, no browser — em qualquer sítio onde possa fazer pedidos HTTP.

Funcionalidades-Chave Que Vale a Pena Conhecer

O Contentful vem com um amplo conjunto de funcionalidades, mas nem todas têm a mesma importância. Eis as que realmente afetam a sua experiência do dia a dia e as decisões de arquitetura.

Localização (Pontos Fortes e Lacunas)

O modelo de localização do Contentful é sólido ao nível da infraestrutura. Define os idiomas do seu espaço (até mais de 100 nos planos Enterprise) e cada campo pode armazenar valores por idioma. As substituições de idioma ao nível do campo significam que o seu título em alemão pode diferir do inglês, partilhando a mesma imagem principal.

A lacuna está na gestão de tradução. O Contentful dá-lhe os campos para armazenar traduções, mas nenhum fluxo de trabalho para as produzir. Não há memória de tradução, nem glossário, nem sistema de atribuição, nem acompanhamento de progresso. Precisa de uma integração de terceiros — Phrase, Smartcat ou Lokalise — para tratar do processo de tradução em si. Para equipas que gerem mais de 10 idiomas (nós gerimos 10 nos nossos sites), esta lacuna torna-se cara depressa.

Ambientes e Branching

Os ambientes funcionam como branches de git para o seu modelo de conteúdo e entradas. Crie um ambiente staging, faça alterações ao esquema, teste com conteúdo e depois promova para master quando estiver pronto. Os aliases permitem trocar o ambiente para que o master aponta sem alterar os URLs da API.

Isto é genuinamente útil para migrações de esquema. Pode testar um novo tipo de conteúdo num ambiente isolado, verificar que o frontend o trata corretamente e depois promover — tudo sem tocar no conteúdo de produção. A maioria das equipas que vimos usa dois a três ambientes: produção, staging e, ocasionalmente, um feature branch para grandes migrações.

Outras funcionalidades que vale a pena mencionar:

  • Funções e permissões: Controlo de acesso granular, restringir editores a tipos de conteúdo específicos, bloquear o acesso de publicação para funções juniores, funções personalizadas nos planos Enterprise, SSO
  • Webhooks: Desencadeie builds, notificações do Slack ou fluxos de trabalho externos em qualquer evento de conteúdo
  • Rich Text: Baseado em JSON, dá controlo total de renderização, mas exige renderizadores personalizados para cada framework de frontend
  • App Framework: Marketplace com extensões para editores de campo personalizados, widgets de barra lateral e integrações
  • Image API: Redimensionamento, recorte, conversão de formato (WebP, AVIF) e recorte por ponto focal em tempo real, sem necessidade de uma CDN de imagens separada

Novidades do Contentful para 2026

O Contentful lançou atualizações significativas ao longo de 2025 e em 2026, e zero guias da concorrência cobrem qualquer uma delas. Se está a avaliar o Contentful com base em informação de 2023 ou 2024, está a trabalhar com uma visão incompleta.

AI Actions e Automatização de Conteúdo

O Contentful lançou os AI Actions — fluxos de trabalho de conteúdo automatizados, alimentados por modelos de linguagem de grande escala, diretamente dentro do editor. Tratam de rascunhos de tradução, geração de metadados de SEO, escrita de texto alternativo, ajustes de tom e resumo de conteúdo. Acede-lhes a partir da barra lateral do editor e operam sobre a entrada que está a editar no momento.

De acordo com a cobertura da Diginomica, os AI Actions fazem parte da investida mais ampla do Contentful para se posicionar como uma plataforma de experiência digital (DXP) completa, não apenas um headless CMS. A funcionalidade é genuinamente útil para automatizar tarefas editoriais repetitivas, embora o resultado da tradução ainda precise de revisão humana — é um primeiro rascunho, não um produto acabado.

Contentful Studio (Construtor Visual)

O Contentful Studio chegou a GA na primavera de 2024 e amadureceu significativamente ao longo de 2025. É um construtor visual de páginas que permite a não-programadores compor páginas com componentes de arrastar e largar e pré-visualização em direto. Se ouviu a crítica de que "o Contentful não tem edição visual", o Studio é a resposta — embora com ressalvas.

O Studio requer integração de frontend (os seus componentes precisam de estar registados no SDK do Studio) e é um complemento pago, não incluído nos planos base. Para equipas que têm pedido construção de páginas ao estilo do WordPress em cima do modelo de conteúdo estruturado do Contentful, é agora uma opção real. O Storyblok ainda tem a vantagem em fluxos de trabalho orientados ao visual, mas a diferença está a diminuir.

Personalização com o Ninetailed

O Contentful adquiriu o Ninetailed em 2024 e mudou-lhe a marca para Contentful Personalization. Como o CMS Critic reportou, isto dá-lhe testes A/B nativos, segmentação de audiência e sugestões de variantes orientadas por IA, tudo acessível a partir de um separador de Otimização no editor.

Isto é notável porque a personalização exigia historicamente um fornecedor separado (Optimizely, Dynamic Yield, etc.). Tê-la integrada no CMS reduz a complexidade de integração. O senão: o Ninetailed é um produto separado com o seu próprio preço. Não é "grátis com o Contentful".

Preços do Contentful: Quanto Custa Realmente

O Contentful oferece quatro níveis, mas a maioria dos guias da concorrência apenas os nomeia sem apresentar números reais. Eis o que pode esperar em abril de 2026, com base na página de preços do Contentful:

PlanoPreçoUtilizadoresChamadas de API/mêsLargura de Banda CDNEspaços
Gratuito (Community)$010100K50 GB1 Starter
Lite$300/mês201M100 GBVários
PremiumPersonalizado (~$2K+/mês)IlimitadoIlimitadoPersonalizadoPersonalizado
EnterprisePersonalizado (gama média de 5 a 6 dígitos/ano)IlimitadoIlimitadoPersonalizadoPersonalizado

"Contentful Monthly Cost by Tier"

Tabela de dados
"Contentful Monthly Cost by Tier"
"Plan""Monthly Cost"
"Free"0
"Lite"300
"Premium"2000
"Enterprise"5000

O nível gratuito é generoso para prototipagem e aprendizagem. Tem 10 utilizadores, 100K chamadas de API e largura de banda suficiente para construir um projeto real. Mas os custos escalam rapidamente assim que o ultrapassa.

Custos ocultos a ter em conta no orçamento:

  • Custos de excesso de API no Lite: Ultrapasse 1M de chamadas/mês e verá linhas de excesso na sua fatura
  • Custos de idiomas: Cada idioma adicional conta para os limites do seu espaço -- 50 idiomas ao nível do campo acumulam-se
  • Contentful Studio: O construtor visual é um complemento pago, não incluído no Lite nem mesmo em alguns planos Premium
  • Personalização Ninetailed: Produto separado, contrato separado, preço separado
  • Serviços profissionais: Assistência de migração, onboarding e formação são faturados separadamente
  • Renderizadores de Rich Text: Não é um custo direto, mas o tempo de desenvolvimento para criar renderizadores personalizados para a sua framework é real

A nossa opinião honesta: O nível gratuito do Contentful é sólido para avaliação e pequenos projetos. Mas se o orçamento é uma preocupação principal, alternativas de CMS open source como o Strapi ou o Payload eliminam totalmente os custos de licenciamento — só paga o alojamento.

Contentful vs Sanity vs Strapi: Como Se Comparam

Estas são as três opções de headless CMS que surgem em quase todas as avaliações. Construímos sistemas em produção no Sanity, por isso conhecemos os seus pontos fortes e fracos em primeira mão. Eis uma comparação honesta:

FuncionalidadeContentfulSanityStrapi
TipoSaaS (código fechado)SaaS + alojamento próprioOpen source (alojamento próprio ou Cloud)
Nível Gratuito10 utilizadores, 100K chamadas100K chamadas de API, 3 utilizadoresIlimitado (alojamento próprio)
GraphQLNativoPlugin (GROQ é o principal)Nativo
Modelação de ConteúdoGUI + APICódigo (schema-as-code)GUI + código
Colaboração em Tempo RealSimSim (Presence API)Limitado
Edição VisualComplemento StudioVisual Editing (nativo)Não
LocalizaçãoIdiomas nativosPlugin/personalizadoPlugin (i18n)
PreçosDesde $300/mêsDesde $0 (gratuito generoso)Gratuito (alojamento próprio)
Ideal ParaEmpresarial, multicanalDeveloper-first, esquemas flexíveisOrçamento limitado, alojamento próprio

O Contentful ganha para equipas empresariais com grandes operações de conteúdo e necessidades rigorosas de governação. O sistema maduro de funções, SSO, registos de auditoria e SLA de 99,99% nos planos Enterprise são difíceis de igualar.

O Sanity ganha na experiência de desenvolvimento e na flexibilidade de esquema. Se prefere schema-as-code, quer o poder de consulta do GROQ e valoriza as funcionalidades de colaboração em tempo real, o Sanity é a melhor escolha. Leia o nosso guia completo do Sanity CMS para uma análise aprofundada.

O Strapi ganha no custo. É gratuito em alojamento próprio, sem limites de chamadas de API. Se tem capacidade de DevOps para gerir a sua própria infraestrutura e não precisa de suporte empresarial, o Strapi dá-lhe o máximo de CMS por cada dólar.

Para uma comparação mais ampla que inclui Storyblok, Payload e Hygraph, veja a nossa comparação completa de headless CMS.

Limitações Que Deve Conhecer Antes de Escolher o Contentful

Todos os CMS têm contrapartidas. Eis as do Contentful, com números concretos, não generalidades vagas. Deparámo-nos com várias destas ao avaliar o Contentful para o nosso próprio pipeline de conteúdo.

Os limites de taxa são reais. A CDA permite 55 pedidos sem cache por segundo. As respostas em cache da CDN são ilimitadas, mas se a sua app contornar a cache (renderização do lado do servidor em cada pedido, por exemplo), atinge os limites depressa. A CMA é ainda mais apertada, com 10 pedidos por segundo, relevante para scripts de migração e importações em massa.

Sem edição visual integrada (sem pagar mais). O Contentful Studio existe, mas é um complemento pago que requer integração de frontend. Se a sua equipa espera construção de páginas ao estilo do WordPress no produto base, prepare-se para essa conversa. O Storyblok inclui edição visual em todos os níveis.

Sem gestão de tradução. Tem campos de idioma, e é isso. Sem fluxos de trabalho de tradução, sem sistema de atribuição, sem memória de tradução, sem acompanhamento de progresso. Para uma plataforma que vende a localização como funcionalidade principal, a experiência real de tradução depende inteiramente de ferramentas de terceiros como Phrase, Smartcat ou Lokalise.

Dependência de programadores para tudo o que é frontend. Os editores de conteúdo podem criar e gerir entradas. Não podem alterar layouts de página, adicionar novas secções, modificar a navegação ou atualizar o frontend de forma alguma sem um programador. Isto é inerente à arquitetura headless, mas é agravado no Contentful porque o produto base não inclui um construtor de páginas.

Os preços tornam-se imprevisíveis em escala. Excessos de chamadas de API, limites baseados em idiomas, custos de complementos para o Studio e Personalização e serviços profissionais criam um modelo de preços difícil de prever. Várias equipas com quem falámos ficaram surpreendidas com a primeira fatura após o nível gratuito.

Complexidade do Rich Text. O Rich Text do Contentful é baseado em JSON, não em HTML. Cada framework de frontend precisa de um renderizador personalizado — @contentful/rich-text-react-renderer para React, rich-text-html-renderer para JavaScript puro, etc. Dá-lhe controlo total sobre a renderização, mas é significativamente mais trabalho de desenvolvimento do que concorrentes baseados em HTML.

Dependência do fornecedor. Código fechado, apenas SaaS, sem opção de alojamento próprio. O seu conteúdo é exportável via API, mas o seu modelo de conteúdo, fluxos de trabalho e integrações são específicos do Contentful. Se os preços mudarem ou funcionalidades forem descontinuadas, as suas opções são limitadas.

Quem Deve (e Não Deve) Usar o Contentful

O Contentful é uma plataforma sólida, mas não é a escolha certa para todos os projetos. Eis uma estrutura de decisão para o ajudar a decidir.

Use o Contentful se:

  • É uma equipa empresarial que gere conteúdo em vários canais (web, mobile, IoT, sinalização digital)
  • Precisa de localização nativa com mais de 50 idiomas e substituições ao nível do campo
  • Quer uma plataforma madura, com provas dadas, com suporte dedicado e SLA de 99,99%
  • A sua equipa inclui programadores à vontade com arquitetura API-first
  • Precisa de funções granulares, permissões, registos de auditoria e SSO

Evite o Contentful se:

  • É um programador a solo ou uma equipa pequena com restrições de orçamento — veja o Strapi ou o Payload
  • Quer um construtor visual de páginas incluído no produto base — veja o Storyblok
  • Prefere definições de esquema code-first e máxima flexibilidade — veja o Sanity
  • Precisa de um CMS simples para blog — o WordPress ou o Ghost são mais baratos e rápidos de configurar
  • Quer alojamento próprio por motivos de conformidade — veja o Strapi ou o Payload
Se precisa de...EscolhaPorque
Governação de nível empresarialContentfulFunções maduras, SSO, registos de auditoria, SLA de 99,99%
Máxima flexibilidade de desenvolvimentoSanitySchema-as-code, GROQ, texto portátil
Custo de licenciamento zeroStrapi ou PayloadOpen source, alojamento próprio possível
Edição visual de origemStoryblokO editor visual é o produto principal
Blog simplesWordPress ou GhostTempo mais rápido até à publicação

Para uma análise mais aprofundada de todas estas alternativas, consulte a nossa comparação completa de headless CMS.

Começar: Os Seus Primeiros 15 Minutos com o Contentful

Eis um guia prático — não teoria, mas os passos exatos para ir do zero até consultar conteúdo via GraphQL em cerca de 15 minutos.

Passo 1: Registe-se. Aceda a contentful.com e crie uma conta gratuita. Não é necessário cartão de crédito.

Passo 2: Crie um Space. Um Space é o contentor do seu projeto. O nível gratuito dá-lhe um Starter Space. Dê-lhe um nome descritivo.

Passo 3: Defina um Tipo de Conteúdo. Aceda a Content Model, clique em "Add content type" e crie um tipo "Article". Adicione campos: Title (texto curto, obrigatório), Slug (texto curto, validação de unicidade), Body (texto rico), Cover Image (media) e Published Date (data e hora).

Passo 4: Crie uma Entrada. Aceda a Content, clique em "Add Article" e preencha os campos. Clique em Publish.

Passo 5: Obtenha as suas chaves de API. Aceda a Settings -> API Keys. Crie uma nova chave de API. Receberá um Space ID, um token da Content Delivery API e um token da Content Preview API. Guarde-os.

Passo 6: Consulte via GraphQL Playground. Abra este URL no seu browser (substitua pelas suas credenciais):

text
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}/explore?access_token={CDA_TOKEN}

Passo 7: Obtenha a partir da sua app. Use o exemplo de fetch em JavaScript da secção de APIs acima, substitua o seu Space ID e token da CDA, e estará a obter conteúdo em direto.

Dica profissional: O URL do GraphQL Playground não é óbvio na interface do Contentful. Pode encontrá-lo em Settings -> API Keys -> GraphQL Playground URL, ou construí-lo manualmente usando o modelo acima. Guarde-o nos favoritos — vai usá-lo constantemente durante o desenvolvimento.

Perguntas Frequentes

O que é o Contentful CMS e como funciona?

O Contentful é um headless CMS API-first que armazena conteúdo estruturado num hub na cloud e o entrega via APIs REST e GraphQL. Ao contrário do WordPress, não tem frontend — constrói o seu próprio usando qualquer framework. Os editores de conteúdo gerem as entradas através da app web do Contentful, e os programadores obtêm esse conteúdo através das APIs.

O Contentful é gratuito?

Sim, o Contentful oferece um nível Community gratuito que inclui 10 utilizadores, 100K chamadas de API por mês, 50 GB de largura de banda CDN e um Starter Space. É suficiente para prototipagem e pequenos projetos. Os planos pagos começam em $300/mês para o nível Lite, com os níveis Premium e Enterprise com preços por orçamento personalizado.

O que é a modelação de conteúdo no Contentful?

A modelação de conteúdo significa definir tipos de conteúdo estruturados com campos, validações e referências — como desenhar um esquema de base de dados, mas para conteúdo. Cria tipos como "Artigo de Blog" ou "Produto" com campos específicos (título, corpo, imagem, categoria), e cada entrada segue essa estrutura. É a base do Contentful.

Como se compara o Contentful ao WordPress?

O Contentful é headless (apenas API, sem frontend integrado), enquanto o WordPress junta a gestão de conteúdo com renderização baseada em temas. O Contentful destaca-se na entrega multicanal — o mesmo conteúdo pode servir web, mobile e IoT. O WordPress destaca-se na simplicidade — tem um site a funcionar em minutos sem precisar de programador.

O Contentful é adequado para uso empresarial?

Sim, o Contentful é uma das plataformas de headless CMS mais adotadas por empresas. Os planos Enterprise incluem SSO, acesso granular baseado em funções, registos de auditoria, suporte dedicado, SLA de 99,99% e chamadas de API ilimitadas. Empresas como Spotify, Vodafone, Chanel e Atlassian usam-no para operações de conteúdo em grande escala.

Quais são as desvantagens do Contentful?

As principais limitações incluem: sem edição visual integrada no produto base (o Studio é um complemento pago), imprevisibilidade de preços em escala devido a excessos de API e custos de complementos, sem fluxo de trabalho de gestão de tradução, dependência de programadores para todas as alterações de frontend, Rich Text em JSON a exigir renderizadores personalizados e dependência do fornecedor sem opção de alojamento próprio.

O Contentful suporta GraphQL?

Sim, nativamente. Cada espaço do Contentful recebe um esquema GraphQL gerado automaticamente com base nos seus tipos de conteúdo. Pode consultar com filtragem, paginação, ordenação e pedidos específicos por idioma. O endpoint fica em graphql.contentful.com/content/v1/spaces/{SPACE_ID}, autenticado com o seu token da Content Delivery API.

Quanto custa o Contentful por mês?

O nível gratuito custa $0. O Lite custa $300/mês com 20 utilizadores e 1M de chamadas de API. O Premium começa em cerca de $2.000+/mês com preço personalizado. O Enterprise situa-se entre cinco dígitos (gama média) e seis dígitos anualmente. Atenção aos custos ocultos: custos de excesso de API, taxas do complemento Contentful Studio, preço da personalização Ninetailed e serviços profissionais.

O Contentful suporta vários idiomas?

Sim, o Contentful tem suporte nativo de idiomas com substituições ao nível do campo — cada campo pode armazenar valores diferentes por idioma. No entanto, não há fluxo de trabalho de tradução, memória ou glossário integrados. Precisa de integrações de terceiros como Phrase, Smartcat ou Lokalise para gerir o processo de tradução em si, em escala.

O que é o Contentful Studio?

O Contentful Studio é um complemento de construção visual de páginas que chegou a GA na primavera de 2024. Permite a não-programadores compor páginas usando componentes de arrastar e largar com pré-visualização em direto. Requer integração de frontend (os seus componentes têm de estar registados no SDK do Studio) e é um complemento pago, não incluído nos planos base do Contentful.

Etiquetas

guia-contentfulheadless-cmsmodelacao-de-conteudographqlcms-api-first

Partilhar este artigo

Artigos relacionados

Mais em guides

guides
Jul 18, 2026

Comparação de Preços de API LLM 2026: Todos os Principais Modelos, com Preços

Uma comparação completa dos preços das APIs LLM para 2026 — Claude, GPT-5.6, Gemini, DeepSeek, Qwen, GLM e Mistral comparados lado a lado por milhão de tokens, diretamente das páginas oficiais de preços.

12 min read min de leitura
Ler
guides
Apr 12, 2026

Guia Surfer SEO 2026: Editor de Conteúdo, Pontuação NLP e Pesquisa com IA

Um guia prático do Surfer SEO que abrange o fluxo de trabalho do Editor de Conteúdo, o sistema de pontuação NLP, o AI Tracker para otimização GEO e a automação via API. Baseado em testes realizados em mais de 50 artigos.

14 min read min de leitura
Ler
guides
Apr 12, 2026

Guia Semrush 2026: Todas as Ferramentas Explicadas (Com Exemplos)

Um guia prático do Semrush que abrange pesquisa de palavras-chave, auditoria de sites, análise competitiva, monitorização da Visibilidade de IA e configuração de servidores MCP. Inclui exemplos de código e fluxos de trabalho de um pipeline real de SEO.

14 min read min de leitura
Ler
Ver todos os artigos
Inicia o Teu Projeto

Pronto para criar algo extraordinário?

Vamos transformar a sua visão em realidade. A nossa equipa está pronta para o ajudar a criar software que faz a diferença.

Marca uma chamada de scope 30 minVer o Nosso Trabalho

Destaque da biblioteca

Skills do Claude

Ver tudo
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

Automações AI

Ver tudo
  • Security Auditor

    Weekly SCA + IaC scan with prioritized fix PRs.

  • Cold Email Writer

    Generates first-touch emails grounded in one specific public detail.

  • Lead Research Agent

    Enrich an email into a profile, score fit, alert in Slack.

Destaque da biblioteca

Skills do Claude

Ver tudo
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

Automações AI

Ver tudo
  • Security Auditor

    Weekly SCA + IaC scan with prioritized fix PRs.

  • Cold Email Writer

    Generates first-touch emails grounded in one specific public detail.

  • Lead Research Agent

    Enrich an email into a profile, score fit, alert in Slack.

Serviços

  • Soluções Empresariais
  • Aplicações Móveis
  • Aplicações Web

Soluções

  • Sistemas CRM
  • Integração de IA
  • Soluções ERP
  • Agentes de Voz
  • Automação de Processos
  • Cibersegurança

Biblioteca

  • Blogue
  • Portfólio

Comunidade

  • Automações AI
  • Skills do Claude

Ferramentas

  • Calculadora de Custo de App Móvel
  • Calculadora de Custo de API OpenAI / LLM
  • Calculadora de Custo de MVP
  • Calculadora de Custo de Agente de Voz AI

Empresa

  • Sobre
  • Parceiros
  • Contacto

Legal

  • Política de Privacidade
  • Termos de Serviço
  • Política de Cookies

Serviços

  • Soluções Empresariais
  • Aplicações Móveis
  • Aplicações Web

Soluções

  • Sistemas CRM
  • Integração de IA
  • Soluções ERP
  • Agentes de Voz
  • Automação de Processos
  • Cibersegurança

Biblioteca

  • Blogue
  • Portfólio

Comunidade

  • Automações AI
  • Skills do Claude

Ferramentas

  • Calculadora de Custo de App Móvel
  • Calculadora de Custo de API OpenAI / LLM
  • Calculadora de Custo de MVP
  • Calculadora de Custo de Agente de Voz AI

Empresa

  • Sobre
  • Parceiros
  • Contacto
LegalPolítica de PrivacidadeTermos de ServiçoPolítica de Cookies
TECHSY
© 2026 Techsy. Todos os direitos reservados.