Recursos · Integración n8n

Integración Nextcloud n8nAutomatiza Nextcloud con n8n.

Tu Nextcloud puede hacer bastante más que guardar lo que otros dejan ahí. La integración Nextcloud n8n expone 17 operaciones sobre 3 recursos: archivos, carpetas y usuarios. Un flujo sube, mueve y comparte sin que nadie toque nada. No hay trigger: el arranque viene de fuera.

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

Por qué automatizar

¿Para qué sirve la integración Nextcloud n8n?

El nodo de Nextcloud habla con tu instancia por WebDAV y por la API de cuentas, y convierte el manejo de documentos en pasos de un flujo. Cubre tres recursos: File, Folder y User. En la práctica: la carpeta del mes se crea sola, el documento cae dentro con el nombre correcto, el enlace llega a quien toca y la lectura de la carpeta confirma lo que entró.

Primer escenario, la bandeja que se vacía sola. Llega una factura adjunta, folder.create abre la carpeta del proveedor si falta y file.upload deja el documento donde administración lo busca. Quien ya recibe esos adjuntos en Gmail obtiene un archivador que se llena sin arrastrar ni un fichero.

Segundo escenario, el archivo trimestral. folder.list lee el contenido de un directorio, una condición separa lo antiguo de lo reciente y folder.move manda el trimestre cerrado a una rama de archivo. El inventario que sale de ahí se escribe en Google Sheets, o en una tabla de Postgres si prefieres consultarlo con SQL: cada movimiento queda registrado y con fecha, sin entrar al servidor.

Tercer escenario, la alta de una persona nueva. user.create crea la cuenta, folder.create prepara su directorio de trabajo, folder.share lo abre a su grupo y un aviso por Slack le dice dónde mirar. El día de la baja la cadena se repite al revés y termina en user.delete.

Muchas veces Nextcloud es el destino y no el origen: los documentos que pasan por otras herramientas aterrizan aquí para quedarse, que es justo el motivo de alojar tu propia instancia. Lo que viaja entre pasos se llama campo binario, el hueco de un item de n8n que carga el archivo en sí y no texto: tanto la descarga como la subida lo nombran de forma explícita.

Dos límites antes de construir nada. No existe nodo trigger de Nextcloud, así que nada arranca con un evento suyo: lo lanza un Schedule Trigger a intervalo fijo, o un Webhook de n8n, una URL que llama un servicio externo. Y el nodo se queda en archivos, carpetas y cuentas. Talk, Calendar o Deck pasan por el nodo HTTP Request, que llama a cualquier endpoint de la API reutilizando el mismo credential, es decir las credenciales guardadas una sola vez en n8n. Si aún dudas de la plataforma, la Reseña n8n entra en detalle.

Conexión

¿Cómo se conecta Nextcloud con n8n?

  1. 01

    Arma tu URL de WebDAV

    Los dos métodos de autenticación piden una WebDAV URL. Coge la dirección con la que entras a Nextcloud y añádele /remote.php/webdav/. Con una instancia en https://cloud.n8n.com, la URL queda como https://cloud.n8n.com/remote.php/webdav. Si Nextcloud está instalado en un subdirectorio, mete ese subdirectorio antes de la parte remote.php.

  2. 02

    Usa autenticación básica si quieres ir rápido

    La autenticación básica pide la URL de WebDAV, tu nombre de User y un Password. Nextcloud aconseja una contraseña de aplicación en vez de la de tu cuenta: pulsa tu avatar arriba a la derecha, entra en Personal settings, luego Security, baja hasta la sección App Password y genérala. La pegas en n8n. Ese credential se crea una vez y aparece en el desplegable de todos tus nodos de Nextcloud.

  3. 03

    O registra un cliente OAuth2

    En Nextcloud abre Administrator Security Settings, busca Add client dentro de OAuth 2.0 clients, ponle un nombre tipo n8n integration, pega como Redirection URI la OAuth Callback URL que muestra n8n y confirma con Add. Nextcloud devuelve un Client Identifier y un Secret: son el Client ID y el Client Secret en n8n.

Acciones

¿Qué sabe hacer el nodo de Nextcloud ?

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

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDeleteCopyDownloadListMoveShareUpload
File✓✓✓✓✓✓
Folder✓✓✓✓✓✓
User✓✓✓✓✓

File

6 operaciones
01

Copy a file

file.copy

Lo que ves en n8n

Notas y casos de uso

Duplica un documento y deja intacto el original, de modo que la copia se puede renombrar, compartir o archivar por su cuenta.

Parámetros clave

  • From Path: la ruta del archivo a copiar, empezando por barra, del estilo /invoices/original.txt. Si viene de un paso anterior, escribe una expresión como {{ $json.path }}, la sintaxis de n8n para leer un campo del item que entra.
  • To Path: la ruta de destino, también con barra inicial, por ejemplo /invoices/copy.txt.
Casos de uso
dejar el pedido firmado en la carpeta del cliente y una copia en el árbol contable.
02

Delete a file

file.delete

Lo que ves en n8n

Notas y casos de uso

Borra el objetivo de la instancia. Lo que pase después depende de las reglas de retención de tu Nextcloud, porque n8n no guarda ninguna copia.

Parámetros clave

  • Delete Path: la ruta a borrar, con barra inicial, por ejemplo /invoices/2019/invoice_1.pdf. El mismo campo acepta una carpeta entera, así que una errata aquí sale cara.
Casos de uso
vaciar los exports temporales cuando el flujo nocturno ya los ha llevado a su destino definitivo, para que el directorio de trabajo no arrastre los archivos de ayer.
03

Download a file

file.download

Lo que ves en n8n

Notas y casos de uso

Saca el archivo de Nextcloud y lo mete en el flujo, donde los nodos siguientes pueden leerlo, adjuntarlo o reenviarlo.

Parámetros clave

  • File Path: la ruta completa del archivo, con barra inicial, tipo /invoices/2019/invoice_1.pdf. Una ruta parcial falla.
  • Put Output File in Field: el nombre del campo binario de salida que llevará el archivo. Los nodos posteriores esperan ese nombre exacto, mantenlo igual en todo el flujo.
Casos de uso
recuperar el PDF de un proveedor antes del paso que le extrae el importe.
04

Move a file

file.move

Lo que ves en n8n

Notas y casos de uso

Cambia el sitio donde vive un documento. No se duplica nada: el archivo abandona la ruta antigua y solo existe en la nueva.

Parámetros clave

  • From Path: la ruta actual del archivo, por ejemplo /invoices/old_name.txt.
  • To Path: la ruta nueva. Cambia solo el último tramo y habrás renombrado el archivo en lugar de moverlo, que es el truco detrás de casi toda convención de nombres.
Casos de uso
un documento que cae en la carpeta de entrada pasa al directorio del cliente en cuanto el flujo sabe de quién es.
05

Share a file

file.share

Lo que ves en n8n

Notas y casos de uso

Abre un documento a alguien que no entra en la carpeta, con enlace público o nombrando al destinatario.

Parámetros clave

  • File Path: la ruta completa del archivo a compartir.
  • Share Type: el modo de compartir, entre Public Link, User, Group, Email y Circle.
  • User, Group ID, Email o Circle ID: quién recibe, según el tipo elegido.
  • Options: Password protege el recurso y Permissions marca lo permitido, desde Read a secas hasta All.
Casos de uso
mandar a un cliente un enlace con contraseña a su factura sin crearle cuenta.
06

Upload a file

file.upload

Lo que ves en n8n

Notas y casos de uso

Escribe un documento dentro de la instancia. Es la operación que cierra casi todos los flujos, porque Nextcloud suele ser donde se guardan las cosas y no de donde salen.

Parámetros clave

  • File Path: la ruta absoluta de destino. La carpeta padre tiene que existir ya, y si hay un archivo en esa ruta se sobrescribe.
  • Binary File: activado para un archivo real que llega de otro nodo, desactivado para escribir texto.
  • Input Binary Field: el nombre del campo binario de entrada que contiene el archivo.
  • File Content: el texto a escribir cuando Binary File sigue desactivado.
Casos de uso
guardar cada adjunto recibido durante el día.

Folder

6 operaciones
07

Copy a folder

folder.copy

Lo que ves en n8n

Notas y casos de uso

Reproduce un directorio con lo que contiene en un segundo sitio, sin quitar el original. Sirve cuando una estructura tiene que existir dos veces en vez de desplazarse.

Parámetros clave

  • From Path: la carpeta a copiar, con barra inicial.
  • To Path: la ruta de destino, que conviene elegir fuera de un directorio existente salvo que quieras escribir dentro de él.
Casos de uso
una plantilla de carpeta de proyecto, con sus subcarpetas ya nombradas, copiada para cada cliente nuevo para no rehacer el mismo árbol a mano.
08

Create a folder

folder.create

Lo que ves en n8n

Notas y casos de uso

Añade un directorio en la ruta indicada. Conviene lanzarla antes de cualquier subida que apunte a un sitio que quizá no exista.

Parámetros clave

  • Folder: la ruta a crear, con barra inicial, por ejemplo /invoices/2019. Solo se crea el último nivel: el padre tiene que estar, así que un árbol profundo pide una llamada por nivel.
Casos de uso
un flujo mensual abre la carpeta del periodo y todo lo que se produce ese mes entra ahí directamente, en lugar de amontonarse en la raíz.
09

Delete a folder

folder.delete

Lo que ves en n8n

Notas y casos de uso

Quita un directorio y todo lo que cuelga de él en una sola llamada. Sin simulación previa y sin confirmar archivo por archivo.

Parámetros clave

  • Delete Path: la ruta a eliminar, con barra inicial. Apuntada a un directorio, se va la rama completa, motivo suficiente para poner un nodo IF justo delante.
Casos de uso
desmontar el directorio temporal que creó un proceso por lotes, una vez que sus resultados ya están guardados en un sitio permanente.
10

List a folder

folder.list

Lo que ves en n8n

Notas y casos de uso

Devuelve el contenido de un directorio, un item por entrada, que el flujo puede filtrar, contar o recorrer.

Parámetros clave

  • Folder Path: el directorio a leer, con barra inicial, tipo /invoices/2019/. Si lo dejas vacío, el nodo lee la raíz de la URL de WebDAV guardada en el credential.
Casos de uso
comprobar cada mañana si la carpeta de entrada aún guarda archivos que nadie ha procesado y avisar cuando así sea. También es el inventario previo a un traslado masivo o a una limpieza.
11

Move a folder

folder.move

Lo que ves en n8n

Notas y casos de uso

Traslada un directorio con su contenido. El árbol conserva su forma, lo único que cambia es de quién cuelga.

Parámetros clave

  • From Path: la ruta actual de la carpeta.
  • To Path: la ruta nueva. Mover un árbol grande de una vez puede tardar, y por eso hay flujos que prefieren listar la carpeta y mover los archivos uno a uno.
Casos de uso
sacar los proyectos cerrados del espacio activo hacia una rama de archivo, para que el directorio compartido enseñe solo lo que está en marcha.
12

Share a folder

folder.share

Lo que ves en n8n

Notas y casos de uso

Da acceso a un directorio entero: lo que se añada después queda visible sin volver a compartir nada.

Parámetros clave

  • File Path: la ruta completa de la carpeta a compartir.
  • Share Type: Public Link, User, Group, Email o Circle.
  • User, Group ID, Email o Circle ID: quien recibe el acceso.
  • Options: Permissions decide entre Read, Create, Update, Delete o All, y Password cierra un enlace público.
Casos de uso
dar a la gestoría acceso Read a la carpeta de facturas del año y a nada más.

User

5 operaciones
13

Create a user

user.create

Lo que ves en n8n

Notas y casos de uso

Invita a una persona a la organización de Nextcloud. La cuenta queda creada y la invitación sale a la dirección que indiques.

Parámetros clave

  • Username: el identificador con el que entrará, tipo john. El resto de operaciones de cuentas piden ese mismo valor, así que fija la regla de nombres desde el principio.
  • Email: dónde llega la invitación.
  • Additional Fields: Display Name define el nombre legible que se ve en la instancia.
Casos de uso
se añade una fila en la hoja de personal y la cuenta existe antes del primer día.
14

Delete a user

user.delete

Lo que ves en n8n

Notas y casos de uso

Cierra una cuenta de la instancia. Va al final de la cadena de baja, cuando los archivos de esa cuenta ya se han movido o copiado a un espacio compartido.

Parámetros clave

  • Username: el identificador de la cuenta a eliminar, ni el nombre visible ni el correo. Si el flujo solo conoce a la persona por su nombre, léela antes con una operación de consulta.
Casos de uso
una salida registrada en el sistema de personal dispara la limpieza esa misma tarde, sin cuentas olvidadas que siguen abiertas meses.
15

Get a user

user.get

Lo que ves en n8n

Notas y casos de uso

Relee una cuenta y devuelve sus atributos, que el flujo puede comprobar antes de seguir.

Parámetros clave

  • Username: el identificador a consultar. Pásalo desde un nodo anterior con {{ $json.userId }} cuando el valor sale de un paso previo.
Casos de uso
verificar que una cuenta existe antes de compartirle una carpeta, ya que un recurso compartido con un usuario desconocido falla y corta la ejecución. También es el paso de lectura que se pone delante de una actualización.
16

Get many users

user.getAll

Lo que ves en n8n

Notas y casos de uso

Recorre el directorio de cuentas y devuelve la lista, un item por usuario.

Parámetros clave

  • Return All: activado, n8n encadena las páginas de la API hasta la última cuenta; desactivado, para en Limit.
  • Limit: el número máximo de cuentas devueltas.
  • Options: Search reduce la lista a las cuentas que coinciden y Offset salta las primeras, cómodo para tratar el directorio por tramos.
Casos de uso
un export mensual de cuentas activas, cruzado con la lista de personal para ver quién ya no debería estar.
17

Update a user

user.update

Lo que ves en n8n

Notas y casos de uso

Edita los atributos de una cuenta que ya existe, sin tocar lo que dejas fuera.

Parámetros clave

  • Username: la cuenta a modificar, por ejemplo john.
  • Update Fields: los atributos a cambiar, añadidos de uno en uno desde la lista de opciones. Una colección vacía hace que el nodo se ejecute sin cambiar nada, y eso pasa desapercibido porque el flujo da la ejecución por buena.
Casos de uso
un cambio de puesto en la herramienta de personal actualiza los atributos de la cuenta de Nextcloud el mismo día.
Necesitas ayuda

¿Necesitas ayuda para automatizar Nextcloud con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Nextcloud y n8n, las dudas más frecuentes

01¿La integración Nextcloud n8n es gratis?
Sí por el lado de n8n. El nodo de Nextcloud viene incluido con n8n, así que no hay nada que instalar ni ningún coste extra, tanto si usas n8n Cloud, la oferta alojada por n8n, como si levantas tu propia instancia con Docker o npm en Community Edition, bajo su licencia Sustainable Use. El flujo se comporta igual en ambos casos, algo que importa aquí: quien aloja Nextcloud en su propio servidor suele alojar n8n al lado. Lo que cuesta tu instancia de Nextcloud depende de cómo la explotes, y eso queda fuera de lo que hace el nodo.
02¿Qué credenciales hacen falta para conectar Nextcloud con n8n?
Funcionan dos métodos. La autenticación básica pide tu URL de WebDAV, tu nombre de usuario y una contraseña, y Nextcloud recomienda generar una contraseña de aplicación desde Personal settings, luego Security, y ahí la sección App Password, en vez de reutilizar la de tu cuenta. OAuth2 pide una Authorization URL, una Access Token URL, un Client ID y un Client Secret, que salen de añadir un cliente OAuth 2.0 en Administrator Security Settings, más la misma URL de WebDAV. En los dos casos el credential se crea una sola vez en el menú Credentials y todos los nodos de Nextcloud lo recogen luego desde su desplegable.
03¿Qué límites tiene el nodo de Nextcloud en n8n?
Cubre tres recursos y ninguno más: File, Folder y User, con 17 operaciones en total. Talk, Calendar, Deck, las etiquetas, los comentarios y la gestión de aplicaciones no están expuestos. Para eso, el nodo HTTP Request llama a cualquier endpoint de la API de Nextcloud reutilizando el mismo credential mediante la autenticación predefinida, así que no gestionas una segunda conexión. Dentro del nodo, las rutas empiezan siempre por barra y tienen que ser completas, una subida exige que la carpeta padre exista y sobrescribe lo que ocupe esa ruta, y solo el listado de usuarios ofrece Return All para encadenar páginas.
04¿Puede un flujo arrancar con un evento de Nextcloud?
No. Nextcloud no tiene nodo trigger en n8n, o sea que nada reacciona por sí solo cuando aparece un archivo en una carpeta. Hay dos montajes que lo sustituyen. Un Schedule Trigger se ejecuta a intervalo fijo y llama a la operación de listado para ver qué ha cambiado desde la pasada anterior, algo que encaja con el archivado y el ordenado nocturno. O un Webhook de n8n, una URL que llama un servicio externo, lanza el flujo desde fuera y Nextcloud recibe el resultado después. En la práctica, casi todos los flujos empiezan en otra herramienta, un buzón o un formulario, y terminan en Nextcloud.
05¿n8n o Make para Nextcloud?
Depende de dónde pueden vivir tus archivos. Make está alojado, sin opción de autoalojamiento, y se factura por operación, así que un flujo que lista una carpeta y mueve los archivos uno a uno se encarece según crece el volumen. n8n corre en tu propio servidor o en n8n Cloud, con el mismo flujo en ambos casos, lo que encaja con el motivo por el que elegiste Nextcloud: mantener los documentos en una infraestructura que controlas. Make conserva su interés por la construcción visual y por la comodidad de no administrar nada. Para una base documental autoalojada y con volumen, n8n cuadra mejor.