ForHosting KIT · Notifiche e automazioni

Attività che si ripetono da sole

flow.schedule esegue automaticamente un’operazione del KIT a intervalli regolari — ogni giorno, ogni settimana, il primo del mese — senza che tu debba avviarla manualmente ogni volta: definisci la ricorrenza una volta, il sistema se ne occupa da solo, con orario e fuso dichiarati.

● Stabileper richiesta + per esecuzione$0.002

Vedi l'API — $0.002 Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Le operazioni che si ripetono da sole

Certe operazioni vanno ripetute sempre uguali, a intervalli regolari: un riepilogo ogni lunedì, una verifica ogni notte, un report a fine mese. Farle partire a mano ogni volta significa doverle ricordare, e prima o poi si dimenticano. flow.schedule le esegue automaticamente secondo la ricorrenza che definisci, così l’operazione parte da sola anche se nessuno se ne occupa quel giorno, ferie o malattia comprese.

Come si definisce la ricorrenza

Indichi l’operazione da eseguire e la frequenza: ogni giorno a una certa ora, ogni settimana in un giorno specifico, ogni mese a una data fissa. Il fuso orario di riferimento va dichiarato esplicitamente, così l’esecuzione delle otto del mattino corrisponde davvero alle otto in Italia e non a un altro fuso orario, con ore di scarto rispetto a quanto atteso.

Cosa succede a ogni esecuzione

A ogni ciclo, il sistema avvia l’operazione definita come farebbe una singola chiamata manuale, e ne registra l’esito. Puoi collegare l’attività programmata a una catena più ampia — leggi i dati, riepiloga, invia — così l’intero flusso si ripete automaticamente, non solo un singolo passaggio isolato e scollegato dal resto, ogni volta con la stessa affidabilità e nello stesso ordine preciso.

Prezzo per ogni esecuzione, non per la programmazione

Paghi $0.002 per ogni esecuzione realmente avvenuta, non un canone per mantenere attiva la programmazione. Un’attività giornaliera per un mese intero costa $0.06 in totale per la parte di programmazione, a cui si somma il costo dell’operazione eseguita a ogni ciclo, che dipende da cosa fai girare esattamente ogni volta, giorno dopo giorno, senza interruzioni impreviste né dimenticanze da parte di nessuno.

Casi d'uso

Verifica notturna della disponibilità del sito

Web Agency Nuvola S.r.l. controlla ogni notte alle tre che il sito di un cliente risponda correttamente, e riceve un avviso solo se qualcosa non funziona, senza dover controllare manualmente ogni mattina.

Riepilogo settimanale ogni lunedì mattina

Lo Studio Commercialista Bianchi riceve ogni lunedì alle otto un riepilogo automatico delle scadenze della settimana, generato e inviato senza che nessuno debba avviarlo.

Report mensile il primo giorno del mese

Tecnoedil Verona S.n.c. genera automaticamente il primo di ogni mese il riepilogo dei cantieri aperti, pronto per la riunione di inizio mese senza preparazione manuale.

Domande frequenti

In che fuso orario vanno indicati gli orari di esecuzione?

Lo dichiari esplicitamente nella configurazione, così un’esecuzione alle otto del mattino corrisponde davvero all’ora italiana e non a un fuso diverso, evitando ambiguità.

Cosa succede se un’esecuzione programmata fallisce?

L’esito viene registrato come fallito e puoi consultarlo; collegando questa capacità al ritentativo automatico, il sistema può riprovare l’esecuzione prima di segnalarla come persa.

Quanto costa un’attività giornaliera per un anno intero?

Circa $0.73 solo per la parte di programmazione, a $0.002 per esecuzione moltiplicato per 365 giorni, più il costo dell’operazione svolta a ogni ciclo.

Posso modificare la frequenza dopo averla definita?

Sì, puoi aggiornare la ricorrenza in qualsiasi momento: passare da settimanale a giornaliera, cambiare l’orario, o sospendere temporaneamente l’attività senza cancellarla.

Che differenza c’è tra questa capacità e un invio email programmato una tantum?

Un invio email programmato riguarda un singolo evento futuro; flow.schedule esegue un’operazione — che può includere un invio email — a intervalli che si ripetono nel tempo, senza data di fine a meno che tu non la fermi.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/flow/schedule

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/flow/schedule \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/flow/schedule", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/flow/schedule",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/schedule", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/schedule", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "input": "…"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "flow.schedule",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →