ForHosting KIT · Outils pour développeurs

Calculateur de score de santé du compte client

Le calculateur de santé du compte client rassemble quatre signaux courants dans une note transparente de 0 à 100.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez des notes normalisées pour l’usage du produit, les tickets de support, le NPS et l’historique de paiement, puis attribuez à chaque signal son influence en pourcentage. L’outil vérifie que les pondérations totalisent exactement 100%, applique une moyenne pondérée et présente le résultat global ainsi que chaque contribution. Vous pouvez ainsi expliquer, reproduire et exploiter la note de façon cohérente dans vos processus de réussite client.

Préparez des signaux client comparables

Commencez par exprimer l’usage, les tickets de support, le NPS et l’historique de paiement sur une même échelle de 0 à 100. Une valeur élevée doit toujours correspondre à un compte en meilleure santé. Il peut donc être nécessaire de transformer l’activité du support avant la saisie : des escalades fréquentes et non résolues doivent abaisser la note, tandis que des résolutions rapides et des incidents peu graves doivent l’améliorer. Le NPS saisi est lui aussi un indicateur de santé normalisé, et non la valeur brute de l’enquête comprise entre -100 et 100. Définissez chaque signal en amont, puis appliquez cette définition uniformément à tous les comptes et à toutes les périodes. La cohérence est plus utile qu’une précision trompeuse. L’usage peut par exemple réunir le taux d’utilisateurs actifs, l’adoption des fonctionnalités et la fréquence récente des sessions, tandis que l’historique de paiement peut refléter la ponctualité et les impayés. Documentez ces règles afin que deux analystes obtiennent les mêmes données d’entrée. Le calculateur ne déduit ni ne corrige les notes sources, car des transformations cachées rendraient le résultat difficile à auditer. Il combine uniquement vos valeurs et expose chaque contribution pondérée.

Choisissez les pondérations et comprenez la formule

Attribuez à chaque signal un poids en pourcentage selon l’influence qu’il doit exercer sur la santé du compte. Les quatre poids doivent totaliser exactement 100%. Le calculateur multiplie chaque note par son poids, divise le produit par 100, puis additionne les quatre contributions. Si l’usage vaut 80 avec un poids de 40%, il apporte 32 points. Un poids nul est accepté lorsqu’un signal est temporairement sans intérêt, mais les poids restants doivent toujours atteindre 100%. Cette validation évite une erreur fréquente des feuilles de calcul : des pourcentages manquants ou dupliqués qui gonflent ou réduisent discrètement le résultat. La réponse indique, pour chaque signal, la note transmise, le poids et la contribution pondérée, afin que vous puissiez contrôler le calcul. Les valeurs sont arrondies à quatre décimales pour garantir une automatisation stable tout en conservant une précision utile. La note reçoit également une catégorie simple : saine à partir de 80, à surveiller de 60 à moins de 80, et à risque en dessous de 60. Utilisez ces catégories comme références opérationnelles initiales, puis adaptez vos règles d’escalade au cycle de vie de vos clients.

Exploitez la note avec discernement

Une note de santé composite sert surtout à établir des priorités de manière cohérente ; elle ne remplace pas le contexte propre au compte. Exécutez la même formule à intervalles réguliers et comparez le total ainsi que les contributions détaillées. Un total stable peut masquer des évolutions opposées, comme une meilleure adoption du produit accompagnée d’une dégradation des paiements. Le détail aide le responsable de la réussite client à repérer le signal à l’origine du changement et à choisir une intervention appropriée. Conservez les définitions des entrées, les poids et le résultat dans chaque relevé afin que les comparaisons historiques restent pertinentes lorsque votre modèle évolue. Si vous modifiez les pondérations, envisagez de recalculer les périodes antérieures ou d’identifier clairement une nouvelle version ; sinon, une tendance peut traduire la méthode plutôt que le comportement du client. Comparez les seuils à des résultats réels tels que renouvellement, développement, réduction ou départ, puis ajustez les définitions sources lorsque les données le justifient. L’API coûte $0.002 par calcul, tandis que la version navigateur convient aux vérifications ponctuelles. Aucun mode ne contacte de service externe et des entrées identiques donnent toujours le même résultat.

Priorisez les actions de réussite client

Classez les comptes avec une mesure composite cohérente et examinez la contribution la plus faible avant d’intervenir.

Surveillez un portefeuille de renouvellements

Recalculez régulièrement la santé des comptes et signalez les évolutions importantes avant les échanges de renouvellement.

Harmonisez les rapports de direction

Appliquez un modèle de pondération documenté dans toutes les équipes tout en conservant le détail qui explique chaque résultat.

Quelle formule le calculateur utilise-t-il ?

Il multiplie chaque note normalisée par son poids en pourcentage, divise par 100 et additionne les quatre contributions pondérées.

Que se passe-t-il si les poids ne totalisent pas 100% ?

Le calcul renvoie une erreur de saisie et indique le total reçu. Aucune note composite n’est produite.

Puis-je saisir un NPS brut négatif ?

Non. Convertissez d’abord le NPS brut en un signal de santé normalisé de 0 à 100.

Comment les catégories de santé sont-elles attribuées ?

Une note de 80 ou plus est saine, de 60 à moins de 80 elle est à surveiller, et sous 60 elle est à risque.

Un signal peut-il avoir un poids nul ?

Oui. Chaque note et chaque poids peut aller de 0 à 100, à condition que les quatre poids totalisent 100%.

Quel est le prix d’un calcul par API ?

Chaque calcul par API coûte $0.002. Le calculateur dans le navigateur convient aux contrôles ponctuels.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/biz/customer-health-score-calc

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/biz/customer-health-score-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usage_score":82,"usage_weight":35,"support_tickets_score":68,"support_tickets_weight":20,"nps_score":74,"nps_weight":25,"payment_history_score":95,"payment_history_weight":20}'
{
  "usage_score": 82,
  "usage_weight": 35,
  "support_tickets_score": 68,
  "support_tickets_weight": 20,
  "nps_score": 74,
  "nps_weight": 25,
  "payment_history_score": 95,
  "payment_history_weight": 20
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.customer_health_score_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →