LinuxParty

Continuación del artículo...
Segundo ejemplo: recibir un Webhook y guardar los datos en MariaDB

Hasta ahora hemos creado una automatización que funciona por sí sola cada cierto tiempo.

Pero ¿qué ocurre si queremos que sea otra aplicación quien "despierte" a n8n?

Aquí es donde aparecen los Webhooks.

Un Webhook no es más que una dirección HTTP especial que permanece esperando peticiones.

Cada vez que alguien envía información a esa dirección, n8n ejecuta automáticamente el Workflow asociado.

En otras palabras, un Webhook convierte n8n en un pequeño servidor capaz de recibir información desde prácticamente cualquier aplicación.

¿Qué es realmente un Webhook?

Aunque el nombre pueda parecer complicado, entender un Webhook es mucho más sencillo de lo que parece.

La palabra está formada por dos términos ingleses:

• Web, porque funciona a través de HTTP o HTTPS.
• Hook, que significa literalmente gancho, percha o punto de enganche.

Imagina que colocas un gancho en la pared.

Ese gancho no hace nada por sí solo.

Simplemente está ahí... esperando.

En el momento en que alguien cuelga una chaqueta, una mochila o unas llaves, el gancho entra en acción porque ahora tiene algo que sostener.

Con un Webhook ocurre exactamente lo mismo.

Un Webhook es un gancho web al que otras aplicaciones "cuelgan" información para que n8n haga algo con ella.

¿Para qué sirve un Webhook?

Muchísimo más de lo que parece.

Por ejemplo:

• WordPress puede avisarnos cuando se publique una noticia.
• Dolibarr puede notificar la creación de una factura.
• Un servidor Linux puede informar de que una copia de seguridad ha finalizado.
• Un formulario web puede enviar automáticamente los datos de un cliente.

Todos estos sistemas utilizan exactamente el mismo mecanismo.

Una petición HTTP.

Nuestro segundo ejemplo

Supongamos que queremos guardar automáticamente los datos recibidos en una base de datos MariaDB.

Nuestro Workflow será muy sencillo.

HTTP
        │
        ▼
Webhook
        │
        ▼
Editar datos
        │
        ▼
MariaDB

Paso 1

Creamos un Workflow nuevo.

Lo llamaremos:

Guardar datos recibidos por Webhook

Paso 2

Añadimos el nodo

Webhook

Configuramos:

Método:

POST

Ruta:

clientes

n8n mostrará automáticamente una URL similar a ésta:

http://servidor:5678/webhook/clientes

Ésa será la dirección donde otras aplicaciones enviarán información.

Paso 3

Probar el Webhook

Podemos hacerlo desde otra máquina utilizando simplemente curl.

curl \
-X POST \
-H "Content-Type: application/json" \
-d '{
"nombre":"Juan",
"ciudad":"Plasencia",
"edad":42
}' \
http://servidor:5678/webhook/clientes

Si todo funciona correctamente veremos inmediatamente cómo el Workflow comienza a ejecutarse.

Una de las cosas que más sorprenden cuando se utiliza n8n por primera vez es precisamente ésta.

No hace falta escribir un servidor web.

No hace falta programar PHP.

No hace falta crear una API.

El propio n8n hace todo ese trabajo.

Paso 4

Guardar la información

Añadimos ahora un nodo:

MariaDB

Creamos las credenciales.

Servidor:

localhost

Puerto

3306

Base de datos

automatizaciones

Usuario

n8n

Contraseña

********

Después elegimos:

Insert

Tabla

clientes

Y asignamos los campos.

nombre

{{ $json.nombre }}

ciudad

{{ $json.ciudad }}

edad

{{ $json.edad }}

Cada petición HTTP insertará automáticamente un registro.

¿Qué hemos aprendido?

Con este ejemplo ya conocemos uno de los pilares de n8n.

Los Webhooks.

Gracias a ellos cualquier aplicación capaz de realizar una petición HTTP puede comunicarse con n8n.

Esto abre la puerta a cientos de integraciones.

WordPress.

Joomla.

Dolibarr.

GitHub.

GitLab.

Proxmox.

Nextcloud.

Home Assistant.

Prácticamente cualquier aplicación moderna dispone hoy de algún tipo de Webhook.

Tercer ejemplo

Monitorizar un servidor Linux y recibir una alerta en Telegram

Éste sí es un ejemplo muy orientado al lector habitual de LinuxParty.

Imaginemos un servidor Linux donde queremos comprobar periódicamente el espacio disponible.

Si el disco supera el 90 %, deseamos recibir una notificación.

El Workflow será:

Schedule Trigger
        │
        ▼
SSH
        │
        ▼
df -h
        │
        ▼
IF
        │
     Sí
        │
        ▼
Telegram

Paso 1

Añadimos un

Schedule Trigger

Configuración.

Cada 5 minutos

Paso 2

Nodo

SSH

Creamos las credenciales.

Servidor

192.168.1.10

Usuario

root

o, preferiblemente, un usuario con los permisos estrictamente necesarios.

Autenticación:

• contraseña, o mejor aún,
• clave SSH.

Paso 3

Comando

df -h /

Obtendremos una salida similar a ésta.

Filesystem      Size Used Avail Use%

/dev/sda3       80G 65G 15G 81%

Paso 4

Nodo

IF

Condición.

Uso

>

90

Si supera ese porcentaje...

Continuamos.

Paso 5

Nodo

Telegram

Configuramos nuestro Bot.

Mensaje.

⚠ Atención.

El servidor srv-web01 ha superado el 90 % de utilización del disco.

Espacio utilizado:

{{ $json.use }}

Revise el sistema lo antes posible.

Cada vez que el disco alcance el umbral definido recibiremos un aviso inmediato en Telegram.

¿Por qué Telegram?

Porque es rápido.

Gratuito.

Muy sencillo de configurar.

Y funciona perfectamente tanto en Linux como en Android, iPhone o escritorio.

Naturalmente podríamos sustituir Telegram por:

• correo electrónico;
• Slack;
• Discord;
• WhatsApp;
• Microsoft Teams.

El resto del Workflow seguiría siendo exactamente igual.

Lo que hemos aprendido

Durante estos tres ejemplos hemos utilizado buena parte de los componentes fundamentales de n8n.

Con sólo estos nodos ya podemos construir decenas de automatizaciones diferentes.

Consejos para empezar

Antes de crear automatizaciones complejas conviene seguir algunas recomendaciones:

• Utiliza nombres descriptivos para cada Workflow.
• Agrupa las credenciales por servicios y reutilízalas.
• Prueba siempre los Workflows manualmente antes de activarlos.
• Exporta una copia de seguridad en formato JSON cada vez que completes una automatización importante.
• Documenta con notas los nodos más complejos; dentro de unos meses agradecerás recordar por qué los configuraste de determinada manera.
• Si un Workflow crece demasiado, divídelo en procesos más pequeños y reutilizables.

Estas pequeñas prácticas facilitan enormemente el mantenimiento cuando el número de automatizaciones comienza a aumentar.

Cinco ideas para seguir practicando

Ahora que ya conoces los conceptos básicos, puedes intentar crear tus propios Workflows.

Por ejemplo:

• Reiniciar Apache automáticamente cuando deje de responder.
• Comprobar diariamente la caducidad de los certificados SSL y avisar cuando queden menos de 30 días.
• Vigilar /var/log/secure o /var/log/auth.log y enviar un resumen de intentos fallidos de autenticación.
• Comprobar el espacio disponible en las copias de seguridad antes de iniciarlas.
• Publicar automáticamente una noticia en WordPress cuando aparezca un nuevo documento en un directorio.

Como verás, las posibilidades son prácticamente ilimitadas.

En la tercera parte…

Hasta ahora hemos aprendido a instalar n8n y a construir nuestros primeros Workflows.

En la tercera y última entrega daremos un paso más y veremos casos reales utilizados por administradores de sistemas:

• Automatizar copias de seguridad completas.
• Gestionar usuarios Linux y servidores mediante SSH.
• Integrar n8n con Dolibarr utilizando su API REST.
• Conectar con WordPress para automatizar publicaciones.
• Sincronizar archivos con Nextcloud.
• Interactuar con Proxmox para gestionar máquinas virtuales y contenedores.
• Crear flujos reutilizables para la administración diaria de infraestructuras.

Llegados a ese punto, n8n dejará de ser una simple herramienta de automatización para convertirse en un auténtico centro de operaciones capaz de coordinar servidores, aplicaciones y servicios desde una única interfaz.

Conclusión

En esta segunda parte hemos descubierto que n8n va mucho más allá de ejecutar tareas programadas. Gracias a los Webhooks puede recibir información desde aplicaciones externas; mediante SSH puede administrar servidores Linux; con los conectores de bases de datos puede almacenar información; y utilizando servicios como Telegram o el correo electrónico es capaz de mantenernos informados en tiempo real.

Lo más interesante es que todos estos componentes se combinan mediante una interfaz visual, permitiendo construir automatizaciones complejas sin necesidad de desarrollar aplicaciones completas desde cero.

Con esta base ya estamos preparados para abordar escenarios de producción reales, donde n8n puede convertirse en una pieza fundamental para simplificar el trabajo diario de cualquier administrador Linux o responsable de infraestructura.

Repositorio oficial de plantillas y ejemplos (Workflow Templates): https://n8n.io/workflows/

Repositorio oficial de la comunidad en GitHub: https://github.com/n8n-io/n8n

Y, si quieres profundizar en la documentación oficial:

• Documentación oficial de n8n: https://docs.n8n.io/

Con esos tres enlaces tendrán prácticamente todo lo necesario para seguir aprendiendo.

[ Parte 1 ], [ Parte 2 ] y [ Parte 3 ]