Recursos · Integración n8n

Integración Box n8nAutomatiza Box con n8n.

Los documentos viven en Box, n8n decide qué pasa con ellos. La integración Box n8n son 13 operaciones repartidas en 2 recursos, archivos y carpetas, más un trigger que escucha 36 eventos agrupados en 8 familias. Pensada para equipos que todavía ordenan a mano.

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

Por qué automatizar

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

La integración Box n8n se apoya en dos nodos. El nodo Box actúa sobre la cuenta: sube, copia, descarga, busca, comparte y borra archivos, y crea, lee, busca, comparte, actualiza y borra carpetas. Son 13 operaciones sobre 2 recursos. El Box Trigger hace el camino contrario: arranca un flujo de trabajo cuando algo ocurre dentro de Box, con 36 eventos repartidos en 8 familias. Funciona por webhook, es decir, una URL que Box llama en el momento, así que el aviso llega en segundos.

El permiso que nadie retira es el mejor sitio para empezar. file.share y folder.share crean una colaboración con un usuario o un grupo, y el campo Role marca hasta dónde llega esa persona, desde Viewer hasta Co-Owner. Dentro de la colección Options, Expires At fija la fecha en la que esa colaboración se retira sola. Para un proveedor que entra tres semanas, eso separa un acceso limpio de un acceso olvidado. Cuando el proyecto cierra, folder.update renombra la carpeta y la mueve bajo el árbol de archivo.

Justo debajo aparece la parte aburrida y necesaria: que cada documento nazca en su sitio. folder.create levanta la carpeta del cliente nuevo y file.upload deja dentro la factura, el contrato o el informe que venía del paso anterior. Una fila en Google Sheets deja constancia de qué entró y cuándo, y si ese registro tiene que aguantar consultas de verdad, una tabla en Supabase hace el mismo trabajo con más músculo.

Queda la dirección opuesta, la que convierte a Box en el punto de partida. Activas el Box Trigger, marcas los eventos que te importan y Box avisa: FILE.UPLOADED cuando alguien deja un archivo en la carpeta vigilada, FILE.RENAMED cuando lo renombra, COLLABORATION.CREATED cuando invita a alguien. Ese aviso puede acabar en un correo enviado con Gmail al responsable que tiene que revisarlo.

Antes de montar nada conviene tener dos cosas claras. Las búsquedas vienen paginadas: con Return All desmarcado el nodo se detiene en la cifra de Limit, y marcado n8n recorre las páginas hasta el final. Y lo que queda fuera de las 13 operaciones del catálogo se resuelve con el nodo HTTP Request, que llama a cualquier endpoint de la API de Box reutilizando el mismo credential mediante la autenticación predefinida.

Con eso ya tienes material para el primer flujo. Si la duda todavía está en la plataforma y no en Box, la Reseña n8n cuenta en qué destaca y dónde molesta.

Conexión

¿Cómo se conecta Box con n8n?

  1. 01

    Abre una cuenta Box y crea una Custom App

    El único requisito previo es una cuenta de Box. El credential de Box, la ficha de acceso que n8n guarda, se autentica con OAuth2: apruebas el acceso en el navegador en lugar de copiar una clave de un sitio a otro. Si quieres configurar ese flujo por tu cuenta, Box pide crear antes una Custom App y explica en su guía de OAuth2 qué ocurre en cada redirección. Deja esa pestaña abierta.

  2. 02

    Crea el credential dentro de n8n

    En n8n entras en el menú Credentials y creas un credential de Box. Se crea una vez y se reutiliza en todas partes: el mismo autentica el nodo Box y el Box Trigger, y cada flujo posterior lo elige de una lista desplegable. No hace falta un segundo credential para el trigger, ni pegar nada dentro del nodo. El nodo HTTP Request también se apoya en esa misma conexión.

  3. 03

    Coloca el nodo y elige el recurso

    Añade el nodo Box al lienzo, selecciona el credential y elige el recurso: File o Folder. La lista de operaciones cambia con él, siete del lado de archivos y seis del lado de carpetas. Para la parte de escucha se coloca el Box Trigger, se marcan los eventos en el campo Events y se activa el flujo. En ese momento n8n registra la URL del webhook en Box.

Disparadores

¿Qué puede arrancar un flujo desde Box ?

Box Trigger es el nodo que arranca un workflow cuando algo ocurre en Box. Escucha 36 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Box llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

FILE.*11
  • FILE.
    • COPIED
    • DELETED
    • DOWNLOADED
    • LOCKED
    • MOVED
    • PREVIEWED
    • RENAMED
    • RESTORED
    • TRASHED
    • UNLOCKED
    • UPLOADED
FOLDER.*8
  • FOLDER.
    • COPIED
    • CREATED
    • DELETED
    • DOWNLOADED
    • MOVED
    • RENAMED
    • RESTORED
    • TRASHED
COLLABORATION.*5
  • COLLABORATION.
    • ACCEPTED
    • CREATED
    • REJECTED
    • REMOVED
    • UPDATED
COMMENT.*3
  • COMMENT.
    • CREATED
    • DELETED
    • UPDATED
METADATA_INSTANCE.*3
  • METADATA_INSTANCE.
    • CREATED
    • DELETED
    • UPDATED
SHARED_LINK.*3
  • SHARED_LINK.
    • CREATED
    • DELETED
    • UPDATED
TASK_ASSIGNMENT.*2
  • TASK_ASSIGNMENT.
    • CREATED
    • UPDATED
WEBHOOK.*1
  • WEBHOOK.
    • DELETED

Notas de configuración

01Configure the Box TriggerEl Box Trigger arranca un flujo cuando ocurre un evento en Box. Trabaja con un webhook, una URL que Box llama en el instante en que pasa algo, así que el evento llega en segundos y no hay ninguna consulta periódica de por medio. n8n registra esa URL en Box al activar el flujo.

El Box Trigger arranca un flujo cuando ocurre un evento en Box. Trabaja con un webhook, una URL que Box llama en el instante en que pasa algo, así que el evento llega en segundos y no hay ninguna consulta periódica de por medio. n8n registra esa URL en Box al activar el flujo.

Parámetros clave

  • Events: la lista de eventos que se escuchan. Uno solo, una familia entera o los 36. No existe un comodín que los cubra todos, así que un evento sin marcar no arrancará nada.
  • Target Type: si el elemento vigilado es un archivo o una carpeta.
  • Target ID: el identificador de Box de ese elemento, que limita la escucha a un archivo o una carpeta en vez de la cuenta entera.
Cuándo usarlo
siempre que Box sea el primer sitio donde aparece el trabajo, un buzón de entrega, la carpeta de un cliente o un árbol de entregables.
02File eventsEs la familia más grande, 11 eventos, y cubre la vida entera de un documento. FILE.UPLOADED salta cuando un archivo se sube a la carpeta vigilada o se mueve hacia ella, lo que la convierte en la puerta de entrada de cualquier flujo de recepción. FILE.COPIED, FILE.MOVED y FILE.RENAMED siguen al documento que cambia de sitio o de nombre.

Es la familia más grande, 11 eventos, y cubre la vida entera de un documento. FILE.UPLOADED salta cuando un archivo se sube a la carpeta vigilada o se mueve hacia ella, lo que la convierte en la puerta de entrada de cualquier flujo de recepción. FILE.COPIED, FILE.MOVED y FILE.RENAMED siguen al documento que cambia de sitio o de nombre.

FILE.TRASHED y FILE.DELETED corresponden a un archivo que va a la papelera, y FILE.RESTORED al que sale de ella. Otros tres hablan de personas más que de almacenamiento: FILE.PREVIEWED y FILE.DOWNLOADED confirman que alguien abrió o se llevó el documento, mientras que FILE.LOCKED y FILE.UNLOCKED avisan de un bloqueo de edición puesto o retirado.

Cuándo usarlo
cadenas de recepción, rastro de auditoría sobre documentos sensibles y cualquier proceso donde la llegada de un archivo da la salida.
03Folder eventsOcho eventos repiten la misma idea un nivel más arriba. FOLDER.CREATED salta al crearse una carpeta, que suele ser la primera señal de que empieza un cliente, un proyecto o un expediente. FOLDER.COPIED, FOLDER.MOVED y FOLDER.RENAMED siguen las reorganizaciones, esas que rompen en silencio los enlaces que todo el mundo tenía guardados.

Ocho eventos repiten la misma idea un nivel más arriba. FOLDER.CREATED salta al crearse una carpeta, que suele ser la primera señal de que empieza un cliente, un proyecto o un expediente. FOLDER.COPIED, FOLDER.MOVED y FOLDER.RENAMED siguen las reorganizaciones, esas que rompen en silencio los enlaces que todo el mundo tenía guardados.

Tres eventos separan tres situaciones distintas: FOLDER.TRASHED para la papelera, FOLDER.DELETED para la eliminación definitiva y FOLDER.RESTORED para la vuelta atrás. La diferencia importa cuando el flujo del otro lado tiene que elegir entre avisar a alguien y deshacer algo. FOLDER.DOWNLOADED cierra la familia, y salta cuando alguien se descarga la carpeta completa.

Cuándo usarlo
mantener un seguimiento de proyecto alineado con el árbol de carpetas y detectar cambios de estructura antes de que lleguen los avisos de enlaces rotos.
04Collaboration and shared link eventsEstas dos familias, 5 y 3 eventos, forman la cara de los accesos. En colaboración, COLLABORATION.CREATED marca la invitación enviada, COLLABORATION.ACCEPTED y COLLABORATION.REJECTED la respuesta de la persona invitada, COLLABORATION.UPDATED un cambio de nivel de acceso y COLLABORATION.REMOVED un acceso retirado.

Estas dos familias, 5 y 3 eventos, forman la cara de los accesos. En colaboración, COLLABORATION.CREATED marca la invitación enviada, COLLABORATION.ACCEPTED y COLLABORATION.REJECTED la respuesta de la persona invitada, COLLABORATION.UPDATED un cambio de nivel de acceso y COLLABORATION.REMOVED un acceso retirado.

Los enlaces compartidos funcionan igual pero llegan más lejos: SHARED_LINK.CREATED, SHARED_LINK.UPDATED y SHARED_LINK.DELETED saltan cuando un enlace a un documento se crea, se modifica o se borra. Un enlace compartido llega más lejos que una colaboración, así que suele ser el primero que interesa vigilar.

Cuándo usarlo
para una revisión de accesos que no dependa de la memoria de nadie. Cada uno de esos ocho eventos entra en un flujo capaz de registrarlo, publicarlo en un canal o pedir a una persona que confirme que ese acceso estaba previsto. La respuesta llega con el contexto todavía reciente, no en la revisión del trimestre.
05Comment, metadata, task and webhook eventsCuatro familias pequeñas cierran la lista, 9 eventos entre las cuatro. Los comentarios aportan 3: COMMENT.CREATED, COMMENT.UPDATED y COMMENT.DELETED, útiles cuando la revisión ocurre dentro de Box y no por correo.

Cuatro familias pequeñas cierran la lista, 9 eventos entre las cuatro. Los comentarios aportan 3: COMMENT.CREATED, COMMENT.UPDATED y COMMENT.DELETED, útiles cuando la revisión ocurre dentro de Box y no por correo.

Las instancias de metadatos aportan otros 3. METADATA_INSTANCE.CREATED salta cuando una plantilla de metadatos se asocia a un archivo o una carpeta, METADATA_INSTANCE.UPDATED cuando uno de sus valores cambia y METADATA_INSTANCE.DELETED cuando la instancia desaparece. Si el equipo clasifica documentos con plantillas, esta es la familia que transporta esa señal.

Las asignaciones de tarea aportan 2, TASK_ASSIGNMENT.CREATED y TASK_ASSIGNMENT.UPDATED. Y WEBHOOK.DELETED va por libre: salta cuando se borra un webhook, el único evento que avisa de que la propia fontanería ha desaparecido.

Cuándo usarlo
cuando lo interesante de un documento no es el archivo sino lo que se escribió encima, cómo quedó clasificado o a quién se le pidió actuar. Si vuelves a sumar las ocho familias, 11 más 8 más 5 más 3 más 3 más 3 más 2 más 1, salen los 36 eventos que el trigger puede escuchar.
Acciones

¿Qué sabe hacer el nodo Box ?

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

Matriz recursos × operaciones
RecursoCreateGetUpdateDeleteCopyDownloadSearchShareUpload
File✓✓✓✓✓✓✓
Folder✓✓✓✓✓✓

File

7 operaciones
01

Copy a file

file.copy

Lo que ves en n8n

Notas y casos de uso

Duplica un archivo dentro de otra carpeta y devuelve la copia. El original se queda donde estaba.

Parámetros clave

  • File ID: obligatorio, el identificador de Box del archivo que se duplica.
  • Parent ID: la carpeta de destino. Si se deja vacío, la copia cae en la raíz, que casi nunca es la intención.
  • Name: dentro de Additional Fields, un nombre nuevo para la copia, la forma limpia de no tener dos archivos iguales.
  • Version: dentro de Additional Fields, el identificador de una versión concreta a copiar en lugar de la actual.
Casos de uso
el contrato firmado se queda en la carpeta comercial y una copia renombrada viaja a administración, que ya no abrirá el borrador por error.
02

Delete a file

file.delete

Lo que ves en n8n

Notas y casos de uso

Quita un archivo de Box desde el propio flujo, y la limpieza deja de ser una tarea de viernes por la tarde.

Parámetros clave

  • File ID: el archivo que se quita. El campo espera el identificador de Box, no el nombre del archivo, así que conviene traerlo de un paso Get o Search anterior.
Casos de uso
cada noche un flujo vacía los exports temporales que deja un proceso de informes, y la carpeta compartida sigue siendo legible para quien entra por la mañana.
03

Download a file

file.download

Lo que ves en n8n

Notas y casos de uso

Trae el contenido del archivo al flujo como datos binarios, listos para que el nodo siguiente los use.

Parámetros clave

  • Put Output File in Field: obligatorio, el nombre del campo binario de salida donde se deposita el archivo. Lo que escribas aquí es lo que tendrá que apuntar el nodo de después.
  • File ID: qué archivo se descarga.
Casos de uso
el extracto mensual guardado en Box se descarga, se adjunta a un correo y llega al cliente sin que nadie abra Box.
04

Get a file

file.get

Lo que ves en n8n

Notas y casos de uso

Lee la información de un archivo y la devuelve al flujo. Es el paso de consulta, no el del contenido.

Parámetros clave

  • File ID: el archivo que se lee.
  • Fields: dentro de Additional Fields, una lista de atributos separados por comas para incluir en la respuesta. También sirve para pedir atributos que una respuesta estándar no devuelve.
Casos de uso
tras un disparo sobre un documento, este paso reúne sus datos antes de que un nodo IF decida si el flujo sigue adelante o se detiene ahí.
06

Share a file

file.share

Lo que ves en n8n

Notas y casos de uso

Da acceso a una persona sobre un archivo concreto creando una colaboración encima de él.

Parámetros clave

  • File ID: el archivo que se comparte.
  • Accessible By: un usuario (User) o un grupo (Group).
  • Use Email: marcado, identificas a la persona por Email; desmarcado, por User ID. Los grupos van por Group ID.
  • Role: el nivel concedido, de Viewer o Previewer hasta Editor y Co-Owner, con las variantes Uploader para acceso de solo subida.
  • Expires At: dentro de Options, la fecha en la que la colaboración se retira sola.
  • Notify: si la persona recibe un correo con el aviso.
Casos de uso
un revisor externo recibe acceso Previewer a un único brief que caduca al cerrar el sprint.
07

Upload a file

file.upload

Lo que ves en n8n

Notas y casos de uso

Deja un archivo nuevo en Box, a partir de datos binarios que viajan en el flujo o de un texto construido en un paso anterior.

Parámetros clave

  • Binary File: obligatorio, indica si los datos vienen de un campo binario o de texto.
  • Input Binary Field: obligatorio con Binary File marcado, el nombre del campo binario de entrada que contiene el archivo.
  • File Content: obligatorio con Binary File desmarcado, el contenido de texto del archivo.
  • File Name: el nombre con el que se guarda, por ejemplo photo.png.
  • Parent ID: la carpeta de destino. Sin él, la raíz.
Casos de uso
una factura sacada del correo aterriza en la carpeta del mes.

Folder

6 operaciones
08

Create a folder

folder.create

Lo que ves en n8n

Notas y casos de uso

Crea una carpeta y la devuelve, de modo que el flujo va levantando su propio orden sobre la marcha.

Parámetros clave

  • Name: obligatorio, el nombre de la carpeta.
  • Parent ID: la carpeta padre. Vacío, se crea en la raíz.
  • Access: dentro de Options, Collaborators solo acepta direcciones de colaboradores registrados y Open acepta cualquier dirección.
  • Fields: dentro de Options, los atributos extra que se incluyen en la respuesta.
Casos de uso
una oportunidad nueva en el CRM levanta su árbol en Box en el mismo minuto, con el nombre de la oportunidad, para que el primer documento ya tenga sitio.
09

Delete a folder

folder.delete

Lo que ves en n8n

Notas y casos de uso

Elimina una carpeta de Box. Que se lleve o no su contenido es una decisión que tomas en el nodo.

Parámetros clave

  • Folder ID: la carpeta que se elimina.
  • Recursive: desmarcado, una carpeta con contenido no se borra; marcado, se van la carpeta y todo lo que hay dentro. Merece una segunda lectura antes de activar el flujo.
Casos de uso
el árbol de pruebas creado para una validación se desmonta al terminarla, en modo recursivo, para no dejar restos que confundan a la siguiente persona.
10

Get a folder

folder.get

Lo que ves en n8n

Notas y casos de uso

Recupera la ficha de una carpeta y se la pasa al resto del flujo.

Parámetros clave

  • Folder ID: la carpeta que se lee. Son los dígitos que Box enseña en la URL, no el nombre con el que la llama el equipo.
Casos de uso
antes de subir nada, el flujo comprueba que la carpeta de destino sigue existiendo y, si ya no está, deriva hacia Create a folder. También es la vía más rápida para confirmar que un credential tiene acceso real al árbol que crees.
12

Share a folder

folder.share

Lo que ves en n8n

Notas y casos de uso

Abre una carpeta entera a una persona o a un grupo, y todo lo que hay dentro va detrás.

Parámetros clave

  • Folder ID: la carpeta que se comparte.
  • Accessible By: User o Group, con Email, User ID o Group ID según Use Email.
  • Role: Viewer para lectura, Uploader para solo subir, Editor para lectura y escritura completas, Co-Owner por encima.
  • Can View Path: dentro de Options, si la persona invitada ve la ruta padre por encima de la carpeta. No le da ningún permiso ahí arriba, solo visibilidad.
Casos de uso
la llegada de un colaborador externo da a su grupo acceso Viewer a la carpeta de documentación desde el primer día.
13

Update a folder

folder.update

Lo que ves en n8n

Notas y casos de uso

Cambia los ajustes, el nombre o el sitio de una carpeta sin tocar lo que contiene.

Parámetros clave

  • Folder ID: obligatorio, la carpeta que se actualiza.
  • Name y Description: dentro de Update Fields, el nombre nuevo y la descripción opcional.
  • Parent ID: dentro de Update Fields, un padre nuevo, lo que mueve la carpeta o la saca de la papelera.
  • Is Collaboration Restricted To Enterprise: limita las invitaciones nuevas a gente de la empresa, sin tocar las colaboraciones que ya existen.
Casos de uso
una carpeta de proyecto cerrado se renombra con su fecha de fin y pasa bajo el padre de archivo, todo en un paso.
Necesitas ayuda

¿Necesitas ayuda para automatizar Box con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Box y n8n, las dudas de siempre

01¿La integración Box n8n es gratuita?
Sí por el lado de n8n. El nodo Box y el Box Trigger vienen incluidos con n8n, así que no hay nada que instalar ni nada extra que pagar por el conector. Vale igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en los dos sitios, de modo que puedes montarlo en uno y llevártelo al otro sin reescribirlo. Lo que cuesta la cuenta de Box es otra historia, depende de tu plan con Box y esta página no entra ahí.
02¿Qué credenciales hacen falta para conectar Box con n8n?
Una cuenta de Box y un credential de Box en n8n, autenticado con OAuth2. Es el único método de autenticación admitido aquí, así que no hay ningún campo donde pegar una clave de API: apruebas el acceso en Box desde el navegador y n8n conserva la conexión. Si quieres montar ese flujo desde cero, Box pide crear una Custom App y documenta cada paso del recorrido de OAuth en web. Un solo credential cubre los dos nodos, el nodo Box y el Box Trigger, y cada flujo posterior lo escoge de una lista en vez de repetir la configuración.
03¿Qué límites tiene el nodo Box en n8n?
Hay dos cosas que marcan lo que recibes. La primera es la paginación de las búsquedas: con Return All desmarcado el nodo se detiene en la cifra escrita en Limit, y marcado n8n sigue pidiendo páginas hasta traerlo todo, lo que hace falta para un export completo y lo que conviene evitar dentro de un bucle. La segunda es el alcance: el nodo expone 13 operaciones sobre archivos y carpetas. Lo que queda fuera de esas operaciones pasa por el nodo HTTP Request, que llama a cualquier endpoint de la API de Box reutilizando el mismo credential mediante la autenticación predefinida.
04¿El Box Trigger reacciona en tiempo real?
Sí, funciona por webhook, es decir, una URL que Box llama en el instante en que ocurre el evento. El flujo arranca en segundos. n8n registra esa URL en Box al activar el flujo, así que no hay ninguna frecuencia que configurar ni ningún intervalo que ajustar. Eliges cuáles de los 36 eventos quieres escuchar en el campo Events y puedes reducir la vigilancia a un solo elemento con Target Type y Target ID. No existe comodín que los cubra todos, de manera que un evento sin marcar nunca arrancará nada. Conviene recordarlo el día que un disparo esperado no llega.
05¿n8n o Make para automatizar Box?
Depende de dónde quieras que corra el flujo y de cómo prefieras pagarlo. Make es una plataforma alojada, sin opción de autoalojamiento, facturada por operación, así que la factura sigue al volumen. n8n corre en Cloud o en tu propio servidor con Docker o npm, y el flujo es idéntico en ambos casos, algo que pesa cuando los documentos llevan datos de clientes que prefieres mantener en una infraestructura tuya. Las dos ofrecen lógica visual. Con un volumen bajo y estable, pagar por operación resulta sencillo. Si el volumen crece o los datos son sensibles, el autoalojamiento cambia las cuentas.