Intégrations

Guide d’intégration du site

La façon dont les modifications arrivent sur votre site dépend de sa construction. Commencez par un site et des données de test, et vérifiez où va chaque modification et si elle est publiée.

Vous n’êtes pas développeur ? Le guide de configuration explique la connexion de Google et WordPress avec captures.

Préparation commune

L’API pour sites sur mesure et les tâches de brouillon CMS nécessitent une formule Growth ou Pro active, une vérification de propriété confirmée pour le site et l’approbation de chaque modification par le propriétaire. Confirmez la propriété sur l’écran Connections, puis créez une clé capable d’enregistrer les résultats sur l’écran API. Une clé API seule ne peut pas approuver de modifications.

Associez une à une chaque URL de page HTTPS et chaque champ modifié à l’enregistrement et au champ CMS qui apparaissent réellement sur cette page. Avant de mettre cela en place, préparez des données de test, une personne responsable et votre procédure de publication.

Sites sur mesure

Implémentez le traitement sur le serveur de votre site en suivant la spécification de l’API de modifications. Récupérez les modifications approuvées, vérifiez l’URL et le champ avec une liste d’autorisation, et n’enregistrez un brouillon que si la valeur actuelle correspond à la valeur « avant ». Renvoyez à l’API la version enregistrée et le résultat.

Les champs pris en charge sont title, description, h1 et body. Par exemple, associez le title de https://example.com/about au titre de votre propre enregistrement « À propos ». La publication se fait à part, après vérification par une personne.

WordPress

Connectez le site depuis l’écran Connections. Préparez un mot de passe d’application pour un utilisateur WordPress qui peut modifier les articles et pages concernés, et essayez-le d’abord sur une page de test. Limitez-le aux droits de modification nécessaires et révoquez les mots de passe inutilisés. Les étapes avec captures sont dans Connecter WordPress.

Appliquer sur une page publiée met à jour directement le contenu en ligne. Des actions comme Use this edit valent approbation d’écriture. La création d’un brouillon séparé n’est pas prise en charge. Pour les constructeurs de pages et les champs non modifiables, copiez le texte et appliquez-le à la main.

Tâches de brouillon CMS

Pour microCMS, Shopify, Webflow, Contentful et Sanity, il existe des exemples de tâches de brouillon qui s’exécutent chez vous. Elles nécessitent Node.js 22.13 ou plus récent et un journal SQLite privé sur un disque persistant. Transmettez les secrets CMS en variables d’environnement depuis le coffre de secrets de votre propre serveur, et ne les mettez jamais dans le navigateur, des fichiers de configuration ou des journaux. Get1pct ne conserve pas vos secrets CMS et n’exécute pas ces tâches pour vous.

Il s’agit pour l’instant d’implémentations de test. Pour les cinq, l’enregistrement d’un brouillon, sa relecture et le résultat d’une nouvelle exécution ont été confirmés en environnement réel, avec du contenu non publié dans des environnements de test dédiés. Les vérifications couvrent uniquement ces éléments de test. Pour Shopify, le nom du produit a été vérifié ; les champs SEO n’ont pas été testés avec l’API réelle.

L’exemple ci-dessous associe une URL et un champ Get1pct à un endpoint, un ID de contenu et un champ microCMS. Remplacez les valeurs selon votre environnement de test.

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

Les variables d’environnement communes sont GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG et GET1PCT_CMS_JOURNAL. Les identifiants de chaque CMS vont dans les variables ci-dessous.

Shopify

Créez une app dans le Dev Dashboard et obtenez un jeton serveur avec le client credentials grant. Utilisez une boutique de développement qui ne publie pas, avec un produit DRAFT non publié. Placez un jeton avec read_products et write_products dans SHOPIFY_INTEGRATION_TOKEN, et indiquez shop (par exemple example.myshopify.com) et productId (par exemple gid://shopify/Product/123). title et description correspondent aux champs SEO et h1 au nom du produit ; le corps de texte n’est pas pris en charge.

Webflow

Placez dans WEBFLOW_INTEGRATION_TOKEN un jeton avec accès en lecture et écriture au CMS d’un site de test. Indiquez un champ PlainText modifiable dans la langue principale avec collectionId, itemId et fieldSlug. Vérifiez que le modèle affiche réellement ce champ. Les modifications sont enregistrées en staging ; la publication est une étape distincte.

Contentful

Dans un espace et un environnement de test, placez dans CONTENTFUL_INTEGRATION_TOKEN un jeton de l’API de gestion capable de lire et modifier l’entrée cible. Indiquez spaceId, environmentId, entryId, fieldId et locale (par exemple en-US). Les champs texte existants sont pris en charge, pas le Rich Text. Les modifications d’une entrée publiée restent non publiées jusqu’à ce que vous les publiiez séparément.

Sanity

Dans un dataset de test, placez dans SANITY_INTEGRATION_TOKEN un jeton capable de lire et modifier le brouillon cible. Indiquez projectId, dataset, un documentId existant commençant par drafts. et un champ texte field. Portable Text n’est pas pris en charge. Vérifiez le contenu dans Studio et publiez séparément si vous voulez le mettre en ligne.

microCMS

Préparez une API de liste et du contenu non publié dans un service de test, et placez dans MICROCMS_INTEGRATION_API_KEY une clé limitée à GET et PATCH sur cette API. Placez le draftKey du brouillon dans la variable d’environnement nommée par draftKeyEnv dans la configuration. Indiquez serviceId, endpoint, id et un champ texte field. Seul le contenu non publié existant est pris en charge.

Tests et exploitation

  1. Avec des données de test, vérifiez que l’URL, le champ et la valeur « avant » correspondent, puis traitez une seule modification approuvée.
  2. Vérifiez la valeur et la version du brouillon dans l’administration du CMS, et que la page en ligne n’a pas changé. Testez les mises à jour directes de WordPress sur une page de test.
  3. Analysez toute différence sur la valeur « avant » et toute erreur d’autorisation. Si vous ne savez pas si un enregistrement a réussi, reprenez avec le même journal et relisez. Ne renvoyez pas à l’aveugle et ne supprimez pas le journal.

Avec microCMS, Shopify et Webflow, les modifications simultanées entre la dernière vérification et l’enregistrement ne peuvent pas être totalement évitées. Pendant les tests, assurez-vous qu’aucune autre personne ni tâche ne modifie le même enregistrement.