Integraciones

Guía de integración del sitio

Cómo llegan los cambios a tu sitio depende de cómo esté construido. Empieza con un sitio y datos de prueba, y confirma adónde va cada cambio y si se publica.

¿No eres desarrollador? La guía de configuración explica con capturas cómo conectar Google y WordPress.

Preparación común

La API para sitios a medida y las tareas de borrador del CMS requieren un plan Growth o Pro activo, la verificación de propiedad del sitio confirmada y la aprobación de cada cambio por parte del propietario. Confirma la propiedad en la pantalla Connections y después crea una clave que pueda registrar resultados en la pantalla API. Una clave de API por sí sola no puede aprobar cambios.

Asocia una a una cada URL de página HTTPS y cada campo de cambio con el registro y el campo del CMS que realmente aparecen en esa página. Antes de configurarlo, prepara datos de prueba, una persona responsable y tu procedimiento de publicación.

Sitios a medida

Implementa el proceso en el servidor de tu sitio siguiendo la especificación de la API de cambios. Obtén los cambios aprobados, comprueba la URL y el campo con una lista de permitidos y guarda un borrador solo si el valor actual coincide con el valor «antes». Devuelve a la API la versión guardada y el resultado.

Los campos admitidos son title, description, h1 y body. Por ejemplo, asocia el title de https://example.com/about con el título de tu propio registro «Quiénes somos». La publicación se hace aparte, después de que una persona lo revise.

WordPress

Conecta el sitio desde la pantalla Connections. Prepara una contraseña de aplicación para un usuario de WordPress que pueda editar las entradas y páginas afectadas, y pruébala primero en una página de prueba. Limítala al permiso de edición necesario y revoca las contraseñas que ya no uses. Los pasos con capturas están en Conectar WordPress.

Aplicar en una página publicada actualiza directamente el contenido publicado. Acciones como Use this edit son la aprobación para escribir. No se admite crear un borrador aparte. En maquetadores y campos que no se pueden editar, copia el texto y aplícalo a mano.

Tareas de borrador del CMS

Para microCMS, Shopify, Webflow, Contentful y Sanity hay tareas de borrador de ejemplo que se ejecutan en tu lado. Necesitan Node.js 22.13 o posterior y un diario SQLite privado en un disco persistente. Pasa los secretos del CMS como variables de entorno desde el almacén de secretos de tu propio servidor, y nunca los pongas en el navegador, en archivos de configuración ni en registros. Get1pct no guarda tus secretos del CMS ni ejecuta estas tareas por ti.

Por ahora son implementaciones de prueba. En las cinco se confirmó en un entorno real guardar un borrador, volver a leerlo y el resultado de una nueva ejecución, con contenido sin publicar en entornos de prueba dedicados. Las comprobaciones cubren solo esos elementos de prueba. En Shopify se comprobó el nombre del producto; los campos SEO no se han probado con la API real.

El ejemplo de abajo asocia una URL y un campo de Get1pct con un endpoint, un ID de contenido y un campo de microCMS. Sustituye los valores según tu entorno de prueba.

{
  "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"
    }
  }]
}

Las variables de entorno comunes son GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG y GET1PCT_CMS_JOURNAL. Las credenciales de cada CMS van en las variables de abajo.

Shopify

Crea una app en el Dev Dashboard y obtén un token de servidor con el client credentials grant. Usa una tienda de desarrollo que no publique, con un producto DRAFT sin publicar. Pon un token con read_products y write_products en SHOPIFY_INTEGRATION_TOKEN e indica shop (por ejemplo, example.myshopify.com) y productId (por ejemplo, gid://shopify/Product/123). title y description corresponden a los campos SEO y h1 al nombre del producto; el texto del cuerpo no se admite.

Webflow

Pon en WEBFLOW_INTEGRATION_TOKEN un token con acceso de lectura y escritura al CMS de un sitio de prueba. Indica un campo PlainText editable en el idioma principal con collectionId, itemId y fieldSlug. Comprueba que la plantilla muestra realmente ese campo. Los cambios se guardan en staging; publicar es un paso aparte.

Contentful

En un espacio y un entorno de prueba, pon en CONTENTFUL_INTEGRATION_TOKEN un token de la API de gestión que pueda leer y editar la entrada objetivo. Indica spaceId, environmentId, entryId, fieldId y locale (por ejemplo, en-US). Se admiten los campos de texto existentes; Rich Text no. Los cambios en una entrada publicada quedan sin publicar hasta que los publiques aparte.

Sanity

En un dataset de prueba, pon en SANITY_INTEGRATION_TOKEN un token que pueda leer y editar el borrador objetivo. Indica projectId, dataset, un documentId existente que empiece por drafts. y un campo de texto field. Portable Text no se admite. Revisa el contenido en Studio y publícalo aparte si quieres que esté en línea.

microCMS

Prepara una API de lista y contenido sin publicar en un servicio de prueba, y pon en MICROCMS_INTEGRATION_API_KEY una clave limitada a GET y PATCH sobre esa API. Pon el draftKey del borrador en la variable de entorno que indique draftKeyEnv en la configuración. Indica serviceId, endpoint, id y un campo de texto field. Solo se admite contenido existente sin publicar.

Pruebas y funcionamiento

  1. Con datos de prueba, confirma que la URL, el campo y el valor «antes» coinciden, y procesa un solo cambio aprobado.
  2. Comprueba el valor y la versión del borrador en la administración del CMS, y que la página publicada no ha cambiado. Prueba las actualizaciones directas de WordPress en una página de prueba.
  3. Investiga cualquier discrepancia en el valor «antes» o error de permisos. Si no sabes si un guardado salió bien, reanuda con el mismo diario y vuelve a leer. No reenvíes a ciegas ni borres el diario.

Con microCMS, Shopify y Webflow no se pueden evitar del todo las ediciones simultáneas entre la última comprobación y el guardado. Durante las pruebas, asegúrate de que ninguna otra persona ni tarea edite el mismo registro.