Message supplémentaire pour les alertes d'application sur appareil mobile

Présentation de la structure JSON

Le champ Message supplémentaire utilise un format JSON structuré composé de trois sections principales : message, notificationActions et tags. Les sections fournissent un guide contextuel, des raccourcis de navigation et des étiquettes de classification pour l'alerte.

Structure générale :

{
"message": "<message body>",
"notificationActions": [],
"tags": ["<tag label>"]
        }

Exemple de champ Message supplémentaire complet au format JSON :

{
  "message": "Share the latest Immunexis efficacy message with <a href=\"lsc://deeplink/lightning/r/Account/<AccountRecordID>/view\">Dr. Aaron Morita</a>.",
  "notificationActions": [
    {
      "title": "Check New Content",
      "action": "lsc://deeplink/lightning/n/lsc4ce__IntelligentContent"
    },
    {
      "title": "Dismiss",
      "actionable": true,
      "actionName": "Dismissed",
      "dismissOptions": ["Acknowledged"],
      "dismissOptionRequired": true
    }
  ],
  "tags": ["Recommendation","Next Best"]
}

Message

La section message définit le contenu de l'alerte principale affichée pour les utilisateurs. La section peut inclure des liens de navigation incorporés à un texte en utilisant des balises d'ancrage HTML (<a>). Seules les balises de lien hypertexte <a> sont prises en charge dans le contenu du message. Pour les types de lien pris en charge et les formats de lien profond, consultez Liens de navigation dans Message supplémentaire.

La valeur du message est stockée sous forme de chaîne JSON. Par conséquent, assurez-vous que les guillemets doubles (") contenus dans le message sont échappés en utilisant une barre oblique inversée (\). Cela est requis lors de la définition de liens hypertexte en utilisant l'attribut href.

Exemple de format de lien hypertexte :

<a href=\"URL\">Link Text</a>

Exemple de lien profond vers un enregistrement Compte spécifique :

"message":"Share the latest efficacy message with <a href=\"lsc://deeplink/lightning/r/Account/<AccountRecordID>/view\">Dr. Aaron Morita</a>. Check the updated content, plan your next visit, and loop in your team."

Pour ouvrir le lien dans le navigateur externe par défaut de l'appareil, par exemple Safari sur iOS, insérez l'attribut target="_blank" dans le lien hypertexte.

<a href=\"URL\" target=\"_blank\">Link Text</a>

Remarque Les navigateurs externes demandent aux utilisateurs de se reconnecter, car les jetons d'authentification ne sont pas automatiquement transmis. Pour garantir une expérience transparente sans invite supplémentaire, nous recommandons d'utiliser le navigateur dans l'application. Alternativement, les utilisateurs peuvent accéder à l'icône de profil utilisateur dans l'application mobile, sélectionner Afficher en ligne, puis sélectionner l'URL de l'alerte d'application pour contourner l'authentification manuelle.

Actions de notification

La section notificationActions définit des boutons interactifs dans l'interface d'alerte. Vous pouvez implémenter deux types d'action distincts : Lier des actions et des actions Réponse.

1. Actions de lien

Les actions de lien permettent aux utilisateurs de naviguer vers des destinations Life Sciences Cloud internes, des sites Web externes ou des applications externes. Ces actions utilisent les formats de lien de navigation et les destinations ouvertes en utilisant une action basée sur l'URL.

Structure générale :

{
        "title": "Button Label",
        "action": "URL"
        }

Exemple :

{
        "title": "Add to Upcoming Visit",
        "action": "lsc://deeplink/lightning/r/Visit/<VisitRecordID>/edit"
        }

2. Actions de réponse

Les actions de réponse permettent aux utilisateurs de mettre directement à jour l'état de l'alerte. Les utilisateurs peuvent rejeter, résoudre ou accepter un message. Utilisez ces actions pour marquer les notifications comme traitées ou déclencher des workflows automatisés. Ces actions peuvent recueillir un motif lorsque les utilisateurs ignorent l'alerte.

Structure générale :

{
        "title": "Button Label",
        "actionable": true,
        "actionName": "ResponseValue",
        "dismissOptions": ["Reason1", "Reason2"],
        "dismissOptionRequired": true
        }

Exemple :

{
        "title": "Dismiss",
        "actionable": true,
        "actionName": "Dismissed",
        "dismissOptions": ["Acknowledged", "Expired"],
        "dismissOptionRequired": true
        }

Balises

La section tags utilise des balises pour classer les messages supplémentaires et mettre en évidence visuellement leur contexte et leur objet. Les balises sont affichées sous forme d'étiquettes dans l'alerte et aident les utilisateurs à reconnaître rapidement le type de message. Vous pouvez attribuer une ou plusieurs balises à un message. Les balises peuvent représenter des noms de campagne, des présentations de fonctionnalités ou des catégories, par exemple Territoire, Engagement et Mise à jour de produit.

Dans le champ JSON Message supplémentaire, définissez des balises en utilisant l'attribut tags. L'attribut accepte un tableau de valeurs de texte et chaque valeur représente une étiquette affichée dans l'alerte.

Structure générale :

"tags": ["<tag label>", "<tag label>"]

Exemple :

"tags": ["Next Best Message", "Agentforce","Visit Prep"]