Recursos · Integración n8n

Integración Contentful n8nAutomatiza Contentful con n8n.

¿Tu contenido solo se mueve cuando alguien abre Contentful? La integración Contentful n8n deja que un flujo de trabajo lea el espacio por ti: 7 operaciones repartidas en 5 recursos, desde los assets hasta las locales. Pensada para equipos de contenido y operaciones que publican a menudo.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración Contentful n8n?

El nodo Contentful convierte un espacio en algo que un flujo de trabajo puede consultar solo, sin que nadie entre en la interfaz. Viene incluido en n8n, así que no hay nada que instalar, ni en n8n Cloud ni en una instancia autoalojada, y se autentica con un token de acceso a la API de Contentful guardado una sola vez. El catálogo reúne 7 operaciones sobre 5 recursos: Asset, Content Type, Entry, Locale y Space.

Hay un uso que casi nadie prevé y que acaba siendo el más práctico: la auditoría de estructura. Get a Space confirma sobre qué espacio apunta el token, y Get a Content Type devuelve la definición de un modelo antes de que cualquier paso posterior intente mapear sus campos. Cuando alguien cambia la estructura un viernes por la tarde, el flujo lo detecta el lunes en lugar de fallar en silencio.

Otro uso, más clásico pero igual de rentable: el inventario editorial. Get Many Entries filtrado por Content Type ID devuelve todas las entradas de un mismo modelo, y esas filas terminan en Google Sheets, donde el equipo ordena por fecha y ve qué contenido lleva meses sin tocarse. La hoja se reescribe sola en cada pasada.

Queda el terreno de los medios y del marketing. Get Many Assets con Return All activado recorre toda la biblioteca página a página, y Get an Asset recupera una imagen concreta justo antes de que una campaña salga por Mautic. Así el visual que se envía es el que está en Contentful, no una copia descargada hace tres meses.

Conviene decidir pronto una cosa: Contentful no tiene nodo trigger en n8n. El flujo arranca en otro sitio, con un Schedule Trigger que se ejecuta cada cierto intervalo, con un Webhook de n8n, o sea una URL que otro servicio llama, o con el trigger de una herramienta que ya esté en la cadena. De esa elección depende lo reciente que sea el dato que acabas mostrando.

Todo lo que queda fuera de esas 7 operaciones del catálogo se hace con el nodo HTTP Request, que llama a cualquier endpoint de la API de Contentful reutilizando el mismo credential. La plantilla pública 640, Get all the entries from Contentful, sirve de punto de partida. Y si antes de montar nada quieres juzgar la herramienta en conjunto, ahí está la Reseña n8n, con un enfoque parecido al de la ficha de YouTube.

Conexión

¿Cómo se conecta Contentful con n8n?

  1. 01

    Genera las claves en Contentful

    Antes de tocar n8n necesitas una cuenta de Contentful y un espacio creado. Entra en Settings > API keys y crea una clave: el Space ID aparece mientras se generan los tokens, y esa misma clave produce a la vez un Content Delivery API Access Token y un Content Preview API Access Token. Deja la pestaña abierta, porque esos tres valores van directos a n8n.

  2. 02

    Guarda el credential una sola vez

    En n8n, un credential es el juego de datos de conexión que se guarda una vez y que reutilizan todos los flujos. Abre el menú Credentials, crea un credential de Contentful y rellena el Space ID, el Content Delivery API Access Token y el Content Preview API Access Token. El token que no pienses usar puede quedarse vacío. Al guardarlo, el nodo Contentful ya te lo ofrece en su desplegable.

  3. 03

    Comprueba la conexión con una lectura corta

    Coloca un nodo Contentful en el lienzo, elige el credential y selecciona Get a Space. Es la ida y vuelta más rápida: no hay ningún identificador que escribir, solo Source. Si el espacio responde, el token sirve. A partir de ahí pasa a una operación real y rellena Environment ID, el entorno de Contentful que el nodo consulta, del tipo master o staging.

Acciones

Qué sabe hacer el nodo Contentful

El nodo Contentful expone 7 operaciones en 5 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoGetGet Many
Asset✓✓
Content Type✓
Entry✓✓
Locale✓
Space✓

Asset

2 operaciones
01

Get

asset.get

Lo que ves en n8n

Notas y casos de uso

Trae un único archivo ya subido al espacio, indicado a mano o mediante una expresión, en lugar de recorrer la biblioteca entera.

Parámetros clave

  • Asset ID: el identificador del archivo en Contentful, casi siempre con una expresión como {{ $json.field }} cuando lo arrastra un nodo anterior.
  • Source: deliveryApi lee lo publicado y previewApi lee el borrador, así que la elección cambia lo que devuelve el nodo.
  • Environment ID: el entorno consultado, por ejemplo master o staging; si tu plan no tiene entornos, usa master.
Casos de uso
una campaña de producto que necesita una imagen concreta antes de pasar el relevo a la herramienta de envío.
02

Get Many

asset.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve los archivos del espacio en forma de lista y con filtros de búsqueda, que es como se audita una biblioteca de medios en una sola ejecución.

Parámetros clave

  • Return All: activado, n8n encadena las páginas hasta el último archivo; desactivado, Limit marca cuántos vuelven.
  • Order: ordena la respuesta por una propiedad sys o por el valor de un campo, por ejemplo sys.createdAt para ver primero lo más reciente.
  • Fields: la lista de campos que quieres recibir, separados por comas, cuando al paso siguiente solo le hace falta uno.
  • RAW Data: devuelve la respuesta sin parsear, para flujos que prefieren tratar la estructura por su cuenta.
Casos de uso
la revisión trimestral de todo lo subido desde la última limpieza.

Content Type

1 operación
03

Get

contentType.get

Lo que ves en n8n

Notas y casos de uso

Devuelve la definición de un modelo de contenido, es decir la forma que siguen todas las entradas de ese tipo dentro del espacio.

Parámetros clave

  • Content Type ID: el identificador del modelo que quieres leer, copiado de Contentful o pasado con una expresión como {{ $json.field }}.
  • Source: deliveryApi o previewApi, según la API contra la que esté autenticado tu flujo.
  • Environment ID: permite revisar el modelo en staging antes de que la misma comprobación se ejecute en master.
Casos de uso
un paso de control que lee el modelo primero, para que un mapeo posterior no se desvíe sin avisar cuando alguien edita la estructura.

Entry

2 operaciones
04

Get

entry.get

Lo que ves en n8n

Notas y casos de uso

Recupera un contenido concreto a partir de su identificador. Es la operación que toca cuando un paso anterior ya ha señalado qué entrada importa.

Parámetros clave

  • Entry ID: el identificador de la entrada, normalmente con una expresión como {{ $json.field }} si viene de un formulario o de una lectura previa.
  • Source: apunta a previewApi para mirar una entrada todavía en borrador y a deliveryApi para la versión en línea.
  • RAW Data: conserva la respuesta en bruto, útil cuando el nodo siguiente espera la estructura original.
Casos de uso
un circuito de revisión que saca el borrador de un artículo y lo manda a validar antes de publicarlo.
05

Get Many

entry.getAll

Lo que ves en n8n

Notas y casos de uso

Consulta las entradas del espacio y las devuelve en lista, la operación de base de casi cualquier flujo con Contentful.

Parámetros clave

  • Content Type ID: limita la búsqueda a las entradas de un solo modelo, para que un export de artículos no arrastre también las páginas de aterrizaje.
  • Query: búsqueda de texto completo sobre las entradas, sin distinguir mayúsculas, y necesita más de un carácter para funcionar.
  • Return All: activado, vuelven todas las entradas que coinciden; desactivado, Limit pone el techo.
  • Order: fija el orden de la respuesta, por ejemplo sys.createdAt para empezar por lo más reciente.
Casos de uso
el export semanal de artículos publicados hacia la hoja que el equipo editorial ya revisa.

Locale

1 operación
06

Get Many

locale.getAll

Lo que ves en n8n

Notas y casos de uso

Enumera las locales configuradas en el espacio, de modo que el flujo sepa qué idiomas debe tratar en vez de darlos por supuestos.

Parámetros clave

  • Environment ID: las locales se leen por entorno, así que un idioma añadido en staging aparece ahí antes que en master.
  • Return All: activado para la lista completa; desactivado, Limit decide cuántas locales llegan.
  • Source: deliveryApi o previewApi, en coherencia con el token guardado en el credential.
Casos de uso
el primer nodo de un control de traducción, que alimenta el bucle encargado de leer cada versión de una entrada.

Space

1 operación
07

Get

space.get

Lo que ves en n8n

Notas y casos de uso

Devuelve el espacio al que apunta el credential. No hay identificador que escribir, y por eso es la forma más rápida de demostrar que la conexión funciona antes de montar nada encima.

Parámetros clave

  • Source: deliveryApi o previewApi; ejecutarla una vez con cada uno enseña al instante cuál de los dos tokens está realmente relleno.
Casos de uso
una comprobación de salud al inicio de un flujo programado, para que un token caducado dé un error claro y no un informe vacío más adelante.
Necesitas ayuda

¿Necesitas ayuda para automatizar Contentful con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Contentful y n8n, las dudas habituales

01¿La integración Contentful n8n es gratuita?
Sí por el lado de n8n. El nodo Contentful viene incluido en n8n, así que no hay nada que instalar ni nada extra que pagar: se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada que hayas instalado con Docker o npm. Un flujo montado en una funciona en la otra sin cambios. Lo que cueste Contentful según tu plan es otra cuestión y esta página no la trata. Por el lado de Contentful solo necesitas una cuenta, un espacio y un token de acceso a la API para empezar.
02¿Qué credenciales hacen falta para conectar Contentful con n8n?
Un único credential de Contentful, construido con un token de acceso a la API. En n8n el credential es el juego de datos de conexión que se guarda una vez y que reutilizan todos los flujos: lo escribes en el menú Credentials y después lo eliges en el desplegable del nodo. Pide tres valores: el Space ID, que Contentful muestra mientras genera los tokens, un Content Delivery API Access Token si quieres leer contenido publicado y un Content Preview API Access Token si quieres leer borradores. El token que no vayas a usar puede quedarse vacío. Ambos se generan juntos desde Settings > API keys.
03¿Qué límites tiene el nodo Contentful en n8n?
El nodo cubre 7 operaciones repartidas en 5 recursos: Asset, Content Type, Entry, Locale y Space. Todo lo que queda fuera de esa lista se resuelve con el nodo HTTP Request, que llama a cualquier endpoint de la API de Contentful y reutiliza el mismo credential mediante la autenticación predefinida. En las operaciones de lista, vigila Return All: si lo dejas desactivado, el nodo se detiene en Limit, y así es como un export parcial acaba pareciendo completo. Environment ID también cuenta, porque una lectura en staging y otra en master pueden devolver contenidos distintos para el mismo identificador.
04¿Puede n8n reaccionar en tiempo real a un cambio en Contentful?
Desde el propio nodo Contentful no, porque esta herramienta no tiene nodo trigger en n8n. Un flujo que toque Contentful arranca en otro punto. La vía más habitual es el Schedule Trigger, que ejecuta el flujo cada cierto intervalo fijo, cada mañana o cada hora, y después lee el espacio con Get Many Entries o Get Many Assets. La segunda vía es el nodo Webhook de n8n, una URL que otro servicio llama cuando pasa algo por su lado y que dispara la lectura. La tercera es sencillamente el trigger de otra herramienta que ya forme parte del flujo.
05¿n8n o Make para Contentful?
Depende de dónde quieras que viva la automatización. Make es una plataforma alojada, sin opción de autoalojamiento, facturada por operación, de modo que el coste sube con el número de pasos que ejecutan tus escenarios. n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, y el mismo flujo se comporta igual en ambos casos. Si tus datos de contenido deben quedarse en una infraestructura que controlas, la decisión está tomada. Si no quieres gestionar ningún servidor, la versión alojada de cualquiera de las dos sirve. Mira el modelo de coste y qué lógica visual te resulta más fácil de leer.