ForHosting KIT · Notifiche e automazioni

Un riepilogo, non venti notifiche

notify.digest raccoglie più eventi nell’arco di un periodo — un giorno, una settimana — e li spedisce in un’unica email di riepilogo invece di una notifica separata per ognuno. Tu decidi cosa raccogliere e ogni quanto inviarlo; il prezzo è quello di una normale email.

● Stabileper richiesta + per email$0.002

Vedi l'API — $0.002 + $0.0035/email Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Il problema delle venti notifiche separate

Un evento alla volta, ogni evento con la sua email: dopo la decima notifica in un giorno, chi la riceve smette di leggerle davvero. notify.digest cambia l’unità: invece di spedire un’email per ogni cosa che succede, accumula gli eventi durante il periodo che scegli e li consegna tutti insieme, in un unico messaggio ordinato, all’orario che preferisci, senza interrompere continuamente chi lo riceve.

Cosa entra in un riepilogo

Definisci quali eventi contribuiscono al digest — nuovi ordini, errori registrati, avvisi ricevuti da altre capacità — e ogni volta che uno di questi si verifica viene messo in coda invece di partire subito. Alla scadenza del periodo — ogni giorno alle otto, ogni lunedì mattina — tutto ciò che si è accumulato diventa un’unica email con l’elenco degli eventi in ordine cronologico.

Digest o notifica singola: come scegliere

Per un evento urgente che richiede reazione immediata — un pagamento fallito, un sito irraggiungibile — la notifica singola resta la scelta giusta. Per informazioni utili ma non urgenti — nuovi iscritti, ordini ricevuti, statistiche del giorno — il digest evita di interrompere continuamente chi legge, mantenendo comunque tutta l’informazione a disposizione in un unico momento della giornata dedicato a leggerla con calma.

Prezzo per ogni riepilogo inviato

Ogni digest consegnato costa come un’email normale: $0.002 a chiamata più $0.0035 per email, $0.0055 in totale, indipendentemente da quanti eventi raccoglie al suo interno. Un riepilogo giornaliero per un mese intero costa circa $0.17: molto meno che spedire una notifica per ognuno dei tanti eventi raccolti dentro, e molto più leggibile per chi lo riceve ogni giorno, senza dover aprire venti messaggi separati.

Casi d'uso

Riepilogo giornaliero degli ordini

La Pasticceria Dolce Vita di Torino riceve alle diciannove un’unica email con l’elenco di tutti gli ordini del giorno, invece di una notifica a ogni acquisto: Giulia Bianchi controlla il riepilogo la sera e chiude la giornata.

Digest settimanale degli errori di sistema

Consulenza IT Marchetti S.r.l. di Trento riceve ogni lunedì mattina un riepilogo degli errori registrati durante la settimana precedente, invece di essere avvisata a ogni singolo errore minore.

Riepilogo mensile per il commercialista

Studio Legale Esposito & Associati di Napoli manda allo Studio Commercialista Bianchi un digest mensile con tutte le spese e le entrate registrate, pronto per essere controllato in un unico momento invece di email sparse.

Domande frequenti

Posso scegliere l’orario esatto in cui parte il riepilogo?

Sì, definisci sia il periodo di raccolta — giornaliero, settimanale — sia l’orario preciso di invio, ad esempio ogni giorno alle otto del mattino, ora italiana.

Cosa succede se in un periodo non c’è nessun evento da riepilogare?

Puoi scegliere se ricevere comunque un’email vuota di conferma o se saltare l’invio quando non c’è nulla da segnalare: la seconda opzione è quella che consigliamo per evitare rumore inutile.

Quanto costa un digest giornaliero per un mese intero?

Circa $0.17 al mese, calcolando trenta email a $0.0055 ciascuna. Il costo non dipende dal numero di eventi raccolti dentro ogni riepilogo, solo dal numero di digest effettivamente inviati.

Che differenza c’è tra questa capacità e una notifica singola per ogni evento?

notify.digest accumula più eventi e li consegna insieme a intervalli regolari; una notifica singola parte subito per ogni evento. La scelta dipende dall’urgenza: reagire subito o restare informati senza interruzioni continue.

Posso avere più digest diversi, ad esempio uno per gli ordini e uno per gli errori?

Sì, puoi definire più riepiloghi indipendenti, ciascuno con i propri eventi, il proprio periodo e il proprio orario di invio.

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/notify/digest

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/digest \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/notify/digest", {
  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/digest",
    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/notify/digest", 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/notify/digest", 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.digest",
  "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

per email$0.0035

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 →