Integrações

Guia de integração do site

Como as mudanças chegam ao seu site depende de como ele é feito. Comece com um site e dados de teste, e confirme para onde vai cada mudança e se ela é publicada.

Não é desenvolvedor? O guia de configuração mostra com capturas como conectar o Google e o WordPress.

Preparação comum

A API para sites sob medida e as tarefas de rascunho no CMS exigem um plano Growth ou Pro ativo, a verificação de propriedade do site confirmada e a aprovação de cada mudança pelo proprietário. Confirme a propriedade na tela Connections e depois crie uma chave capaz de registrar resultados na tela API. Uma chave de API sozinha não aprova mudanças.

Associe, um a um, cada URL de página HTTPS e cada campo de mudança ao registro e ao campo do CMS que realmente aparecem naquela página. Antes de configurar, prepare dados de teste, um responsável e o seu processo de publicação.

Sites sob medida

Implemente o processamento no servidor do seu site seguindo a especificação da API de mudanças. Busque as mudanças aprovadas, confira a URL e o campo com uma lista de permissões e salve um rascunho só quando o valor atual for igual ao valor “antes”. Devolva à API a versão salva e o resultado.

Os campos aceitos são title, description, h1 e body. Por exemplo, associe o title de https://example.com/about ao título do seu próprio registro “Quem somos”. A publicação é feita à parte, depois que uma pessoa revisar.

WordPress

Conecte o site na tela Connections. Prepare uma senha de aplicativo para um usuário do WordPress que possa editar os posts e páginas em questão, e teste primeiro em uma página de teste. Limite-a à permissão de edição necessária e revogue senhas que não usa mais. O passo a passo com capturas está em Conectar o WordPress.

Aplicar em uma página publicada atualiza diretamente o conteúdo no ar. Ações como Use this edit são a aprovação para gravar. Criar um rascunho separado não é suportado. Em construtores de páginas e campos não editáveis, copie o texto e aplique à mão.

Tarefas de rascunho no CMS

Para microCMS, Shopify, Webflow, Contentful e Sanity há tarefas de rascunho de exemplo que rodam do seu lado. Elas exigem Node.js 22.13 ou mais recente e um diário SQLite privado em disco persistente. Passe os segredos do CMS como variáveis de ambiente a partir do cofre de segredos do seu próprio servidor, e nunca os coloque no navegador, em arquivos de configuração ou em logs. O Get1pct não guarda seus segredos do CMS nem executa essas tarefas por você.

Por enquanto são implementações de teste. Nas cinco, foram confirmados em ambiente real o salvamento de um rascunho, a releitura e o resultado de uma nova execução, com conteúdo não publicado em ambientes de teste dedicados. As verificações cobrem só esses itens de teste. No Shopify foi verificado o nome do produto; os campos de SEO não foram testados na API real.

O exemplo abaixo associa uma URL e um campo do Get1pct a um endpoint, um ID de conteúdo e um campo do microCMS. Troque os valores de acordo com o seu ambiente de teste.

{
  "projectId": "test-project-id",
  "provider": "microcms",
  "options": { "serviceId": "example-sandbox" },
  "targets": [{
    "page": "https://example.com/about",
    "field": "title",
    "target": {
      "endpoint": "draft-fixtures", "id": "about", "field": "title",
      "draftKeyEnv": "MICROCMS_DRAFT_KEY_ABOUT"
    }
  }]
}

As variáveis de ambiente comuns são GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG e GET1PCT_CMS_JOURNAL. As credenciais de cada CMS vão nas variáveis abaixo.

Shopify

Crie um app no Dev Dashboard e obtenha um token de servidor com o client credentials grant. Use uma loja de desenvolvimento que não publica, com um produto DRAFT não publicado. Coloque um token com read_products e write_products em SHOPIFY_INTEGRATION_TOKEN e informe shop (por exemplo, example.myshopify.com) e productId (por exemplo, gid://shopify/Product/123). title e description correspondem aos campos de SEO, e h1 ao nome do produto; texto do corpo não é suportado.

Webflow

Coloque em WEBFLOW_INTEGRATION_TOKEN um token com acesso de leitura e gravação ao CMS de um site de teste. Informe um campo PlainText editável no idioma principal com collectionId, itemId e fieldSlug. Confira se o modelo realmente mostra esse campo. As mudanças são salvas em staging; publicar é uma etapa separada.

Contentful

Em um espaço e ambiente de teste, coloque em CONTENTFUL_INTEGRATION_TOKEN um token da API de gerenciamento que possa ler e editar a entrada alvo. Informe spaceId, environmentId, entryId, fieldId e locale (por exemplo, en-US). Campos de texto existentes são suportados; Rich Text não. Mudanças em uma entrada publicada ficam sem publicar até você publicá-las à parte.

Sanity

Em um dataset de teste, coloque em SANITY_INTEGRATION_TOKEN um token que possa ler e editar o rascunho alvo. Informe projectId, dataset, um documentId existente que comece com drafts. e um campo de texto field. Portable Text não é suportado. Revise o conteúdo no Studio e publique à parte se quiser colocá-lo no ar.

microCMS

Prepare uma API de lista e conteúdo não publicado em um serviço de teste, e coloque em MICROCMS_INTEGRATION_API_KEY uma chave limitada a GET e PATCH nessa API. Coloque o draftKey do rascunho na variável de ambiente indicada por draftKeyEnv na configuração. Informe serviceId, endpoint, id e um campo de texto field. Só conteúdo existente não publicado é suportado.

Testes e operação

  1. Com dados de teste, confirme que a URL, o campo e o valor “antes” batem, e processe só uma mudança aprovada.
  2. Confira o valor e a versão do rascunho no painel do CMS, e se a página publicada não mudou. Teste atualizações diretas do WordPress em uma página de teste.
  3. Investigue qualquer divergência no valor “antes” ou erro de permissão. Se não souber se um salvamento deu certo, retome com o mesmo diário e releia. Não reenvie às cegas nem apague o diário.

Com microCMS, Shopify e Webflow, edições simultâneas entre a última conferência e o salvamento não podem ser totalmente evitadas. Durante os testes, garanta que nenhuma outra pessoa ou tarefa edite o mesmo registro.