INTEGRACIÓN CONTENTFUL n8n: AUTOMATIZAR CONTENTFUL CON N8N

Esta acción recupera los detalles completos de un espacio Contentful, incluyendo su nombre, locales disponibles, configuración regional y metadatos. Es útil para obtener información contextual sobre el espacio antes de consultar recursos más específicos como entries o assets.

Parámetros clave:

• Credential to connect with: Menú desplegable donde seleccionas las credenciales Contentful previamente configuradas. Este parámetro es requerido para autenticar la conexión entre n8n y tu espacio Contentful.
• Source: Menú desplegable para elegir la API a consultar. Aquí se selecciona Delivery API, que proporciona acceso a contenido publicado. Este parámetro determina el endpoint utilizado para la petición.
• Resource: Campo autocompletado que indica el tipo de recurso sobre el que actúa la acción. Aquí está configurado en Space, especificando que esta acción opera sobre espacios Contentful.
• Operation: Menú desplegable que define la operación a realizar. Con Get seleccionado, la acción recuperará los detalles del espacio especificado por las credenciales.

Casos de uso típicos:

• Obtener información de configuración del espacio antes de ejecutar operaciones masivas de extracción de contenido.
• Verificar los locales disponibles en un espacio para adaptar consultas multilingües.
• Documentar automáticamente los metadatos de espacios Contentful en una base de datos externa o Google Sheets.

Cuándo usarlo: Usa esta acción al inicio de workflows que necesitan contexto sobre el espacio Contentful (locales, nombre, configuración) antes de consultar recursos específicos. Especialmente útil en workflows de auditoría o sincronización multi-espacio.

Esta acción recupera todos los locales configurados en un espacio Contentful, permitiéndote conocer qué idiomas y variantes regionales están disponibles. Es esencial para workflows multilingües que necesitan iterar sobre locales o filtrar contenido por idioma.

Parámetros clave:

• Credential to connect with: Menú desplegable requerido para seleccionar las credenciales Contentful que autorizan las llamadas API.
• Source: Menú desplegable para elegir entre Delivery API o Preview API. Aquí configurado en Delivery API para acceder a locales del entorno de producción.
• Resource: Campo que especifica el tipo de recurso; aquí es Locale, indicando que la acción recuperará información de locales.
• Operation: Menú desplegable configurado en Get Many, lo que significa que la acción recuperará múltiples locales en una sola petición.
• Environment ID: Campo de texto que especifica el entorno de Contentful desde el cual extraer datos. El valor predeterminado es master, el entorno principal. Este parámetro es requerido.
• Return All: Interruptor on/off que, cuando está activado, recupera todos los locales sin límite. Aquí está desactivado.
• Limit: Campo numérico que define el número máximo de locales a devolver. Configurado en 100 aquí, limitando los resultados a 100 locales por petición.

Casos de uso típicos:

• Obtener la lista de locales antes de extraer entries en múltiples idiomas.
• Generar informes de cobertura de contenido por locale.
• Configurar dinámicamente workflows de traducción basándose en los locales disponibles en Contentful.

Cuándo usarlo: Perfecto para workflows que gestionan contenido multilingüe o necesitan adaptarse dinámicamente a los locales configurados en Contentful. Combínalo con otras acciones (Get entry, Get Many Assets) para iterar sobre contenido localizado.

Esta acción obtiene un entry específico de Contentful utilizando su ID único. Recupera todos los campos del entry (texto, imágenes, relaciones, etc.) según el content type asociado. Es la acción más utilizada para extraer contenido estructurado de Contentful.

Parámetros clave:

• Credential to connect with: Menú desplegable requerido para autenticar la petición con tus credenciales Contentful.
• Source: Menú desplegable para seleccionar la API. Aquí configurado en Delivery API para acceder a contenido publicado.
• Resource: Campo que indica el tipo de recurso; configurado en Entry, especificando que esta acción recupera entries de Contentful.
• Operation: Menú desplegable con Get seleccionado, indicando que la acción recuperará un entry específico.
• Environment ID: Campo de texto requerido que especifica el entorno Contentful objetivo, con master como valor por defecto.
• Entry ID: Campo de texto opcional donde introduces el ID único del entry que deseas recuperar. Acepta valores estáticos o expresiones dinámicas (por ejemplo, desde un nodo anterior).
• Additional Fields: Sección expandible para añadir parámetros opcionales como filtros de locale, inclusión de assets relacionados, etc. Actualmente muestra No properties con opción de añadir campos adicionales.

Casos de uso típicos:

• Extraer un artículo de blog de Contentful para publicarlo automáticamente en un sitio web externo.
• Obtener los detalles de un producto para sincronizarlo con un sistema de e-commerce como WooCommerce.
• Recuperar entries específicos para alimentar newsletters personalizadas vía email marketing (Mailchimp, SendGrid).

Cuándo usarlo: Utiliza esta acción cuando conoces el Entry ID exacto que necesitas (por ejemplo, desde un webhook Contentful, una base de datos externa o un nodo anterior de n8n). Ideal para workflows de sincronización uno a uno o actualizaciones basadas en eventos.

Esta acción recupera la estructura de un content type específico de Contentful, incluyendo todos sus campos, tipos de datos, validaciones y configuraciones. Es útil para workflows que necesitan conocer el esquema de contenido antes de procesar entries.

Parámetros clave:

• Credential to connect with: Menú desplegable requerido donde seleccionas las credenciales Contentful para autenticar la conexión.
• Source: Menú desplegable requerido para elegir entre las APIs de Contentful; aquí configurado en Delivery API.
• Resource: Campo autoconfigurado en Content Type, indicando que la acción operará sobre content types de Contentful.
• Operation: Menú desplegable con Get seleccionado, especificando que la acción recuperará información de un solo content type.
• Environment ID: Campo de texto requerido que especifica el entorno Contentful objetivo, por ejemplo master, el entorno principal.
• Content Type ID: Campo de texto opcional donde introduces el identificador específico del content type que deseas consultar.
• Additional Fields: Sección que permite añadir propiedades opcionales si es necesario. Actualmente sin propiedades configuradas.

Casos de uso típicos:

• Documentar automáticamente el esquema de content types en una wiki o base de conocimiento.
• Validar la estructura de entries antes de procesarlos en workflows complejos.
• Generar dinámicamente formularios de entrada basándose en la estructura de un content type Contentful.

Cuándo usarlo: Usa esta acción cuando necesitas metadatos sobre la estructura de contenido en Contentful, especialmente en workflows de validación, migración de contenido o generación dinámica de interfaces. Combínala con Get entry para asegurar que los datos extraídos cumplen con el esquema esperado.

Esta acción recupera múltiples assets (imágenes, videos, documentos, etc.) de un entorno Contentful en una sola petición. Permite extraer lotes de assets con control sobre el número de resultados devueltos, ideal para workflows de respaldo o sincronización masiva.

Parámetros clave:

• Credential to connect with: Menú desplegable donde seleccionas las credenciales Contentful account para autenticar la petición. Este campo es requerido.
• Source: Menú desplegable configurado en Delivery API, que especifica el endpoint API para leer contenido publicado.
• Resource: Campo configurado en Asset, indicando que esta acción operará sobre recursos de tipo asset en Contentful.
• Operation: Menú desplegable con Get Many seleccionado, lo que significa que la acción recuperará múltiples assets en una sola petición.
• Environment ID: Campo de texto que acepta valores fijos o expresiones, aquí configurado en master, identificando el entorno de Contentful desde el cual se extraen los assets. Este campo es requerido.
• Return All: Interruptor on/off que determina si se recuperan todos los assets o si se limita el número de resultados. Aquí está desactivado.
• Limit: Campo numérico que especifica el número máximo de assets a devolver. Configurado en 100 en este ejemplo, limitando la consulta a 100 assets por petición.
• Additional Fields: Sección expandible para personalizar aún más la petición con parámetros opcionales. Actualmente no hay campos adicionales configurados.

Casos de uso típicos:

• Respaldar automáticamente todos los assets de Contentful en Google Drive, Dropbox o AWS S3 cada semana.
• Extraer imágenes de un entorno Contentful para procesarlas con herramientas de optimización como Cloudinary.
• Sincronizar assets entre múltiples entornos Contentful (staging → production).
• Generar informes de uso de assets (tamaños, formatos, metadatos) y enviarlos a Google Sheets o Airtable.

Cuándo usarlo: Perfecto para workflows de gestión de assets a gran escala, respaldo automatizado o auditorías de contenido multimedia. Combínalo con nodos de almacenamiento cloud (Google Drive, AWS S3) para crear pipelines de respaldo automático.

Esta acción recupera un asset específico de Contentful utilizando su ID único. Devuelve todas las propiedades del asset: URL, tipo de archivo, tamaño, metadatos, título y descripción. Es la acción esencial para workflows que procesan archivos individuales.

Parámetros clave:

• Credential to connect with: Menú desplegable requerido para seleccionar las credenciales Contentful que autenticarán la petición.
• Source: Menú desplegable para especificar la API de Contentful; aquí configurado en Delivery API, usado para obtener contenido publicado.
• Resource: Campo configurado en Asset, indicando que el tipo de recurso a recuperar es un asset de Contentful.
• Operation: Menú desplegable con Get seleccionado, lo que significa que la acción obtendrá un solo asset específico.
• Environment ID: Campo de texto requerido que especifica el entorno de Contentful, con master como valor predeterminado (el entorno principal).
• Asset ID: Campo de texto requerido donde introduces el identificador único del asset que deseas recuperar. Este parámetro es esencial para obtener correctamente el asset desde el entorno y API especificados.

Casos de uso típicos:

• Descargar una imagen específica de Contentful para procesarla (redimensionar, optimizar, watermark) antes de subirla a otra plataforma.
• Extraer la URL de un video o documento de Contentful para compartirla en un email o mensaje de Slack.
• Obtener metadatos de un asset (tamaño, formato, título) para incluirlos en informes de auditoría de contenido.

Cuándo usarlo: Usa esta acción cuando conoces el Asset ID exacto (por ejemplo, desde un entry relacionado, un webhook o una base de datos externa). Ideal para workflows que procesan archivos individuales o necesitan información detallada de un asset específico antes de realizar operaciones posteriores (descarga, conversión, publicación). Si necesitas dominar n8n para crear estos workflows, consulta nuestro curso n8n.