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
- Com dados de teste, confirme que a URL, o campo e o valor “antes” batem, e processe só uma mudança aprovada.
- 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.
- 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.