--- title: "Attività programmate: esegui compiti a orari fissi | Briks" url: https://briks.dev/it/docs/crons description: "Esegui attività pianificate sul tuo sito a orari fissi. Scrivi l'orario, leggi ogni esecuzione, correggi quella che fallisce e vedi i limiti del piano." last_updated: 2026-10-08 --- # Attività programmate: esegui compiti a orari fissi Un'attività programmata esegue qualcosa sul tuo sito a orari fissi senza che nessuno prema un pulsante: un riepilogo ogni mattina, una pulizia ogni domenica sera. La trovi nelle **Settings** del progetto, sotto **Scheduled tasks**. Questa pagina mostra come configurarne una, leggerne le esecuzioni e correggerne una che fallisce. 8 minuti di lettura Verificato rispetto allo studio il 8 ottobre 2026 ## Cosa fa un'attività pianificata Un'attività pianificata è una chiamata che Briks fa a orari stabiliti. Chiama una **route** del tuo sito (un indirizzo sotto `/api/` che esegue codice invece di mostrare una pagina) oppure un altro indirizzo https pubblico, come un servizio che usi. È l'indirizzo a svolgere il lavoro. Briks fa la chiamata puntuale e registra ciò che torna indietro. Quindi un'attività ha bisogno di qualcosa da chiamare. Se il tuo sito non ha ancora una route per quel lavoro, chiedine prima una nello studio, poi punta un'attività verso di essa. Se non ci sono ancora attività, la pagina dice **No scheduled tasks** e riassume i lavori più comuni: inviare un riepilogo giornaliero, ripulire i vecchi record o sincronizzarsi con un altro servizio. Le attività vengono eseguite che il sito sia pubblicato o no, agli orari che imposti, nel fuso orario che scegli. La sezione ha tre viste: **Tasks**, **Runs** e **Settings**. Dove 1. Projects 2. Your project 3. Settings 4. Scheduled tasks ## Limiti di ogni piano | Piano | Attività programmate per progetto | Chiamate al giorno per progetto | | --- | --- | --- | | Free | 1 | 2.000 | | Starter | 5 | 5.000 | | Pro | 10 | 10.000 | | Studio | 25 | 50.000 | | Agency | 50 | 100.000 | Le chiamate al giorno sono condivise tra le esecuzioni delle attività e i tentativi di consegna dei webhook, e il giorno inizia a mezzanotte UTC. La vista **Tasks** mostra a che punto sei, per esempio 2 su 5 nel tuo piano, e **Add task** diventa grigio quando raggiungi il limite. Accanto al conteggio compare allora un link **Get more**, che apre la finestra di upgrade e indica il piano più piccolo con spazio per un'altra attività. Un'esecuzione che supererebbe le chiamate del giorno viene segnata come **Skipped**. I piani si confrontano in [Billing](https://briks.dev/it/docs/billing). Scegli un intervallo sensato Un'attività che gira ogni minuto fa da sola 1,440 chiamate al giorno. Sul piano Free, con 2,000 chiamate al giorno, resta poco spazio per altro. Ogni 5 o 15 minuti basta per la maggior parte dei lavori, e una volta al giorno è sufficiente per i riepiloghi. ## Aggiungi un'attività programmata 1. Premi Add task Dove: Settings, Scheduled tasks Si apre la finestra **Add a scheduled task**. Editor, Admin e Owner possono aggiungere attività. 2. Dagli un nome Dove: Add a scheduled task Dagli un nome breve che riconoscerai nell'elenco delle esecuzioni, come `Daily digest`. Fino a 60 caratteri. 3. Imposta la pianificazione Dove: Add a scheduled task Scrivi una pianificazione in **Schedule** oppure premi uno dei pulsanti sotto. La prossima sezione spiega il formato. 4. Scegli il fuso orario Dove: Add a scheduled task **Time zone** parte dal tuo fuso. Un riquadro qui sotto mostra la programmazione a parole e le prossime cinque volte in cui verrà eseguita, così puoi controllarla prima di salvare. 5. Indica cosa richiama Dove: Add a scheduled task Sotto **What it calls**, scegli **A route on this site** e scrivi il suo percorso (inizia con `/api/`), oppure **Another address** e scrivi un indirizzo https completo. Per una route, il suggerimento sotto il campo mostra l'indirizzo completo che verrà chiamato. 6. Scegli POST o GET Dove: Add a scheduled task **POST** invia un breve messaggio con la chiamata, come si aspettano la maggior parte dei percorsi pensati per un compito. **GET** chiede solo l'indirizzo. Se hai dubbi, lascia POST. 7. Salva Dove: Add a scheduled task Premi **Add task**. Viene salvata solo dopo che l'utilità di pianificazione l'ha accettata, quindi ogni attività in elenco è una che gira davvero. ## Scrivere una pianificazione Una pianificazione è composta da cinque valori separati da spazi: minuto, ora, giorno del mese, mese e giorno della settimana. Un `*` significa ogni. Se ciò che scrivi non si può leggere, la casella dice cosa non va, per esempio quale valore è fuori intervallo. | Vuoi | Tipo | L'anteprima dice | | --- | --- | --- | | Ogni mattina alle 7 | `0 7 * * *` | Ogni giorno alle 07:00 | | Nei giorni feriali alle sei e mezza di sera | `30 18 * * 1-5` | Ogni giorno feriale alle 18:30 | | Ogni 15 minuti | `*/15 * * * *` | Ogni 15 minuti | | Ogni due ore, all'ora esatta | `0 */2 * * *` | Ogni 2 ore, in punto | | La domenica sera alle 11 | `0 23 * * 0` | Ogni domenica alle 23:00 | | Il 1° di ogni mese alle 6 del mattino | `0 6 1 * *` | Il 1° di ogni mese alle 06:00 | I giorni della settimana vanno da 0 (domenica) a 6 (sabato), e anche 7 è domenica. Puoi scrivere anche nomi come `mon` o `jan`, elenchi come `1,3,5`, intervalli come `1-5` e passi come `*/10`. Funzionano anche le scorciatoie: `@hourly`, `@daily`, `@weekly`, `@monthly` e `@yearly`. I pulsanti sotto la casella la compilano al posto tuo: **Every 5 minutes**, **Every hour**, **Every day at 09:00**, **Mondays at 09:00** e **First of the month**. Due dettagli Se limiti sia il giorno del mese sia il giorno della settimana, viene eseguito un giorno che corrisponde a uno dei due. E quando cambia l'ora, un orario che capita due volte viene eseguito una volta sola, mentre un orario che l'orologio salta viene eseguito subito dopo il cambio, così un'attività giornaliera alle 02:30 non salta mai. ## Cosa comporta ogni chiamata Un'attività attende fino a 30 secondi una risposta. Ogni chiamata porta uno `user-agent` pari a `Briks-Cron/1.0` e un'intestazione `x-briks-cron` con l'id dell'attività, così la route può capire da dove arriva la chiamata. Una chiamata POST invia anche un breve messaggio JSON (JSON è un formato di testo semplice che i programmi leggono) che indica il nome dell'attività: Il corpo di una chiamata POST > `{"cron":{"id":"…","name":"Daily digest"},"trigger":"schedule","scheduledFor":"2026-10-09T06:00:00.000Z"}` `trigger` è `manual` quando qualcuno ha premuto **Run now**, e allora `scheduledFor` è `null`. Briks non chiama un indirizzo su una rete privata, un indirizzo scritto con numeri o uno dei suoi stessi indirizzi, e non segue i reindirizzamenti, quindi indica l'indirizzo finale. Le chiamate a una route del tuo sito vanno al suo indirizzo `briks.live`, e se cambi quell'indirizzo lo seguono. ## Le esecuzioni e il significato di ogni stato Dove 1. Projects 2. Your project 3. Settings 4. Scheduled tasks 5. Runs **Runs** elenca ogni esecuzione degli ultimi trenta giorni, dalla più recente, programmata o avviata a mano. Un'esecuzione avviata a mano ha l'etichetta **By hand**. Con più di un'attività, scegline una nella casella sopra l'elenco e premi **Show**. Fai clic su un'esecuzione per vedere il metodo e l'indirizzo chiamato, l'eventuale errore e l'inizio della risposta ricevuta. | Stato | Cosa è successo | | --- | --- | | **Succeeded** | L'indirizzo ha risposto con uno stato 2xx, il codice del web per indicare successo. | | **Failed** | Qualsiasi altra cosa: uno stato diverso (404 significa non trovato, 500 significa che il codice sottostante ha fallito), nessuna risposta entro 30 secondi, un reindirizzamento o un indirizzo non raggiungibile. | | **Skipped** | Le chiamate del giorno per il progetto sono esaurite. L'esecuzione dice: Today's calls for this project are used up. Le esecuzioni ricominciano dopo la mezzanotte (UTC). | La vista **Tasks** mostra lo stesso a colpo d'occhio: **Next** con l'ora della prossima esecuzione, **Last** con l'ultimo stato, oppure **Not run yet**. ## Quando un'esecuzione fallisce Un'esecuzione fallita viene registrata e non ripetuta. La successiva arriva all'orario consueto. Anche le esecuzioni perse mentre nulla poteva eseguirle non vengono recuperate: l'attività viene eseguita una volta e prosegue da lì. Dopo aver risolto la causa, apri i tre puntini dell'attività e scegli **Run now**. Il risultato appare subito, per esempio: Daily digest ran: the address answered 200 in 312 ms. Puoi eseguire un'attività a mano fino a 20 volte all'ora, e ogni esecuzione conta nelle chiamate del giorno. | Cosa dice l'esecuzione | Cosa fare | | --- | --- | | ha risposto 404 | Non c'è nessuna route a quel percorso. Controlla l'ortografia e che la versione con la route sia stata pubblicata. | | ha risposto a 500 | È la route stessa ad aver avuto un errore. Apri [Logs](https://briks.dev/it/docs/logs), scegli **Requests** e cerca il percorso per leggere l'errore. | | Nessuna risposta entro 30 secondi. | L'operazione richiede troppo tempo in un'unica volta. Chiedi nello studio la strada per fare meno a ogni chiamata, ed eseguila più spesso. | | I reindirizzamenti non vengono seguiti: usa l'indirizzo finale. | Apri l'indirizzo in un browser, copia l'indirizzo a cui porta e cambia l'attività con quello. | | Quell'indirizzo punta a una rete privata e non può essere chiamato. | Usa un indirizzo pubblico. Briks non si collega mai a reti private. | Rendi i job sicuri da ripetere Chiunque conosca l'indirizzo di una rotta può chiamarla, e tu premerai **Run now** durante i test. Chiedi rotte che non facciano danni se eseguite due volte: cancella i record più vecchi di 90 giorni invece dei 50 più vecchi. ## Metti in pausa, modifica o elimina L'interruttore accanto a ogni attività la mette in pausa (compare l'etichetta **Paused**) e la riavvia. Nei suoi tre puntini, **Change** apre lo stesso modulo, intitolato **Change task**, e **Delete** la ferma ed elimina la cronologia delle esecuzioni. Per tutto questo servono i permessi di modifica. Dove 1. Projects 2. Your project 3. Settings 4. Scheduled tasks 5. Settings La vista **Settings** ha **Download JSON**, un file con nome, programmazione, fuso orario e destinazione di ogni attività. La sua zona pericolosa contiene **Clear history** (le attività continuano a girare) e **Delete all** (per confermare scrivi il nome del progetto). Entrambi sono riservati a Owner e Admin. ## Esempi pratici Chiesto nello studio Un riepilogo giornaliero per uno studio di fisioterapia > Aggiungi una route su /api/daily-summary che mi mandi per email in un unico messaggio le richieste di appuntamento di ieri. Dopo la pubblicazione della modifica, la clinica aggiunge un'attività programmata di nome `Daily summary` con la pianificazione `0 7 * * *`, fuso orario Europe/London, che chiama POST `/api/daily-summary`. Ogni mattina alle sette arriva il riepilogo. Il riepilogo parte dall'email del sito, che resta disattivata finché non la attivi. Vedi [Email del sito](https://briks.dev/it/docs/site-email) per sapere come fare e per il limite mensile. Chiesto nello studio Eliminare i vecchi record per un'agenzia di ripetizioni > Aggiungi una route in /api/tidy-enquiries che elimina le richieste più vecchie di 90 giorni. Un'attività chiamata `Tidy enquiries` la esegue con `0 23 * * 0`, ogni domenica alle 23:00. Il lunedì, **Runs** mostra **Succeeded**, e aprendo l'esecuzione vedi cosa ha risposto la route. Prima che una pulizia come questa giri per la prima volta, salva un punto di ripristino nelle impostazioni della scheda Database. Se la route elimina più del dovuto, puoi tornare indietro. Vedi [Backups](https://briks.dev/it/docs/backups). ## Da leggere dopo - [Dati e automazione **Webhook** Invia un messaggio firmato a un altro tool quando il sito è pubblicato, un modulo è inviato o un record cambia. Payload, firme, tentativi e consegne spiegati.](https://briks.dev/it/docs/webhooks) - [Dati e automazione **Log** Leggi il registro di creazione e le richieste del sito dell'ultimo giorno, filtra per livello o stato e trova moduli e job in errore o pagine lente.](https://briks.dev/it/docs/logs) - [Le funzioni del tuo sito **Email del sito** Il tuo sito invia conferme e risposte dal suo indirizzo su emails.briks.live: scegli dove vanno le risposte e controlla gli invii rispetto al limite mensile.](https://briks.dev/it/docs/site-email) - [Dati e automazione **Database** Scopri cosa memorizza il tuo sito, modifica e aggiungi record a mano e scarica le raccolte come JSON o CSV, con chi può fare cosa e i limiti previsti.](https://briks.dev/it/docs/database) Hai ancora dubbi? Scrivi a [hello@briks.dev](mailto:hello@briks.dev) indicando il nome del tuo progetto e cosa ti aspettavi di vedere. Uno screenshot aiuta.