Stimi il rischio di rinnovo dalla salute del cliente
Questo strumento trasforma due comuni indicatori di successo del cliente in una categoria coerente di rischio basso, medio o alto.
Esegui gratis nel browser
Inserisca un punteggio di salute compreso tra 0 e 100 e il numero intero di giorni che mancano al rinnovo. Il risultato applica soglie trasparenti ed è adatto a priorità, report, instradamento dei flussi e revisioni periodiche del portafoglio. Non calcola un’esatta probabilità di rinnovo: offre invece una categoria operativa che Lei può comprendere, verificare e applicare in modo uniforme.
Comprendere la regola di classificazione
Lo strumento valuta insieme la salute del cliente e la vicinanza del rinnovo. Il rischio è alto quando il punteggio è inferiore a 50 oppure mancano 30 giorni o meno. Se questa regola non si applica, il rischio è medio quando il punteggio è inferiore a 75 oppure mancano 90 giorni o meno. Il rischio è basso soltanto con un punteggio di almeno 75 e più di 90 giorni disponibili. Prevale sempre il segnale più urgente: una salute eccellente non annulla l’urgenza di un rinnovo imminente e un ampio anticipo non nasconde un punteggio molto debole. Queste soglie costituiscono una regola semplice e spiegabile, non un modello statistico. Ogni risultato può quindi essere riprodotto dalle due entrate, senza pesi nascosti, dati storici di addestramento o interpretazioni soggettive.
Preparare dati di ingresso affidabili
Adotti una definizione stabile del punteggio di salute da 0 a 100 per tutti i clienti messi a confronto. Se un reparto considera solo l’attività nel prodotto e un altro attribuisce molto peso all’assistenza, le categorie sembreranno comparabili pur partendo da misure differenti. Documenti il metodo e lo aggiorni con una frequenza prevedibile. Indichi il numero intero di giorni di calendario fino alla data contrattuale; 0 significa che il rinnovo è oggi. I valori negativi vengono rifiutati perché descrivono una scadenza già passata, da gestire con un flusso diverso. Sono rifiutati anche valori mancanti, non numerici o infiniti, punteggi fuori intervallo e giorni frazionari. Prima di elaborare un portafoglio, verifichi la data corretta per contratti modificati, proroghe e accordi in cui il preavviso differisce dal rinnovo effettivo.
Usare la categoria come segnale operativo
Consideri il risultato un aiuto per stabilire le priorità, non una previsione garantita né un sostituto della conoscenza dell’account. I clienti ad alto rischio possono richiedere una revisione immediata, un piano di rinnovo confermato, uno sponsor dirigenziale o interventi su adozione e assistenza. Il rischio medio suggerisce spesso contatti programmati, controllo del piano di successo e coinvolgimento tempestivo dei referenti commerciali. Il rischio basso richiede comunque la normale gestione del rinnovo; indica solo che nessuna soglia segnala al momento un’esposizione elevata. Poiché la regola è deterministica, Lei può rieseguirla e seguire i cambiamenti nel tempo. Conservi le due entrate accanto alla categoria per renderne chiara la motivazione. Se in futuro adotterà un modello predittivo calibrato, lo confronti con questa base senza interpretare le categorie come probabilità misurate.
Casi d'uso
Dare priorità al portafoglio rinnovi
Classifichi gli account prima della revisione settimanale per affrontare prima le combinazioni urgenti di salute debole e scadenza vicina.
Instradare le azioni operative
Invii il rischio alto all’intervento immediato, quello medio al contatto pianificato e quello basso al normale ciclo di rinnovo.
Creare una base spiegabile
Confronti un futuro modello predittivo con una regola trasparente il cui esito è sempre ricostruibile da due valori.
Domande frequenti
Lo strumento restituisce una probabilità esatta di rinnovo?
No. Restituisce una categoria operativa basata su soglie esplicite, non una percentuale calibrata statisticamente.
Che cosa determina un rischio alto?
Un punteggio inferiore a 50 oppure 30 giorni o meno al rinnovo. È sufficiente una delle due condizioni.
Che cosa determina un rischio medio?
Se non vale la regola del rischio alto, un punteggio inferiore a 75 oppure 90 giorni o meno determina il rischio medio.
Perché i giorni negativi vengono rifiutati?
Indicano una data già trascorsa, che richiede un flusso per rinnovi scaduti o abbandono anziché una valutazione preventiva.
Posso usare un punteggio di salute decimale?
Sì. È accettato qualsiasi numero finito da 0 a 100, inclusi i decimali. I giorni devono essere interi.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico può essere eseguito anche nel browser.
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/biz/renewal-probability-estimate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"health_score":82,"days_until_renewal":120}'const res = await fetch("https://api.kit.forhosting.com/biz/renewal-probability-estimate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"health_score": 82,
"days_until_renewal": 120
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/biz/renewal-probability-estimate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"health_score": 82,
"days_until_renewal": 120
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/renewal-probability-estimate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"health_score":82,"days_until_renewal":120}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"health_score":82,"days_until_renewal":120}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/renewal-probability-estimate", 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
{
"health_score": 82,
"days_until_renewal": 120
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "biz.renewal_probability_estimate",
"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. |