Automatiza con n8n

n8n es una herramienta de automatización de flujos de trabajo — el primo europeo y auto-hospedable de Zapier. Combinado con los webhooks y la API de Bueggio HR, automatiza sin código las tareas de RR. HH. alrededor de las ausencias: reenviar aprobaciones a otras herramientas, exportar ausencias a una hoja de cálculo, avisar a un canal cuando alguien está fuera.

Cómo encajan las piezas

• Disparadores — un nodo Webhook de n8n recibe los eventos webhook de Bueggio HR (solicitud creada, aprobada, rechazada, cancelada, altas y bajas de personas).
• Acciones — un nodo HTTP Request de n8n llama a la API REST con una clave API: leer quién está fuera, los saldos, o incluso reservar y aprobar.
• Auto-registro — un flujo puede registrar su propia URL de disparo vía POST /api/v1/webhooks al activarse, sin configurar nada a mano.

Empieza con una plantilla

Ajustes → Integraciones → n8n ofrece flujos listos para descargar e importar (en n8n: menú Workflow → Import from file):

• Resumen semanal de "quién está fuera" — cada lunes recupera las ausencias de la semana desde la API y publica un resumen donde quieras.
• Ausencias aprobadas a una hoja de cálculo — cada solicitud aprobada se añade a un Google Sheet, útil para nóminas.

Tras importar, configura dos cosas en el flujo: tu clave API de Bueggio HR en las credenciales del nodo HTTP y el destino (nodo de Slack, credenciales de Google Sheets, …).

Conecta un disparador a mano

1. En n8n, añade un nodo Webhook y copia su URL de producción.
2. En Bueggio HR, ve a Ajustes → Integraciones → Webhooks, añade la URL y marca los eventos que le interesan al flujo.
3. Usa Enviar ping de prueba para lanzar un evento de prueba y comprueba que llega al registro de ejecuciones de n8n.
4. Opcional: verifica la cabecera webhook-signature en un nodo Code — el esquema de firma es Standard Webhooks.

Ideas que funcionan bien

• Avisar a un canal de Matrix/Discord/Telegram cuando se aprueba una ausencia (n8n tiene nodos para los tres).
• Exportar las ausencias del mes a CSV para la gestoría.
• Crear una tarea en tu herramienta de proyectos cuando alguien reserva más de una semana.

Solución de problemas

• El disparador nunca salta — las URL de prueba de n8n solo escuchan mientras estás probando; registra en Bueggio HR la URL de producción y activa el flujo.
• Las llamadas a la API devuelven 401 — el nodo HTTP debe enviar Authorization: Bearer bhr_...; comprueba que la clave no fue revocada.
• Las entregas fallan en el registro — tu instancia de n8n debe ser accesible desde internet por HTTPS; los túneles y localhost no reciben webhooks de producción.