Introducción Node JS & Webhooks

Node.js es un entorno de ejecución para JavaScript que permite utilizar este lenguaje tanto en el backend como en el frontend de una aplicación. Una de sus características más destacadas es su naturaleza asíncrona, lo que permite realizar operaciones de entrada y salida de manera más eficiente.

¿Qué es un Webhook?

Un webhook es una técnica para permitir que una aplicación reciba notificaciones automáticas en respuesta a ciertos eventos. A diferencia de las API tradicionales, donde una aplicación consulta activamente por información, los webhooks permiten que el servidor envíe datos a la aplicación en el momento en que ocurre un evento específico.

Requisitos Previos

Antes de sumergirnos en el código, hay algunos requisitos que deben cumplirse:

1. Instalar Node.js: Es recomendable tener la última versión de Node.js.
2. Abrir el puerto 3000: Asegúrese de que este puerto esté abierto en su firewall.
3. Repositorio Git: Necesitaremos un repositorio para la demostración de hoy.

Configuración Inicial

Para comenzar, vamos a crear una aplicación simple de Node.js que escuchará en el puerto 3000 y reaccionará a las solicitudes POST en la ruta /hook.

const express = require('express');
const app = express();

app.use(express.json());

const PORT = 3000;

app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
});

app.post('/hook', (req, res) => {
  console.log(req.body);
  res.status(200).send('OK');
});

Configuración del Webhook en GitHub

Vamos a configurar un webhook en GitHub para que nuestra aplicación reciba notificaciones cada vez que se haga un push al repositorio.

1. Acceder a la configuración del repositorio: Vamos a la sección de «Webhooks» en el panel izquierdo.
2. Agregar un nuevo webhook: Ingresamos la URL de nuestra aplicación (http://tu-servidor:3000/hook) y seleccionamos «application/json» como el tipo de contenido.
3. Seleccionar eventos: Podemos optar por recibir notificaciones para todos los eventos o elegir eventos específicos, como push.

Probando la Configuración

Para probar que todo está funcionando correctamente, vamos a realizar un pequeño cambio en nuestro repositorio, hacer un commit y un push. Nuestra aplicación debería recibir una solicitud POST con los detalles del commit.

app.post('/hook', (req, res) => {
  console.log(req.body);
  res.status(200).send('OK');
});

Al hacer el push, veremos en la consola de nuestra aplicación los detalles del commit.

Usos Prácticos de los Webhooks

Los webhooks tienen una amplia variedad de aplicaciones prácticas. Por ejemplo:

• Procesamiento de pagos: Plataformas como MercadoPago pueden enviar notificaciones cuando se procesa un pago.
• Marketing por correo electrónico: Herramientas como Envíalo Simple pueden notificar cuando un usuario se suscribe o se desuscribe.

Conclusión

Hoy hemos visto cómo configurar una aplicación básica de Node.js que responde a webhooks y cómo integrar esta funcionalidad con GitHub. Los webhooks son una herramienta poderosa para crear aplicaciones interactivas y conectadas, y esperamos que esta introducción les haya sido útil.