Automatizza con n8n

n8n è uno strumento di automazione dei flussi di lavoro — il cugino self-hosted ed europeo di Zapier. Combinato con i webhook e l'API di Bueggio HR, automatizza senza codice le incombenze HR legate alle assenze: rilanciare le approvazioni su altri strumenti, esportare le assenze in un foglio di calcolo, avvisare un canale quando qualcuno è fuori.

Come si incastrano i pezzi

• Trigger — un nodo Webhook di n8n riceve gli eventi webhook di Bueggio HR (richiesta creata, approvata, rifiutata, annullata, persone che entrano o escono).
• Azioni — un nodo HTTP Request di n8n chiama l'API REST con una chiave API: leggere chi è assente, i saldi, o perfino prenotare e approvare.
• Auto-registrazione — un workflow può registrare da solo il proprio URL trigger via POST /api/v1/webhooks all'attivazione, così non c'è nulla da configurare a mano.

Parti da un template

Impostazioni → Integrazioni → n8n offre workflow già pronti da scaricare e importare (in n8n: menu Workflow → Import from file):

• Riepilogo settimanale "chi è assente" — ogni lunedì recupera le assenze della settimana dall'API e pubblica un riassunto dove preferisci.
• Assenze approvate su foglio di calcolo — ogni richiesta approvata viene aggiunta a un Google Sheet, comodo per le paghe.

Dopo l'import, imposta due cose nel workflow: la tua chiave API di Bueggio HR nelle credenziali del nodo HTTP e la destinazione (nodo Slack, credenziali Google Sheets, …).

Collega un trigger a mano

1. In n8n, aggiungi un nodo Webhook e copia il suo URL di produzione.
2. In Bueggio HR, vai in Impostazioni → Integrazioni → Webhook, aggiungi l'URL e spunta gli eventi che interessano al workflow.
3. Usa Invia ping di prova per lanciare un evento di test e verifica che arrivi nel log esecuzioni di n8n.
4. Facoltativo: verifica l'header webhook-signature in un nodo Code — lo schema di firma è Standard Webhooks.

Idee che funzionano bene

• Avvisare un canale Matrix/Discord/Telegram quando un'assenza viene approvata (n8n ha nodi per tutti e tre).
• Esportare le assenze del mese in CSV per il consulente paghe.
• Creare un task nel tuo strumento di progetto quando qualcuno prenota più di una settimana.

Problemi comuni

• Il trigger non scatta mai — gli URL di test di n8n ascoltano solo mentre stai testando; registra in Bueggio HR l'URL di produzione e attiva il workflow.
• Le chiamate API rispondono 401 — il nodo HTTP deve inviare Authorization: Bearer bhr_...; controlla che la chiave non sia stata revocata.
• Le consegne falliscono nel log — la tua istanza n8n deve essere raggiungibile da internet in HTTPS; tunnel e localhost non ricevono i webhook di produzione.