INTÉGRATION CONTENTFUL n8n : AUTOMATISER CONTENTFUL AVEC N8N

L'action "Get space" vous permet de récupérer les informations générales de votre espace Contentful. C'est souvent la première action à tester pour valider que votre connexion fonctionne correctement, mais elle s'avère aussi utile pour récupérer dynamiquement des métadonnées sur votre espace dans vos workflows.

Paramètres de configuration :

• Credential to connect with : Menu déroulant pour sélectionner vos identifiants Contentful. Ce paramètre est requis pour authentifier la connexion.
• Source : Menu déroulant pour choisir l'API à utiliser, ici "Delivery API" pour accéder au contenu publié.
• Resource : Automatiquement défini sur "Space" pour cette action.
• Operation : Défini sur "Get" pour récupérer les détails de l'espace.

Cas d'usage typiques : Valider la configuration de vos credentials avant de lancer un workflow complexe, récupérer le nom et les métadonnées de l'espace pour les inclure dans des rapports automatisés, vérifier programmatiquement l'état de votre espace Contentful. Cette action est particulièrement utile en début de workflow pour s'assurer que la connexion est établie avant d'exécuter des opérations plus lourdes.

L'action "GetAll locale" récupère l'ensemble des locales configurées dans votre espace Contentful. Essentielle pour les projets multilingues où vous devez connaître les langues disponibles pour vos contenus.

Paramètres de configuration :

• Credential to connect with : Identifiants Contentful. Requis.
• Source : "Delivery API" sélectionné.
• Resource : Défini sur "Locale" pour cibler les configurations de langue.
• Operation : "Get Many" pour récupérer plusieurs locales.
• Environment ID : Environnement cible, "master" par défaut. Requis.
• Return All : Interrupteur pour récupérer toutes les locales sans limite.
• Limit : Nombre maximum de locales à retourner si "Return All" est désactivé (ex: 100).

Cas d'usage typiques : Lister dynamiquement les langues disponibles pour un sélecteur de langue frontend, vérifier que toutes les locales attendues sont bien configurées dans Contentful, générer des rapports de couverture multilingue pour vos contenus. Pour automatiser la traduction, explorez l'intégration DeepL n8n.

L'action "Get entry" récupère une entrée spécifique (article, page, produit, etc.) depuis votre espace Contentful. C'est l'action centrale pour accéder au contenu de vos modèles de données personnalisés.

Paramètres de configuration :

• Credential to connect with : Vos identifiants Contentful. Requis.
• Source : "Delivery API" sélectionné pour accéder au contenu publié.
• Resource : Défini sur "Entry" pour cibler les entrées de contenu.
• Operation : "Get" pour récupérer une entrée unique.
• Environment ID : Environnement cible, "master" par défaut. Requis.
• Entry ID : Champ texte pour l'identifiant de l'entrée à récupérer. Optionnel mais nécessaire pour cibler une entrée spécifique. Accepte les inputs dynamiques.
• Additional Fields : Section pour ajouter des paramètres supplémentaires comme la sélection de locale.

Cas d'usage typiques : Récupérer un article de blog pour le publier automatiquement sur une newsletter, extraire les données d'un produit Contentful pour mettre à jour une fiche Shopify, synchroniser une entrée spécifique vers une base de données externe après modification.

L'action "Get contentType" récupère la structure d'un type de contenu spécifique dans votre espace Contentful. Utile pour comprendre dynamiquement la structure de vos données ou valider la configuration de vos modèles.

Paramètres de configuration :

• Credential to connect with : Sélection des identifiants Contentful. Requis.
• Source : "Delivery API" pour interroger le contenu publié.
• Resource : Défini sur "Content Type".
• Operation : "Get" pour récupérer un type de contenu unique.
• Environment ID : Environnement cible, "master" par défaut. Requis.
• Content Type ID : Champ texte pour spécifier l'identifiant du type de contenu à récupérer. Optionnel.
• Additional Fields : Options supplémentaires si nécessaire.

Cas d'usage typiques : Documenter automatiquement la structure de vos modèles Contentful, valider qu'un type de contenu existe avant de créer des entrées via d'autres intégrations, générer des schémas de données pour des outils de validation.

L'action "Get Many Assets" récupère plusieurs assets (images, vidéos, documents) depuis votre espace Contentful en une seule requête. Idéale pour synchroniser votre médiathèque avec d'autres systèmes ou créer des inventaires automatisés de vos fichiers.

Paramètres de configuration :

• Credential to connect with : Sélection du compte Contentful à utiliser. Requis.
• Source : "Delivery API" pour accéder au contenu publié.
• Resource : Défini sur "Asset" pour cibler les fichiers médias.
• Operation : "Get Many" pour récupérer plusieurs assets.
• Environment ID : Champ texte spécifiant l'environnement Contentful, par défaut "master". Requis.
• Return All : Interrupteur on/off. Activé, il récupère tous les assets sans limite.
• Limit : Champ numérique définissant le nombre maximum d'assets à retourner (ex: 100). Actif uniquement si "Return All" est désactivé.
• Additional Fields : Section extensible pour ajouter des filtres optionnels.

Cas d'usage typiques : Synchroniser automatiquement vos images Contentful vers un CDN externe via Cloudinary, générer un rapport hebdomadaire de tous les assets de votre médiathèque, alimenter une galerie dynamique sur un site statique à chaque build.

L'action "Get asset" récupère un asset spécifique de votre espace Contentful à partir de son identifiant unique. Utilisez-la quand vous connaissez précisément l'asset que vous souhaitez traiter dans votre workflow.

Paramètres de configuration :

• Credential to connect with : Menu déroulant pour sélectionner vos identifiants. Requis.
• Source : "Delivery API" pour le contenu publié.
• Resource : Défini sur "Asset".
• Operation : "Get" pour récupérer un seul asset.
• Environment ID : L'environnement cible, généralement "master". Requis.
• Asset ID : Champ texte où vous spécifiez l'identifiant unique de l'asset à récupérer. Requis. Accepte les expressions dynamiques.

Cas d'usage typiques : Récupérer les métadonnées d'une image spécifique pour les injecter dans un autre système, vérifier l'existence d'un asset avant de l'utiliser dans un workflow, extraire l'URL d'un fichier pour l'intégrer dans un email automatisé via Gmail.