Aller au contenu principal

Suivi de l'utilisation du service et de l'équilibre

Le système de suivi de l'utilisation du service fournit une surveillance en temps réel de la consommation des clients pour les données, la voix, les SMS et les soldes monétaires. Cette fonctionnalité s'intègre avec le OCS (Système de Facturation en Ligne) pour afficher l'utilisation actuelle, les allocations restantes et les informations sur l'expiration des soldes aux clients (via le Portail d'Auto-Service) et au personnel.

Aperçu​

Le suivi de l'utilisation permet :

  • Affichage du solde en temps réel - Voir l'utilisation actuelle et les allocations restantes
  • Types de solde multiples - Suivre simultanément les soldes de données, de voix, de SMS et monétaires
  • Suivi des expirations - Voir quand les soldes expirent
  • Détail du solde - Vue détaillée des différents compartiments de solde
  • Actualisation automatique - Mises à jour de l'utilisation toutes les 3 secondes automatiquement

Accéder à l'utilisation du service​

Depuis la liste des services :

  1. Naviguez vers Services → Liste des services
  2. Cliquez sur le menu d'actions (⋮) à côté d'un service
  3. Sélectionnez "Utilisation"

Depuis les détails du service :

  1. Ouvrez la page de détails d'un service
  2. Cliquez sur l'onglet "Utilisation"

Depuis la page client :

  1. Ouvrez l'aperçu du client
  2. Naviguez vers l'onglet Services
  3. Cliquez sur "Voir l'utilisation" à côté de n'importe quel service

La modal ou la page d'utilisation s'ouvre, affichant les données de consommation en temps réel.

Affichage de l'utilisation​

L'interface d'utilisation montre des cartes de résumé et des barres de progression détaillées pour chaque type de solde.

Affichage de l'utilisation du service

Modal de solde de service{.align-center width="800px"}

Cartes de résumé​

La rangée supérieure affiche des cartes de vue rapide pour chaque type de solde :

Informations sur la carte :

  • Type de solde - Icône et étiquette (Données, Voix, SMS, Monétaire)
  • Montant restant - Solde actuel dans les unités appropriées
  • Temps d'expiration - Jours/heures jusqu'à l'expiration du solde
  • Bouton Plus d'infos - Cliquez pour développer le détail

Barres de progression​

Sous les cartes, les barres de progression montrent la consommation visuellement avec des portions remplies indiquant le solde restant.

Fonctionnalités de la barre de progression :

  • Indicateur visuel - La portion remplie montre le solde restant
  • Pourcentage - Pourcentage numérique du solde restant
  • Valeurs absolues - Montre utilisé vs total (par exemple, "12.5GB / 20GB")
  • Codage couleur :
    • Vert : >50% restant
    • Jaune : 20-50% restant
    • Rouge : <20% restant
  • Cliquable - Cliquez pour développer le détail

Types de solde​

Solde de données​

Suit la consommation de données Internet.

Unités : Gigaoctets (Go) ou Mégaoctets (Mo)

Format d'affichage :

Progression : 12.5 Go / 20 Go (62%)

Scénarios courants :

  • Forfaits de données mobiles - Allocations mensuelles de 5 Go, 10 Go, 20 Go
  • Sans fil fixe - Illimité ou plafonné à des montants élevés (500 Go, 1 To)
  • Recharges - Données supplémentaires achetées en milieu de cycle
  • Services de dongle - Données prépayées pour les appareils hotspot

Compartiments multiples :

Les services ont souvent plusieurs soldes de données :

  • Allocation mensuelle (expire mensuellement)
  • Données bonus (expirent après la période de campagne)
  • Données de recharge (expiration plus courte, consommées en premier)

Solde de voix​

Suit les minutes d'appels téléphoniques.

Unités : Minutes (min)

Format d'affichage :

Progression : 125 min / 500 min (25%)

Suivi de la durée des appels :

  • Appels entrants (s'ils sont facturés)
  • Appels sortants
  • Appels internationaux (compartiment séparé si applicable)
  • Numéros premium

Calcul :

L'utilisation de la voix est calculée par la durée des appels en nanosecondes en interne, convertie en minutes pour l'affichage.

Solde de SMS​

Suit l'utilisation des messages texte.

Unités : Messages (msgs)

Format d'affichage :

Progression : 45 / 250 (18%)

Types de messages :

  • SMS standard (160 caractères)
  • Long SMS (plusieurs segments)
  • MMS (si suivi séparément)

Solde monétaire​

Suit le crédit prépayé ou le solde du compte.

Unités : Monnaie (£, $, €, etc.)

Format d'affichage :

Progression : £15.50 / £20.00 (77%)

Utilisation :

  • Les comptes prépayés utilisent le solde monétaire pour payer l'utilisation
  • Le crédit diminue à mesure que le client utilise les services
  • Peut être rechargé via un paiement ou un bon
  • Peut expirer s'il n'est pas utilisé dans la période de validité

Détail du solde​

Cliquez sur "Plus d'infos" sur n'importe quelle carte ou cliquez sur une barre de progression pour développer le détail.

Vue développée :

📦 Allocation mensuelle 20 Go

: Restant : 12.5 Go Utilisé : 7.5 Go Expire : 25 Jan 2025 (15 jours) Poids : 10

📦 Données bonus 5 Go

: Restant : 5.0 Go Utilisé : 0 Go Expire : 31 Jan 2025 (21 jours) Poids : 20

📦 Données de recharge 3 Go

: Restant : 0 Go Utilisé : 3.0 Go Expire : 18 Jan 2025 (EXPIRÉ) Poids : 30

Total restant : 17.5 Go

Champs du compartiment de solde :

  • ID/Nom - Identifiant pour le compartiment de solde
  • Restant - Montant restant dans ce compartiment spécifique
  • Utilisé - Montant consommé de ce compartiment
  • Date d'expiration - Quand ce solde expire
  • Poids - Ordre de priorité (poids plus élevé consommé en premier)

Système de poids​

Les soldes ont une valeur de poids qui détermine l'ordre de consommation :

  • Poids plus élevé = consommé en premier
  • Poids plus bas = consommé en dernier

Exemples de poids :

  • Données de recharge : Poids 30 (consommé en premier, expiration plus courte)
  • Données bonus : Poids 20 (consommé en deuxième)
  • Allocation mensuelle : Poids 10 (consommé en dernier, expiration la plus longue)

Cela garantit que les soldes expirants sont utilisés avant ceux qui durent plus longtemps.

Mises à jour en temps réel​

Les données d'utilisation se rafraîchissent automatiquement toutes les 3 secondes via un sondage.

Qu'est-ce qui se met à jour :

  • Montants de solde actuels
  • Barres de progression d'utilisation
  • Minuteries d'expiration
  • Détails de chaque compartiment

Expérience utilisateur :

  • Aucun rechargement de page requis
  • Mises à jour fluides sans scintillement
  • Superposition de chargement pendant le rafraîchissement
  • Badge d'état montrant l'état actuel du service

Cas d'utilisation :

  • Surveiller l'utilisation du client pendant l'appel
  • Observer la diminution du solde en temps réel à mesure que le client utilise le service
  • Vérifier la recharge immédiatement après l'achat

Utilisation dans différents types de services​

Services mobiles​

Affiche les quatre types de solde :

  • Données (Go)
  • Voix (minutes)
  • SMS (messages)
  • Monétaire (monnaie)

Exemple :

DONNÉES : 12.5 Go restants VOIX : 125 min restants SMS : 45 msgs restants MONÉTAIRE : £15.50 restants

Sans fil fixe / Internet​

Montre généralement seulement :

  • Données (Go ou To)
  • Monétaire (si prépayé)

Exemple :

DONNÉES : 450 Go / 500 Go restants MONÉTAIRE : £45.00 (crédit prépayé)

Services de point d'accès / Dongle​

Montre le suivi des données spécifiques au dongle :

  • Données (consommées vs. prépayées)
  • Monétaire (solde prépayé)

Mode d'affichage :

Lorsque dongle=true, le composant cache la voix et les SMS, affichant uniquement les soldes de données et monétaires pertinents.

Dépannage​

Utilisation affichée comme 0 / 0

  • Cause : Service non intégré avec OCS ou CGRateS
  • Solution :
    • Vérifiez que le service est provisionné dans OCS
    • Vérifiez la connectivité de l'API OCS
    • Examinez la correspondance de l'UUID du service

Utilisation non mise à jour

  • Cause : Sondage arrêté ou OCS inaccessible
  • Solution :
    • Rafraîchissez la page
    • Vérifiez la console du navigateur pour des erreurs
    • Vérifiez que l'API OCS est en ligne

Les soldes affichent des montants incorrects

  • Cause : Mismatch de données OCS ou problème de mise en cache
  • Solution :
    • Forcer le rafraîchissement du solde OCS
    • Vérifiez les transactions en attente
    • Vérifiez la configuration OCS

Dates d'expiration manquantes

  • Cause : Le solde n'a pas d'expiration définie
  • Solution :
    • Certains soldes sont définis pour ne jamais expirer (validité illimitée)
    • Vérifiez la configuration du solde dans OCS

Soldes multiples déroutants

  • Cause : Plusieurs recharges ou données bonus ajoutées
  • Solution :
    • Utilisez la vue détaillée pour voir tous les compartiments
    • Triez par poids pour voir l'ordre de consommation
    • Examinez les dates d'expiration individuelles

Intégration avec OCS/CGRateS​

Les données d'utilisation proviennent du OCS (Système de Facturation en Ligne), généralement CGRateS.

Flux de données :

  1. L'utilisateur ouvre la vue d'utilisation
  2. OmniCRM appelle GET /crm/service/{service_id}
  3. L'API interroge OCS via l'UUID du service
  4. OCS renvoie la carte des soldes :
{
  "BalanceMap": {
    "*data": [
      {
        "ID": "monthly_data_20GB",
        "Value": 13421772800,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*voice": [
      {
        "ID": "monthly_voice_500min",
        "Value": 7500000000000,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*sms": [
      {
        "ID": "monthly_sms_250",
        "Value": 250,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*monetary": [
      {
        "ID": "prepaid_credit",
        "Value": 1550,
        "ExpiryTime": "2025-02-25T23:59:59Z",
        "Weight": 10
      }
    ]
  }
}
  1. L'UI convertit les valeurs en unités d'affichage (octets → Go, nanosecondes → minutes)
  2. Barres de progression et cartes rendues
  3. Le sondage continue toutes les 3 secondes

Mapping des types de solde OCS :

L'OCS renvoie des données de solde avec des préfixes de type qui se mappent à l'affichage de l'UI :

  • *data → CARTE DE DONNÉES (utilisation Internet)
  • *voice → CARTE DE VOIX (minutes d'appel)
  • *sms → CARTE DE SMS (messages texte)
  • *monetary → CARTE MONÉTAIRE (crédit prépayé)

Chaque type de solde peut avoir plusieurs compartiments (par exemple, allocation mensuelle + données bonus + données de recharge), tous affichés dans la vue détaillée.

Conversions de valeurs de solde :

  • Données : Octets → Go (diviser par 1024³)
  • Voix : Nanosecondes → Minutes (diviser par 60×10⁹)
  • SMS : Compte (pas de conversion)
  • Monétaire : Cents → Monnaie (diviser par 100)

Auto-Renouvellement et ActionPlans​

Les services avec auto-renouvellement activé ont des ActionPlans programmés dans l'OCS.

Qu'est-ce que les ActionPlans ?

Les ActionPlans sont des tâches programmées dans CGRateS qui s'exécutent automatiquement à des moments spécifiques pour :

  • Ajouter du solde à un compte (recharge automatique)
  • Renouveler les allocations mensuelles
  • Appliquer des frais récurrents
  • Expirer les anciens soldes

Comment fonctionne l'auto-renouvellement :

  1. Provisionnement du service :

    • Lorsque le service est créé avec auto_renew = true
    • Le playbook de provisionnement crée un ActionPlan dans l'OCS
    • ActionPlan configuré pour s'exécuter mensuellement (ou par cycle de facturation)

  2. Configuration de l'ActionPlan :

    L'ActionPlan contient :

    • ID de compte - UUID du service
    • Actions - Que faire (ajouter des données, de la voix, des SMS, du solde monétaire)
    • Calendrier - Quand exécuter (par exemple, mensuellement le 1er à 00:00 UTC)
    • Montant - Combien de solde ajouter

  3. Exécution automatique :

    • L'OCS exécute l'ActionPlan à l'heure programmée
    • Ajoute du solde au compte (par exemple, 20 Go de données, 500 minutes de voix)
    • Définit la date d'expiration pour le nouveau solde (par exemple, 30 jours)
    • Le client est facturé via le mode de paiement enregistré

  4. Visualisation des ActionPlans :

    • Naviguez vers les détails du service dans la vue OCS
    • ActionPlans listés avec le prochain temps d'exécution
    • Montre : Nom du plan, date de prochaine exécution, détails de l'action

Exemple d'ActionPlan :

{
  "ActionPlanId": "ProductID_MonthlyPlan__ProductName_20GB_Mobile__ActionPlan_Monthly_Renew",
  "NextExecTime": "2025-02-01T00:00:00+00:00",
  "ActionName_hr": "Renouvellement Mensuel",
  "PlanName": "20 Go Mobile",
  "ActionFrequency_hr": "Chaque Plan Mensuel",
  "custom_NextExecTime_hr": "dans 22 jours"
}

Gestion de l'auto-renouvellement :

  • Activer - Définir lors de la création ou de la modification du service
  • Désactiver - Supprimer l'ActionPlan de l'OCS (le service conserve le solde existant mais ne sera pas auto-renouvelé)
  • Modifier - Changer le montant ou la fréquence de renouvellement via la modification du service

Renouvellement manuel :

Si l'auto-renouvellement est désactivé, le client doit manuellement :

  • Recharger avant que le solde n'expire
  • Ou le service est suspendu lorsque le solde est épuisé

Visualisation dans l'UI :

L'onglet des services montre l'état de l'auto-renouvellement :

Prochain renouvellement : 1er févr. 2025 (dans 22 jours) Montant de renouvellement : £15.00

Meilleures pratiques​

Pour le personnel de support :

  • Vérifiez l'utilisation avant de répondre aux appels "Pourquoi mon service est-il lent ?"
  • Vérifiez le solde après les recharges pour confirmer le succès
  • Utilisez le détail pour identifier les compartiments expirés
  • Surveillez les clients à forte consommation pour éviter les dépassements

Pour les clients (Auto-Service) :

  • Vérifiez régulièrement l'utilisation pour éviter de manquer de solde
  • Rechargez avant que le solde n'expire
  • Comprenez le système de poids pour savoir quel solde est consommé en premier
  • Contactez le support si l'utilisation semble incorrecte

Pour les administrateurs :

  • Configurez des expirations de solde appropriées
  • Définissez des valeurs de poids pour prioriser les soldes expirants
  • Surveillez la connectivité OCS pour un reporting précis
  • Vérifiez que les configurations de solde correspondent aux offres de produits

Documentation connexe​

  • features_topup_recharge - Système de recharge pour ajouter du solde
  • csa_service_management - Gestion des services
  • csa_modify - Ajout d'options pour augmenter les allocations
  • concepts_products_and_services - Configuration des produits