CRM y automatización

n8n 3.0: qué revisar antes de actualizar tus flujos

Por Edgar Jaimes 4 min de lectura

Computador portátil sobre un escritorio de madera con código abierto en pantalla

n8n 3.0 trae cambios que rompen flujos: nodos eliminados, Docker obligatorio y nuevas variables. Revisa esta lista antes de actualizar tu automatización.

Tienes un flujo que lleva meses pasando los leads del formulario al CRM sin fallar. Un viernes alguien actualiza n8n “para tener lo último”, y el lunes el flujo no arranca porque usaba un nodo que ya no existe. Con una versión mayor como la 3.0, ese riesgo es real.

Esta guía resume lo que la documentación oficial pide revisar, para que actualices con calma y no con sorpresas.

¿Qué es n8n 3.0 y por qué importa?

Es una versión mayor de n8n que elimina nodos antiguos, cambia configuraciones por defecto y exige un despliegue distinto para quien lo aloja por su cuenta. La página de cambios de la versión 3.0 indica que, por ahora, es un lanzamiento de acceso anticipado y no da una fecha de salida. Por eso conviene prepararse ahora y no apurarse a actualizar.

Si todavía no usas la herramienta, empieza por qué es n8n y cómo automatiza sin código.

Computador portátil con código en pantalla junto a una planta sobre un escritorio
Antes de tocar producción, revisa qué partes de tus flujos dependen de piezas antiguas. Foto: Unsplash

¿Cómo sé qué flujos se romperán?

Abre Settings > Migration Report en tu instancia. Según la documentación de n8n, ese informe lista los flujos y los ajustes que necesitan atención antes de actualizar, y además puede migrar algunos flujos, como los que usan los nodos AI Transform y Edit Image antiguos.

Hazlo como primer paso y guarda el resultado: es tu lista de tareas pendientes.

Error común: actualizar directamente la instancia de producción. Prueba primero en una copia, con tus flujos importados, y confirma que los más importantes (leads, cobros, avisos) siguen corriendo.

¿Qué nodos y funciones desaparecen?

Desaparecen varios nodos antiguos, y los flujos que los usan fallan al ejecutarse. La documentación aclara que los flujos publicados con un nodo eliminado ni siquiera se activan al iniciar. Estos son algunos de los cambios más relevantes:

Qué cambiaQué debes hacer
Nodos Function y Function Item, Cron e Interval, HTML Extract, Read PDF y otrosCambia cada uno por el reemplazo que indica la documentación
AI Agent versión 1 y sus modos antiguosUsa Tools Agent en su última versión
Nodos antiguos de OpenAIReemplázalos por los nodos vigentes
Execute Sub-workflow con origen Local File o URLUsa el origen Database o Define Below
Edit Image versiones 1 y 1.1Pasa a la versión 2, que puede cambiar el resultado

Si tu automatización usa agentes de IA, revisa también cómo escribir buenas instrucciones para tu agente, porque al migrar de versión conviene volver a probarlas.

¿Qué cambia si tengo n8n autoalojado?

Tienes que usar un despliegue con Docker: la documentación indica que las instalaciones con npm y npx n8n dejan de ser compatibles. Además hay cambios de configuración que conviene anotar:

  • La carpeta ~/.n8n/binaryData pasa a llamarse ~/.n8n/storage, y n8n no arranca si existen las dos.
  • N8N_RUNNERS_TASK_TIMEOUT baja de 300 a 60 segundos.
  • La rotación de la clave de cifrado viene activada por defecto.
  • La credencial de Slack API exige un signing secret, y un flujo con Slack Trigger no se publica hasta que lo agregues.
Cables de red azules conectados a un panel de conexiones numerado
El servidor donde vive tu automatización también cambia: en 3.0 pasa a Docker. Foto: Unsplash

¿Qué comportamientos cambian sin avisar?

Algunos flujos no fallan, pero se comportan distinto. Son los más peligrosos porque nadie ve un error. La documentación menciona, por ejemplo, que el nodo Gmail Trigger omite borradores salvo que actives Include Drafts, y que los correos enviados o programados ya no disparan el flujo. También cambia cómo responde Always Output Data en nodos con varias salidas, como If y Switch.

Por eso conviene tener avisos cuando un flujo de n8n falla antes de migrar, y no después.

¿Cómo actualizo con seguridad?

Sigue este orden: informe, copia, prueba y solo entonces producción.

  1. Abre Settings > Migration Report y anota lo pendiente.
  2. Haz una copia de tu instancia y de tus credenciales.
  3. Corrige o reemplaza los nodos eliminados en la copia.
  4. Ejecuta los flujos críticos con datos de prueba.
  5. Actualiza producción en un horario de poco tráfico, con alguien pendiente.

Si tus flujos dependen de llamadas entre sistemas, repasa también qué son los webhooks y cómo usarlos con n8n.

En resumen

n8n 3.0 no es una actualización para hacer un viernes por la tarde. Es como el flujo del lunes que no arrancó: lo que hoy funciona puede depender de una pieza que ya no existe. Revisa el informe de migración, prueba en una copia y actualiza con un plan. Si prefieres que alguien lo haga por ti, conoce nuestro servicio de automatización con n8n.

Preguntas frecuentes

¿Qué es n8n 3.0?

Es una versión mayor de n8n con cambios que rompen compatibilidad. La documentación oficial la describe como una versión de acceso anticipado y lista los cambios que debes revisar antes de actualizar.

¿Cómo sé si mis flujos se verán afectados?

Abre Settings > Migration Report. Según la documentación de n8n, ese informe lista los flujos y ajustes de tu instancia que necesitan atención, y puede migrar algunos flujos, como los de AI Transform y Edit Image.

¿Qué pasa con las instalaciones por npm?

La documentación indica que n8n autoalojado debe usar un despliegue con Docker. Las instalaciones con npm y npx n8n dejan de ser compatibles.

¿Qué pasa con un flujo que usa un nodo eliminado?

Según la documentación, los flujos con nodos eliminados fallan al ejecutarse y los publicados dejan de activarse al iniciar la instancia.

¿Debo actualizar de inmediato?

No. Primero revisa el informe de migración, prueba en una copia de la instancia y recién después actualiza producción.

No te quedes con la teoría: aplícalo a tu negocio

Implementamos Automatización con n8n de punta a punta, con tu operación real. La primera conversación no tiene costo.

Sigue leyendo