Automatiser avec n8n

n8n est un outil d'automatisation de workflows — le cousin auto-hébergeable et européen de Zapier. Combiné aux webhooks et à l'API de Bueggio HR, il automatise sans code les corvées RH autour des absences : relayer les validations vers d'autres outils, exporter les absences dans un tableur, alerter un canal quand quelqu'un est absent.

Comment les pièces s'assemblent

• Déclencheurs — un nœud Webhook n8n reçoit les événements webhook de Bueggio HR (demande créée, approuvée, refusée, annulée, arrivées et départs).
• Actions — un nœud HTTP Request n8n appelle l'API REST avec une clé API : lire qui est absent, les soldes, voire réserver et approuver.
• Auto-enregistrement — un workflow peut enregistrer sa propre URL de déclenchement via POST /api/v1/webhooks à l'activation, rien à configurer à la main.

Partir d'un modèle

Réglages → Intégrations → n8n propose des workflows prêts à l'emploi à télécharger et importer (dans n8n : menu Workflow → Import from file) :

• Récapitulatif hebdomadaire « qui est absent » — chaque lundi, récupère les absences de la semaine via l'API et publie un résumé où vous voulez.
• Congés approuvés vers un tableur — chaque demande approuvée est ajoutée à une feuille Google Sheets, pratique pour la paie.

Après l'import, réglez deux choses dans le workflow : votre clé API Bueggio HR dans les identifiants du nœud HTTP, et la destination (nœud Slack, identifiants Google Sheets, …).

Brancher un déclencheur à la main

1. Dans n8n, ajoutez un nœud Webhook et copiez son URL de production.
2. Dans Bueggio HR, allez dans Réglages → Intégrations → Webhooks, ajoutez l'URL et cochez les événements utiles au workflow.
3. Utilisez Envoyer un ping de test pour émettre un événement d'essai et vérifiez qu'il atteint le journal d'exécution de n8n.
4. Optionnel : vérifiez l'en-tête webhook-signature dans un nœud Code — le schéma de signature est Standard Webhooks.

Des idées qui marchent bien

• Prévenir un canal Matrix/Discord/Telegram quand un congé est approuvé (n8n a des nœuds pour les trois).
• Exporter les absences du mois en CSV pour le prestataire de paie.
• Créer une tâche dans votre outil de projet quand quelqu'un pose plus d'une semaine.

Dépannage

• Le déclencheur ne part jamais — les URL de test n8n n'écoutent que pendant vos essais ; enregistrez l'URL de production dans Bueggio HR et activez le workflow.
• Les appels API répondent 401 — le nœud HTTP doit envoyer Authorization: Bearer bhr_... ; vérifiez que la clé n'a pas été révoquée.
• Les livraisons échouent dans le journal — votre instance n8n doit être joignable depuis internet en HTTPS ; tunnels et localhost ne reçoivent pas les webhooks de production.