Configurer le code pour les alertes critiques

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture
  • Vous pouvez transformer une notification push en alerte critique en ajoutant du code JSON. Un code JSON différent est utilisé pour iOS les Android systèmes d’exploitation et pour l’unité ITSM business.

    Lors de la création de notifications d’alerte critique, vous avez besoin de la structure de code d’un message de notification push ainsi que du code JSON requis qui définit la notification comme une alerte critique. Vous ajoutez ce code dans la zone de contenu du message push. Pour plus d'informations, consultez Alertes critiques mobiles.

    Important :

    Sur la Android plateforme, lorsqu’un utilisateur reçoit une alerte critique sur certains types de téléphones, il peut rencontrer le comportement d’appareil suivant :

    Appareils OnePlus avec mode sonnerie contrôlé par le matériel :
    Sur des appareils comme OnePlus où le mode sonnerie est contrôlé par un commutateur physique, l’application peut ne pas être en mesure de remplacer le volume sonore de la notification si l’appareil est réglé en mode silencieux ou vibreur.
    Comportement du mode Ne pas déranger de l’appareil OnePlus ou Oppo :
    Sur certains appareils, comme Oppo et OnePlus, si le mode Ne pas déranger (NPD) est activé, le paramètre NPD peut être temporairement désactivé jusqu’à ce que le son de notification critique soit terminé.
    Sur Android les clients de la version 20.0.0 et des versions ultérieures, les alertes critiques ne fonctionnent pas sur les éléments suivants :
    • La Android fonctionnalité d’espace privé qui a été introduite dans Android 15.
    • Android les appareils gérés par un logiciel de gestion des appareils mobiles (MDM). Par exemple, Microsoft Intune.

    JSON d’alerte critique pour activer Android les systèmes d’exploitation

    Le code suivant doit être ajouté au code JSON, car il active les Android appareils pour qu’ils se réveillent afin qu’une alerte critique puisse être déclenchée.
    Remarque :
    Étant donné que les utilisateurs utilisent les deux iOS appareils and Android , vous devez ajouter ce code. L’entrée JSON dans le code est une valeur de nom de dictionnaire renvoyée par le scripting.
     
    
    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
    

    JSON d’alerte critique pour tous les systèmes d’exploitation

    Le JSON suivant doit être ajouté pour qu’une notification se comporte comme une alerte critique.

    var json = {};
    json["aps"] = { 
    "sound": {
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
    }
          };
    
    Les paramètres dans l'exemple de code JSON sont les suivants :
    • Le critical paramètre définit la notification comme une alerte critique. 1 signifie que l’alerte critique est active, 0 signifie que l’alerte critique est inactive.
    • Le name paramètre est le nom de la tonalité qui est activée lorsqu’une alerte critique est envoyée. Certaines tonalités pour les alertes critiques sont répertoriées dans le tableau. Pour obtenir une liste complète, consultez Configurer les sons pour les notifications push.
      Valeurs des noms de fichiers acceptés Rythme de tonalité
      AlerteNotification-2.caf Dramatique
      NotificationAlert-2-Short.caf Dramatique
      NotificationAlert-9.caf Spectaculaire, puissant
      NotificationAlerte-9-Court.caf Spectaculaire, puissant
      NotificationAlert-10.caf Dramatique, plein de suspense
      NotificationAlert-10-Short.caf Dramatique, plein de suspense
      Remarque :
      Si une name valeur n’est pas définie, le système utilise la sonnerie par défaut de l’application. Si une application n’a pas de sonnerie définie, le système utilise la sonnerie par défaut de l’appareil.
    • Le volume paramètre définit le volume du son d’alerte critique. La plage va de 0,1 pour le plus faible à 1,0 pour le plus fort.

    Exemple de bloc de code JSON pour une alerte critique

    Voici un exemple complet de bloc de code JSON que vous devez ajouter et configurer pour activer une alerte critique pour Android et iOS les appareils.

    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
      
    json["aps"]["sound"] = { 
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
          };

    Gestion des services IT (ITSM) Script include CriticalPushPayloader

    La zone de contenu du message push peut contenir du code précédemment configuré, y compris l’include de script CriticalPushPayLoadBuilder, créé par l’unité ITSM business. Si tel est le cas, aucune configuration supplémentaire n’est requise pour les alertes critiques. Les includes de script sont une logique de script côté serveur réutilisable qui définit une fonction ou une classe. CriticalPushPayLoadBuilder est un include de script qui contient des fonctions pour prendre en charge les alertes critiques. L’appel de l’include de script ressemble à ceci : CriticalPushPayloadBuilder (current, json, attributes).buildJSON()
    Remarque :
    Si vous devez modifier les valeurs des paramètres de volume ou de nom , ou changer l’alerte de critique à non critique, vous devez accéder aux paramètres de fonction que l’include de script obtient en entrées.

    La modification de la valeur de l’include de script d’alerte critique affecte toutes les ITSM implémentations de l’include de script. De même, une mise à niveau du module d’extension ITSM peut remplacer les changements que vous avez apportés à votre script include.