ForHosting KIT · Strumenti per sviluppatori

Rimanda una chiamata a webhook

Una chiamata ritardata parte da sola dopo il tempo che scegli tu, invece di partire subito. Questo strumento del KIT prende in carico un webhook e un ritardo — minuti, ore o giorni — e lo esegue puntuale allo scadere, senza che tu debba tenere un timer o un processo acceso in attesa.

● Stabileper richiesta + per callback$0.002

Vedi l'API — $0.002 Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Perché ritardare una chiamata invece di eseguirla subito

Non tutto deve succedere all’istante. Un promemoria via email tre giorni dopo un acquisto, il rilascio di un ordine solo dopo la finestra di reso, un follow-up 24 ore dopo un carrello abbandonato: sono azioni da eseguire più tardi, non ora. Tenere un processo acceso ad aspettare consuma risorse per niente; con questo strumento imposti il ritardo, chiudi la pagina, e te ne dimentichi finché non arriva il momento previsto.

Come si imposta

Indichi l’indirizzo del webhook, il payload da inviare e il ritardo desiderato, in minuti, ore o giorni. Il KIT calcola l’orario esatto e richiama l’endpoint quando scocca, senza che tu debba tenere traccia di nulla nel frattempo: la richiesta parte una volta sola, al momento previsto, con esattamente il contenuto che avevi definito al momento della programmazione, non uno aggiornato dopo.

Un carrello abbandonato, ripreso 24 ore dopo

Un negozio online imposta un ritardo di 24 ore su ogni carrello lasciato a metà: se il cliente non completa l’acquisto, allo scadere del ritardo parte automaticamente la chiamata che genera l’email di promemoria, con lo sconto del giorno se previsto. Nessun job notturno da programmare, nessun database di carrelli in sospeso da controllare a mano ogni mattina prima di aprire.

Prezzo e canale

La chiamata ritardata costa $0.002, prezzo pubblicato per ogni callback eseguito: la configuri dalla pagina web o via API, e da quel momento è il KIT a occuparsi dell’attesa. Non c’è abbonamento: paghi solo i ritardi che arrivano davvero a compimento, non quelli che annulli prima che scadano. Lo stesso meccanismo funziona sia per un singolo promemoria isolato sia dentro un flusso automatico che genera ritardi in continuazione, uno per ogni evento che li richiede.

Casi d'uso

Promemoria dopo l’acquisto

Un e-commerce di Bologna programma un’email di richiesta recensione 5 giorni dopo la consegna: il ritardo parte alla conferma di spedizione e la chiamata scatta da sola quando è il momento giusto.

Follow-up dopo un preventivo

Chiara Romano, che gestisce un piccolo studio di grafica, fa partire un promemoria 48 ore dopo l’invio di ogni preventivo se il cliente non ha ancora risposto, senza doverlo segnare a mano su un’agenda.

Annullamento automatico di una prenotazione

Un servizio di prenotazioni annulla in automatico una prenotazione non confermata entro 30 minuti: il ritardo parte alla creazione della prenotazione e libera lo slot se nel frattempo non arriva la conferma.

Domande frequenti

Con che precisione parte la chiamata?

Al minuto: se imposti un ritardo di 2 ore, il webhook viene richiamato 2 ore dopo, non prima né sensibilmente dopo.

Posso annullare un ritardo già impostato?

Sì, finché non è scaduto puoi cancellarlo o modificarne l’orario di destinazione.

Quanto costa ogni chiamata ritardata?

$0.002 a esecuzione, prezzo pubblicato, senza abbonamento: paghi solo i callback che arrivano effettivamente a termine.

Qual è il ritardo massimo che posso impostare?

Puoi programmare da pochi minuti fino a diversi giorni di distanza; per attese ricorrenti nel tempo, valuta invece la programmazione con cron.

Serve creare un account per usarlo?

No, oggi il KIT non richiede registrazione: configuri il ritardo e lo attivi direttamente, dalla pagina o via API.

Cosa succede se il mio endpoint è offline quando scatta la chiamata?

Il tentativo risulta fallito e resta segnato nel registro con l’orario in cui è avvenuto, così sai che va rilanciato a mano.

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/dev/delay

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

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