Webhooks: automazioni di eventi in tempo reale
I webhook sono una delle funzionalità tecniche più apprezzate dai team IT in ambienti enterprise. Permettono a Sesame HR di notificare automaticamente i sistemi esterni quando si verificano eventi rilevanti all'interno della piattaforma.
Un webhook è una notifica HTTP automatica (POST) che Sesame HR invia a un URL configurato dall'amministratore quando si verifica un determinato evento. A differenza delle interrogazioni periodiche all'API (polling), i webhook permettono di reagire agli eventi in tempo reale, senza necessità di interrogazioni costanti.
|
⚡ Polling vs. Webhooks: Polling: il tuo sistema interroga periodicamente Sesame → Maggior consumo di risorse, possibile latenza. Webhooks: Sesame notifica il tuo sistema quando si verifica un evento → tempo reale, efficiente, senza interrogazioni superflue. |
Eventi supportati
Sesame HR può inviare notifiche webhook per le seguenti tipologie di eventi:
Evento |
Descrizione |
Assunzione dipendente |
Viene creata una nuova scheda del dipendente su Sesame HR. |
Cessazione dipendente |
Un dipendente viene disattivato o eliminato dal sistema. |
Cambio di dipartimento |
Un dipendente viene riassegnato a un dipartimento o ufficio diverso. |
Richieste di assenza |
Un dipendente richiede ferie o un'assenza. |
Approvazione assenza |
Un responsabile approva o rifiuta una richiesta di assenza. |
Registro di timbratura |
Viene effettuato un clock-in o clock-out di un dipendente. |
Cambio contrattuale |
Viene modificato o creato un contratto, uno stipendio o una compensazione. |
Processo di onboarding |
Viene avviato o completato un processo di inserimento di un dipendente. |
Come funzionano
Il flusso di un webhook in Sesame HR segue questi passaggi:
- Configurazione: l'amministratore registra un URL di destinazione e seleziona gli eventi che desidera ricevere dal pannello di Sesame HR.
- Evento: quando si verifica un evento sottoscritto (ad esempio, un'assunzione di dipendente), Sesame genera un payload JSON con i dati dell'evento.
- Notifica: Sesame invia una richiesta HTTP POST all'URL configurato con il payload dell'evento.
- Elaborazione: il sistema ricevente elabora la notifica ed esegue le azioni corrispondenti (creare un utente in AD, aggiornare l'ERP, ecc.).
Esempio di payload di un webhook di assunzione dipendente:
|
POST https://il-tuo-sistema.com/webhooks/sesame Content-Type: application/json
{ "event": "employee.created", "timestamp": "2026-03-11T10:30:00Z", "data": { "employeeId": "uuid-del-empleado", "firstName": "Carlos", "lastName": "Martínez", "email": "carlos.martinez@azienda.com", "departmentId": "uuid-dipartimento", "startDate": "2026-04-01" } } |
Casi d'uso enterprise
I webhook di Sesame HR permettono di automatizzare flussi critici nelle grandi organizzazioni. Ecco gli scenari più frequenti:
Provisioning automatico IT
Quando viene registrato un nuovo dipendente, il webhook notifica il sistema IT per effettuare automaticamente il provisioning dei suoi accessi: account email, licenze software, credenziali VPN e dotazione informatica. Questo riduce i tempi di onboarding da giorni a minuti.
Aggiornamento dell'ERP in tempo reale
Ogni volta che cambia la struttura organizzativa (nuovo dipartimento, cambio di ufficio, riassegnazione di un dipendente), il webhook aggiorna automaticamente l'ERP aziendale, mantenendo la coerenza dei dati tra i sistemi.
Automatizzazione con Zapier o Make
Collega i webhook di Sesame HR con piattaforme di automatizzazione come Zapier o Make (Integromat) per attivare flussi di lavoro complessi. Ad esempio: quando viene approvata una richiesta di ferie, inviare una notifica al team, aggiornare il calendario condiviso e adeguare la pianificazione dei turni.
Notifiche di compliance
Configura i webhook per allertare il team di compliance quando si verificano anomalie nel controllo orario, modifiche contrattuali al di fuori dei parametri abituali o assenze non giustificate.