Webhooks

I Webhooks consentono a Shifton di inviare notifiche in tempo reale ai sistemi esterni quando si verificano eventi nella vostra azienda.

Istruzioni passo passo

Accesso alla scheda Webhooks

Nel pannello laterale sinistro, fare clic su Integrazioni.

Passare alla pagina Sviluppatore → scheda Webhook.

Creazione di un nuovo webhook

Fare clic su «Nuovo webhook».

Compilare la configurazione:

Campo	Descrizione
URL	Endpoint per la ricezione dei dati degli eventi
Eventi	Eventi di Shifton che attivano il webhook
Attivo	Interruttore di attivazione/disattivazione

Salva. Shifton invierà richieste HTTP POST all’URL indicato.

Gestione dei webhooks

Fare clic su un webhook per modificare l’URL, aggiornare gli eventi o cambiare lo stato di attività.

Test del webhook

Attivare l’evento corrispondente in Shifton (ad esempio, creare un Turno di prova).

Verificare i log del server — i dati dovrebbero essere ricevuti.

Domande frequenti

D: In quale Formareareato turnoon invia i dati?
HTTP POST con corpo in formato JSON. La struttura dei dati per ogni tipo di evento è disponibile nella documentazione API.

D: È possibile creare più Webhook per lo stesso evento?
Sì, con URL diversi.

D: Cosa succede se il server non è disponibile quando il webhook si attiva?
La consegna potrebbe non riuscire. I dettagli sulla politica dei tentativi di ripetizione sono nella documentazione API.

D: Il webhook non si attiva — perché?
Assicurarsi che l’interruttore Attivo sia attivato e che l’URL sia accessibile pubblicamente.

D: Come verificare che il webhook riceva i dati?
Creare un evento di prova in Shifton (ad esempio, aggiungere un Turno) e verificare i log del server per la presenza di una richiesta POST in arrivo.

D: Posso configurare l’autenticazione del webhook?
Sì. Aggiungere una chiave segreta o un token nell’URL o negli header del webhook. I dettagli sono nella documentazione API.

D: Come appare il corpo della richiesta webhook?
Un oggetto JSON con i dati dell’evento. La struttura dipende dal tipo di evento — consultare la documentazione API per gli esempi.

D: Un singolo webhook può Lunitorare più eventi?
Sì. Durante la creazione del webhook, selezionare più eventi — un unico URL riceverà notifiche per tutti gli eventi selezionati.

D: Cos’è la «politica dei tentativi di ripetizione» per i webhook?
Se il server restituisce un errore (non 200), Shifton può ripetere la richiesta. I dettagli dipendono dalla configurazione della piattaforma.

D: Esiste un Limiteee al numero di Webhook?
Non sono indicati limiti nella documentazione, ma si consiglia di creare solo quelli necessari.

D: È necessario utilizzare HTTPS per l’URL del webhook?
È consigliato. Gli indirizzi HTTP possono funzionare, ma HTTPS garantisce una trasmissione sicura dei dati.

D: È possibile ricevere notifiche webhook per ogni modifica della Pianificazione?
Sì. Aggiungere eventi di tipo «Turno creato» o «schedule updated» durante la configurazione del webhook.

D: Chi ha accesso alla creazione dei Webhook?
Solo il Proprietario e l’Amministratore. I manager e i Dipendenti non vedono la sezione Developer.

D: È possibile diSabtivare un webhook senza eliminarlo?
Sì. Disattivare l’interruttore Attivo nelle impostazioni del webhook — smetterà di attivarsi ma manterrà la configurazione.

D: Le attivazioni dei webhook vengono registTariffa in turnoon?
I log dettagliati di consegna dei webhook non sono forniti nell’interfaccia. Il monitoraggio è sul lato del vostro server.

D: È possibile filtrare i webhook per progetto o Pianificazione?
No. Il webhook si attiva per tutti gli eventi del tipo selezionato in tutta l’azienda. Il filtraggio è sul lato del server ricevente.

D: Cosa succede ai webhook quando si elimina l’aziFinea?
Tutti i webhooks vengono eliminati insieme all’azienda.