Programma l’invio di un’email
notify.email_scheduled prepara un’email oggi e la fa partire nel momento che scegli — tra tre giorni, all’apertura dell’ufficio, alla mezzanotte del rinnovo — senza bisogno che il tuo sistema sia acceso in quel preciso istante. Stesso prezzo di un invio immediato.
Il problema dell’orario giusto
Certi avvisi hanno senso solo se arrivano al momento giusto: un promemoria tre giorni prima della scadenza, un augurio alla mezzanotte, un’offerta che scatta all’apertura del negozio online. Tenere un processo acceso ad aspettare quell’istante è scomodo e fragile. Con notify.email_scheduled definisci il contenuto e l’orario di invio in una volta sola, e il sistema si occupa di farlo partire puntuale, anche a sistema spento dalla tua parte.
Come si imposta la data di invio
Alla chiamata normale — destinatario, oggetto, corpo — aggiungi semplicemente quando l’email deve partire: una data e un’ora precise, oppure un ritardo rispetto a adesso, del tipo «tra 72 ore». Il fuso orario di riferimento va dichiarato esplicitamente nella richiesta, per evitare l’ambiguità tipica tra ora italiana e ora UTC, un dettaglio che fa la differenza tra un avviso puntuale e uno arrivato con ore di anticipo o di ritardo.
Prima di allora, puoi ancora intervenire
Un’email programmata non è ancora partita: se le circostanze cambiano — il cliente ha già pagato, l’evento è stato annullato — puoi ancora agire prima dell’orario fissato. Una volta scoccato il momento, la consegna parte come un invio normale e segue le stesse regole di notify.email, senza più possibilità di fermarla o modificarla: da quell’istante in poi il messaggio è già in viaggio verso il destinatario.
Prezzo identico a un invio immediato
Programmare l’invio non costa nulla in più: $0.002 a chiamata più $0.0035 per email consegnata, $0.0055 in totale, indipendentemente da quanto tempo passa prima della partenza. Non esiste un canone per «tenere in coda» il messaggio: paghi solo quando l’email parte davvero, che sia programmata per tra un’ora o per tra un mese intero, senza differenza di prezzo tra i due casi.
Casi d'uso
Promemoria tre giorni prima della scadenza
Lo Studio Commercialista Bianchi programma un avviso di scadenza fiscale tre giorni prima della data limite, così ogni cliente ha ancora tempo di reagire prima del giorno critico.
Auguri di compleanno automatici ai clienti
La Boutique di Chiara Romano a Firenze programma un’email di auguri il giorno del compleanno di ogni cliente registrato, con un piccolo codice sconto valido per una settimana.
Offerta che scatta all’apertura del negozio
Palermo Import Export S.r.l. programma l’invio di una promozione flash proprio alle nove del mattino, quando il traffico sul sito è più alto e l’offerta ha più probabilità di essere vista subito.
Domande frequenti
In che fuso orario va indicato l’orario di invio?
Lo dichiari esplicitamente nella richiesta, così non c’è ambiguità tra ora italiana e ora UTC. Ti consigliamo di indicarlo sempre, anche quando sembra ovvio.
Posso annullare un’email già programmata?
Sì, finché non è ancora scoccato l’orario fissato puoi ancora intervenire e fermarla. Una volta partita, segue le stesse regole di un’email inviata subito e non si può richiamare indietro.
Quanto tempo in avanti posso programmare un invio?
Da pochi minuti a diverse settimane, a seconda del caso d’uso. Per campagne su orizzonti più lunghi, combinala con un’attività ricorrente programmata invece di un singolo invio differito.
Costa di più rispetto a un invio immediato?
No, il prezzo è lo stesso: $0.0055 per email, che parta subito o tra due settimane. La programmazione non ha un costo separato.
Cosa succede se il sistema che ha fatto la chiamata è spento quando arriva l’orario?
Non ha importanza: l’email è già stata presa in carico al momento della chiamata e parte da sola all’ora indicata, senza bisogno che il tuo sistema sia attivo in quell’istante.
Posso programmare invii ricorrenti, non solo uno singolo?
Per un evento singolo usa questa capacità; per invii che si ripetono — ogni lunedì, ogni fine mese — è più adatta un’attività ricorrente programmata, che richiama l’invio email a ogni ciclo.
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
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/notify/email-scheduled \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/notify/email-scheduled", {
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/notify/email-scheduled",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/email-scheduled", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/email-scheduled", 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": "notify.email_scheduled",
"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
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. |