> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.userbot.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server. # Attività schedulate Un'attività schedulata serve quando ti accorgi di chiedere la stessa cosa tutte le settimane. La configuri una volta, decidi quando deve girare, e da lì in poi il risultato ti aspetta già pronto. Ogni attività esegue una di tre cose: un'**istruzione** con il modello che scegli, un **agente**, oppure un **workflow** già pubblicato. Ogni esecuzione lascia una riga nella pagina dell'attività, con l'esito e l'output. ## Crearne una #### Apri Nuovo e scegli Schedulata In **Automazioni** premi **Nuovo** e scegli **Schedulata**: si apre il modulo **Nuova attività programmata**. Se stai lavorando su un agente salvato, puoi partire anche da **Schedula** nel suo editor: il modulo si apre con quell'agente già scelto e il nome già compilato. ![Il menu del pulsante Nuovo con la voce Schedulata evidenziata, l'ultima delle tre](/_fern-img/a2596fa13ff161147226453547947be774f79624435632b0b19293512311912c.webp) #### Dai un nome riconoscibile Scrivilo in **Nome**. *Riepilogo mattutino* è un buon nome. *Attività 3* no: fra due mesi nell'elenco ci saranno altre venti attività. ![La parte alta del modulo Nuova attività programmata, con il campo Nome compilato ed evidenziato](/_fern-img/681b7bf026c3e6828cb00a9738396af64c899c03a97d166d8c5bef4ede2661ce.webp) #### Scegli la frequenza In **Quando eseguirla** apri **Frequenza** e scegli ogni quanto deve girare. Cosa significa ciascuna è spiegato più sotto. ![Il menu Frequenza aperto con le sei voci: ogni giorno, nei giorni feriali, ogni settimana, ogni mese, ogni N minuti, ogni N ore](/_fern-img/f9b1dd861fecf9d4b9ecd973dc186fea9d27696a802bea7bf1e858080f5365f6.webp) #### Imposta l'orario Scrivi l'ora in **Orario**. Con **ogni N minuti** e **ogni N ore**, al posto dell'orario indichi l'intervallo. ![La riga Frequenza e Orario del modulo, con il campo Orario evidenziato sulle 08:00](/_fern-img/999a5610cce9770d3de14d0779978e94ee90d43a9003e96e8aaa45dcff78e5de.webp) #### Limita il periodo, se serve **Periodo di validità (opzionale)** apre un calendario: scegli il giorno di inizio e quello di fine. Fuori da quelle date l'attività non parte. ![Il calendario aperto sotto il pulsante Date di inizio e fine, sul mese in corso](/_fern-img/f710727f0ee0111b48873d138f0f0a7e9990f3f73a10a917a5a2e220debe31ab.webp) #### Scegli cosa eseguire In **Esegui tramite** scegli una delle tre schede: **Istruzioni**, **Agente** o **Workflow**. Sotto compaiono i campi di quella strada. ![Le tre schede di Esegui tramite evidenziate, con Istruzioni scelta: sotto, il campo Istruzioni compilato e il menu Modello su Auto](/_fern-img/516b36257bba8ac448db980c914a2dc5184bf82478ac79bbf3804df747a3498a.webp) #### Compila i campi della strada scelta Con **Istruzioni** scrivi la richiesta e scegli il **Modello**; con **Agente** scegli l'agente e, se vuoi, una **Frase di avvio**; con **Workflow** scegli il flusso e scrivi le **Istruzioni** che riceve. La tabella qui sotto spiega cosa produce ciascuna. ![La strada Agente: il menu Agente evidenziato, con un agente scelto, e sotto la Frase di avvio compilata](/_fern-img/39f83d84f9ecb3b5ac6619db0656eeee2e7861ef537b32d2299222ad7352d542.webp) #### Premi Crea attività Il pulsante si accende quando nome e campi obbligatori sono compilati. Si apre la pagina dell'attività: se vuoi vedere subito cosa produce, premi **Esegui ora**. ![Il modulo completo, con nome, frequenza ogni giorno alle 08:00, la strada Istruzioni compilata e il pulsante Crea attività evidenziato in fondo](/_fern-img/8f9c8e4832c313ba5eb7e1f0c3249e008214345d04f15ab238c25283485bf0db.webp) ## Istruzioni, Agente o Workflow | Esegui tramite | Cosa scrivi | Cosa produce | | -------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | | **Istruzioni** | Le **Istruzioni** e il **Modello** | Una conversazione con la risposta del modello | | **Agente** | L'**Agente** e, se vuoi, una **Frase di avvio** | Una conversazione con l'agente, che usa il suo modello, le sue istruzioni, la sua conoscenza e i suoi strumenti | | **Workflow** | Il **Workflow** e le **Istruzioni**, che il flusso riceve come messaggio di partenza | Un'esecuzione del workflow | Il criterio: **Istruzioni** quando il lavoro sta in una richiesta, **Agente** quando serve cercare nei documenti giusti o agire su un sistema collegato, **Workflow** quando il lavoro ha più passaggi e già esiste un flusso che li fa. Le istruzioni sono la richiesta che verrà eseguita ogni volta, parola per parola. Scrivile come le scriveresti in chat, ma senza riferimenti al momento in cui stai scrivendo: *«le notizie di oggi»* funziona, *«le notizie di cui parlavamo ieri»* no. Con un agente la frase di avvio è facoltativa: se la lasci vuota, l'agente riceve *Avvia*. Un agente in un'attività schedulata lavora con le sue istruzioni, la sua conoscenza e le azioni delle sue integrazioni, ma non riceve le sue Mini App né i suoi workflow, e non può fare domande: nessuno è lì a rispondere. Nel menu **Workflow** compaiono solo i workflow attivi, pubblicati e con trigger **Manuale**. Gira sempre la versione pubblicata. ## Le frequenze disponibili | Frequenza | Quando gira | | ---------------------- | -------------------------------------------------------------- | | **ogni giorno** | Tutti i giorni all'orario indicato, sabato e domenica compresi | | **nei giorni feriali** | Dal lunedì al venerdì | | **ogni settimana** | Il **lunedì**, all'orario indicato | | **ogni mese** | Il **primo giorno del mese**, all'orario indicato | | **ogni N minuti** | Ogni N minuti, da 10 a 1440 | | **ogni N ore** | Ogni N ore, da 1 a 168 | Per le frequenze a calendario il giorno non si sceglie: ogni frequenza ha il suo, fissato. Se ti serviva il riepilogo del venerdì, la strada è un'attività **nei giorni feriali** con l'istruzione di lavorare solo quel giorno, oppure accettare il lunedì. Con un intervallo l'orario sparisce. La prima esecuzione arriva N minuti o N ore dopo la creazione, e le successive N minuti o N ore dopo l'ultima esecuzione, anche quando l'hai lanciata tu con **Esegui ora**. Fuori dal **Periodo di validità** l'attività non parte, e in elenco risulta **Fuori periodo**. > **Info** > > Gli orari e le date seguono il fuso dell'area di lavoro, non quello del tuo > browser. Se il team è distribuito, controlla quale fuso è impostato prima di > programmare qualcosa alle 8 del mattino. ## Cosa produce ogni esecuzione Con **Istruzioni** o **Agente**, a ogni giro l'attività apre una conversazione nuova, intitolata *\[Schedulato]* seguito dal nome e dalla data. Non compare fra le chat della barra laterale: la apri da **Apri conversazione**, nella riga dell'esecuzione, e da lì la prosegui come una chat normale. Chiedere *«approfondisci il secondo punto»* sul risultato di stamattina funziona come sempre. Con **Workflow** non c'è una conversazione ma un'esecuzione del flusso: **Apri esecuzione workflow** la apre nel builder. Se il workflow si ferma ad aspettare un intervento, l'esecuzione dell'attività risulta **Completata** con *In attesa di un intervento.* e ricevi una notifica. Se l'attività usa un agente con strumenti collegati, ogni esecuzione può anche agire: cercare nei documenti, leggere in un sistema, scrivere dove ha i permessi per farlo. > **Warning** > > **Fuori dalla chat interattiva la conferma non protegge.** Un'attività > schedulata gira senza nessuno davanti allo schermo: quando l'agente arriva a > un'azione con **Chiedi conferma** attivo, non c'è a chi chiedere, e l'azione > viene eseguita. Prima di collegare a un'attività schedulata un agente che > invia, modifica o cancella qualcosa, verifica quali azioni ha: quell'interruttore, > qui, non ferma niente. → [Conferme prima di agire](/conferme-azioni) ## La pagina dell'attività Cliccando un'attività in **Automazioni** si apre la sua pagina. ![La pagina di un'attività: il nome con lo stato Attiva, le schede Agente e Programma, a destra i tre puntini ed Esegui ora; sotto, la tabella Esecuzioni con i filtri Tutte, Completata, Fallita e Saltata, Filtra per data e la ricerca](/_fern-img/72f0b6350eb65c2905dd5897df5518a918b53fb696ccbe29443dd61fce97ac19.webp) In alto ci sono il nome, lo stato (**Attiva** o **In pausa**), cosa esegue (l'**Agente** o il **Workflow**, cliccabili) e il **Programma**, per esempio *Ogni giorno, alle 08:00* oppure *Ogni 15 minuti*. A destra **Esegui ora** e il menu **Altre azioni**, con **Modifica**, **Disattiva** o **Attiva**, ed **Elimina**. **Modifica** riapre il modulo, ed è lì che rivedi istruzioni e modello. Le modifiche valgono dalla prossima esecuzione: quelle già fatte restano come sono. Sotto c'è la tabella **Esecuzioni**, dalla più recente, 50 righe per pagina. Ogni riga riporta chi l'ha avviata, lo **Stato**, l'**Origine** (**Manuale** se l'ha lanciata qualcuno con **Esegui ora**, **Programmata** se è partita da sola), **Quando** e l'inizio dell'**Output**. **Mostra output** apre la riga: l'output completo, i passaggi degli strumenti o del workflow, e il collegamento alla conversazione o all'esecuzione. ![La tabella Esecuzioni con la prima riga aperta: sotto Stato, Origine e Quando compare l'output completo e il collegamento Apri conversazione](/_fern-img/e589a313576e30ccdf94df493e9110dccf7f64069c50569b0cf6333716305459.webp) Sopra la tabella filtri per stato (**Tutte**, **Completata**, **Fallita**, **Saltata**), per data con **Filtra per data**, e cerchi nel testo con **Cerca nell'output**. | Esito | Cosa è successo | | -------------- | ----------------------------------------------------------------------------- | | **Completata** | L'esecuzione è arrivata in fondo. L'output è nella riga | | **Fallita** | Qualcosa si è interrotto. Il motivo è nell'output | | **Saltata** | L'esecuzione non è partita. Il motivo è nell'output, e ti arriva una notifica | Finché un giro è in corso, la tabella mostra una riga *In esecuzione...* e **Esegui ora** resta disattivato. ## Quando un'attività non parte Un'attività che non produce risultati ha quasi sempre una di queste ragioni. | Cosa è successo | Come te ne accorgi | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Hai superato la quota.** Le esecuzioni programmate sono 250 ogni 3 ore, contate su tutte le tue attività insieme | Riga **Saltata** e notifica | | **Hai raggiunto il limite anti-spam dei messaggi** | Riga **Saltata** e notifica: si riprova al giro successivo | | **L'abbonamento o il periodo di prova non sono attivi** | Riga **Saltata**, attività **In pausa**, notifica | | **Non hai più accesso alle attività programmate** nell'area di lavoro | Riga **Saltata**, attività **In pausa**, notifica | | **Il workflow collegato non si può più eseguire**: eliminato, disattivato, non pubblicato o con un trigger diverso da Manuale | Riga **Saltata**, attività **In pausa** e notifica *Workflow collegato non disponibile*. Se il workflow viene eliminato, l'attività va in pausa subito | | **Le esecuzioni workflow del mese sono finite** | Riga **Saltata**, attività **In pausa**, notifica | | **L'agente collegato è stato eliminato** | Attività **In pausa** e notifica | | **L'orario è passato da troppo.** Per le frequenze a calendario, se il momento previsto viene mancato resta mezz'ora per recuperarlo: oltre, quell'occorrenza è persa | Nessuna riga per quel giorno | | **L'attività era già in esecuzione** all'orario previsto | Nessuna riga nuova | | **Chi l'ha creata ha lasciato l'area di lavoro.** L'attività viene eliminata | Sparisce dall'elenco | Un'esecuzione fallita **non viene ritentata**: resta come **Fallita** e si riprova al giro successivo. Se ti serve il risultato subito, usa **Esegui ora**. Se hai molte attività alla stessa ora partono tutte nello stesso giro, a piccoli gruppi. Distribuirle su orari diversi (8:00, 8:15, 8:30) resta una buona abitudine, perché i risultati arrivano prima. ## Metterla in pausa ![Il menu Altre azioni della pagina di un'attività, accanto a Esegui ora: Modifica, Disattiva evidenziata ed Elimina](/_fern-img/bd03e9baf6210308b373ae06fbd6dff10a2d180049a6b3e4273bcd9f22ec793f.webp) **Disattiva**, in **Altre azioni**, ferma le esecuzioni future senza toccare nulla di quello che ha già prodotto: la configurazione resta, le esecuzioni restano, l'attività passa **In pausa**. **Attiva** la rimette in moto, purché l'abbonamento dell'area di lavoro sia attivo. Su un'attività in pausa **Esegui ora** non produce niente. È quello che ti serve quasi sempre: durante le ferie, mentre rivedi le istruzioni, quando un'attività sta producendo risultati che non convincono. > **Warning** > > **Elimina** chiede conferma e non si annulla: l'attività sparisce insieme alle > sue esecuzioni. Se vuoi solo fermarla, usa **Disattiva**. ## Domande frequenti #### Le mie attività le vedono i colleghi? No: un'attività schedulata è tua, e le conversazioni che produce sono tue. Chi amministra l'area di lavoro vede l'elenco di tutte le attività programmate e può disattivarne una, ma non ne legge i contenuti. Può anche spegnere **Consenti ai membri di creare attività programmate**: da lì in poi solo gli amministratori ne creano di nuove, e quelle esistenti continuano a girare. #### Cosa succede se ero disconnesso all'ora prevista? Niente: l'attività gira sui server di Userbot, non nel tuo browser. Il risultato ti aspetta quando rientri. #### Posso farmi avvisare quando il risultato è pronto? Ricevi una notifica a ogni esecuzione: completata, fallita, saltata, in attesa o messa in pausa. Se ti serve che il risultato arrivi altrove, via email o dentro un altro sistema, costruisci un [workflow](/costruire-workflow) che lo faccia e fallo partire dall'attività con **Esegui tramite** → **Workflow**. #### Il mio agente è remoto (A2A). Funziona? Sì: a ogni giro le istruzioni vengono mandate all'agente remoto, e la sua risposta è l'output dell'esecuzione.