Configurer le code pour les alertes critiques

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 systèmes d’exploitation Android 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 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 Android les 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 de l’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 de 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 la liste complète, reportez-vous à la section Configurer les sons pour les notifications push.
      Valeurs de noms de fichiers acceptées Rythme tonal
      AlerteNotification-2.caf Dramatique
      NotificationAlerte-2-Court.caf Dramatique
      NotificationAlert-9.caf Spectaculaire, puissant
      NotificationAlerte-9-Court.caf Spectaculaire, puissant
      NotificationAlert-10.caf Dramatique, plein de suspense
      NotificationAlerte-10-Court.caf Dramatique, plein de suspense
      Remarque :
      Si aucune name valeur n’est 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 de l’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

    Ce qui suit est un exemple complet de bloc de code JSON que vous devez ajouter et configurer pour activer une alerte critique pour Android et iOS 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) include de script 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 des logiques de script côté serveur réutilisables qui définissent une fonction ou une classe. CriticalPushPayLoadBuilder est un include de script qui contient des fonctions pour prendre en charge les alertes critiques. L’appel des includes de script ressemble à ceci : CriticalPushPayloadBuilder (actuel, json, attributs).buildJSON()
    Remarque :
    Si vous devez modifier les valeurs des paramètres Volume ou 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 include de script.