ProactiveTriggerAPI : dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • La fonctionnalité ProactiveTriggerAPI vous permet de créer des déclencheurs côté serveur qui envoient des messages contextuels à un utilisateur spécifié.

    Cette API utilise des règles et des actions connexes basées sur ces règles pour envoyer des messages à un utilisateur. Ces règles et actions sont spécifiques au contexte et sont basées sur les données en temps réel recueillies à mesure que l’utilisateur navigue sur les pages du portail. Pour en savoir plus, consultez Proactive Triggers.

    Avant d’utiliser cette API, les types de déclencheurs, les règles et les actions doivent être configurés sur votre instance. Pour en savoir plus sur la configuration Déclencheurs proactifs, reportez-vous à la section Configuring Proactive Triggers.

    À l’aide de cette API, vous pouvez envoyer des messages à un utilisateur spécifique ou à un utilisateur d’une session spécifique.

    Par exemple, dans le cas où un client ajoute des éléments à son panier, vous pouvez avoir un Déclencheurs proactifs événement dans une règle métier qui envoie un rappel à l’utilisateur pour qu’il termine le paiement après un certain temps.

    De même, si un utilisateur effectue un Recherche IA à partir d’un Portail de services et qu’aucun résultat n’est renvoyé, vous pouvez avoir une logique dans une règle métier qui crée un Déclencheurs proactifs qui envoie d’autres offres à l’utilisateur via le client Web de message contextuel proactif.

    Lors de l’appel de ProactiveTriggerAPI, il existe une séquence spécifique dans laquelle vous devez appeler les méthodes. Cette API s’exécute dans l’espace de noms sn_pt .

    Tout d’abord, vous devez appeler la ProactiveTriggerAPI : createTrigger(String triggerTypeId) méthode pour spécifier le type de déclencheur que vous souhaitez créer. Cet appel est requis. Pour obtenir la liste des types de déclencheurs disponibles, reportez-vous à la section How Proactive Triggers work.

    Ensuite, vous devez appeler l’une des méthodes qui identifie l’utilisateur auquel les messages doivent être envoyés. Pour ce faire, appelez l’une des méthodes suivantes :

    Ensuite, vous devez appeler la ProactiveTriggerAPI : setTriggerRecord(String triggerRecord) méthode pour spécifier l’enregistrement de déclencheur auquel appliquer les règles et les actions des déclencheurs proactifs.

    Enfin, appelez la ProactiveTriggerAPI : process() méthode pour exécuter la chaîne d’appel. Les appels de méthodes setTriggerRecord() et process() sont requis.

    Par exemple :
    var eventSysId = sn_pt.ProactiveTriggerAPI.createTrigger(triggerTypeId)
  .setUserName(userName).setTriggerRecord(userId).process();

    ProactiveTriggerAPI : createTrigger(String triggerTypeId)

    Crée un événement côté Déclencheurs proactifs serveur.

    Tableau 1. Paramètres
    Nom Type Description
    triggerTypeId Chaîne ID unique du type de déclencheur à créer.

    Par exemple : triggerTypeId = « sn_pt.ai_search_event »

    Table : champ ID de la table Types de déclencheurs proactifs [sys_cs_ptrigger_trigger_type].
    Tableau 2. Renvoie
    Paramètre Description
    Néant

    La règle métier suivante montre comment appeler la méthode createTrigger() à l’intérieur d’une règle métier.

    try {
  var triggerTypeId = "sn_pt.ai_search_event";
  var userId = current.getValue("user");

  var eventSysId = sn_pt.ProactiveTriggerAPI.createTrigger(triggerTypeId)
       .setUserId(userId).setTriggerRecord(current).process();

  // Returns the Proactive Trigger Event record's sys_id
  gs.info("Proactive Trigger Event Sys Id:"+ eventSysId);

} catch (e) {
    gs.info("error:"+e); // Log the error.
}

    ProactiveTriggerAPI : process()

    Exécute la demande d’API spécifiée Déclencheurs proactifs .

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    sys_id Sys_id de l’enregistrement Événement déclencheur proactif qui a été créé.

    Type de données : chaîne

    Table : Événement proactif [sys_cs_ptrigger_event]

    La règle métier suivante montre comment appeler la méthode process() pour exécuter la demande d’API spécifiée Déclencheurs proactifs .

    try {
  var triggerTypeId = "sn_pt.ai_search_event";
  var userId = current.getValue("user");

  var eventSysId = sn_pt.ProactiveTriggerAPI.createTrigger(triggerTypeId)
       .setUserId(userId).setTriggerRecord(current).process();

  // Returns the Proactive Trigger Event record's sys_id
  gs.info("Proactive Trigger Event Sys Id:"+ eventSysId);

} catch (e) {
    gs.info("error:"+e); // Log the error.
}

    ProactiveTriggerAPI : setTriggerRecord(String triggerRecord)

    Définit l’enregistrement de déclenchement auquel appliquer les règles et les actions des déclencheurs proactifs.

    Ces règles et actions sont définies dans l’enregistrement de type de déclencheur associé, situé dans la table Types de déclencheur proactif [sys_cs_ptrigger_trigger_type].

    Tableau 5. Paramètres
    Nom Type Description
    triggerRecord String ou GlideRecord Sys_id ou GlideRecord de l’enregistrement de déclencheur auquel appliquer les règles et les actions des déclencheurs proactifs associés. L’enregistrement du déclencheur se trouve dans la table spécifiée dans le champ trigger_table de l’enregistrement du type de déclencheur qui a été spécifié dans l’appel de méthode createTrigger( ).

    Par exemple, si votre appel createTrigger() spécifie le type de déclencheur Événement Recherche IA, la table de déclencheur est la table Événement de recherche [sys_search_event].

    Remarque :
    Cette table est généralement la même que celle qui a provoqué l’exécution de la règle métier. Si ce n’est pas le cas, vous devrez ajouter cette sys_id au GlideRecord afin de pouvoir la transmettre dans cette méthode.
    Tableau 6. Renvoie
    Type Description
    Néant

    La règle métier suivante montre comment appeler la méthode setTriggerRecord( ).

    try {
  var triggerTypeId = "sn_pt.ai_search_event";
  var userId = current.getValue("user");

  var eventSysId = sn_pt.ProactiveTriggerAPI.createTrigger(triggerTypeId)
       .setUserId(userId).setTriggerRecord(current).process();

  // Returns the Proactive Trigger Event record's sys_id
  gs.info("Proactive Trigger Event Sys Id:"+ eventSysId);

} catch (e) {
    gs.info("error:"+e); // Log the error.
}

    ProactiveTriggerAPI : setUserId(String userId)

    Définit l’utilisateur à qui envoyer le message généré par l’événement associé Déclencheurs proactifs à l’aide de l’ID d’utilisateur.

    Tableau 7. Paramètres
    Nom Type Description
    userId Chaîne Sys_id de l’utilisateur auquel envoyer le message associé Déclencheurs proactifs .

    Table : table des utilisateurs [sys_user] ou dans le GlideRecord associé.
    Tableau 8. Renvoie
    Paramètre Description
    Néant

    L’exemple de code suivant montre comment appeler la méthode setUserId() à l’aide de la valeur du champ utilisateur du GlideRecord actuel.

    try {
  var triggerTypeId = "sn_pt.ai_search_event";
  var userId = current.getValue("user");

  var eventSysId = sn_pt.ProactiveTriggerAPI.createTrigger(triggerTypeId)
       .setUserId(userId).setTriggerRecord(current).process();

  // Returns the Proactive Trigger Event record's sys_id
  gs.info("Proactive Trigger Event Sys Id:"+ eventSysId);

} catch (e) {
    gs.info("error:"+e); // Log the error.
}

    ProactiveTriggerAPI : setUserName(String userName)

    Définit l’utilisateur à qui envoyer le message généré par l’événement associé Déclencheurs proactifs à l’aide du nom d’utilisateur.

    Tableau 9. Paramètres
    Nom Type Description
    userName Chaîne Nom de l’utilisateur auquel envoyer le message proactif. Ce nom doit être mis en corrélation avec le champ ID de l’utilisateur dans la table Utilisateur [sys_user], tel que « abel.tuter ».
    Tableau 10. Renvoie
    Paramètre Description
    Néant

    La règle métier suivante montre comment appeler la méthode setUserName() à l’aide de la valeur du champ sys_created_by du GlideRecord actuel.

    try {
  var triggerTypeId = "sn_pt.ai_search_event";

  // User name of the user to whom to send the proactive message.
  var userName = current.getValue("sys_created_by");

  var eventSysId = sn_pt.ProactiveTriggerAPI.createTrigger(triggerTypeId)
       .setUserName(userName).setTriggerRecord(current).process();

  // Returns the Proactive Trigger Event record's sys_id
  gs.info("Proactive Trigger Event Sys Id:"+ eventSysId);

} catch (e) {
    gs.info("error:"+e); // Log the error.
}

    ProactiveTriggerAPI : setUserSessionId(String userId)

    Définit l’ID de session utilisateur sur l’événement associé Déclencheurs proactifs . Avec cette méthode, le message proactif n’est envoyé qu’à l’utilisateur spécifique associé à une session spécifique.

    Tableau 11. Paramètres
    Nom Type Description
    userSessionId Chaîne Sys_id de la session en cours de l’utilisateur auquel le Déclencheurs proactifs message doit être envoyé.
    Remarque :
    Toutes les tables ne contiennent pas d’ID de session. Avant d’utiliser ce point de terminaison, assurez-vous que la table que vous référencez contient un ID de session valide. Dans le cas contraire, le dernier ID de session disponible est utilisé, ce qui peut entraîner des résultats erronés.
    Tableau 12. Renvoie
    Paramètre Description
    Néant

    La règle métier suivante montre comment appeler la méthode setUserSessionId() à l’aide de la valeur du champ session du GlideRecord actuel.

    try {
  var triggerTypeId = "sn_pt.ai_search_event";
  var sessionId = current.getValue("session");

  var eventSysId = sn_pt.ProactiveTriggerAPI.createTrigger(triggerTypeId)
       .setUserSessionId(sessionId).setTriggerRecord(current).process();

  // Returns the Proactive Trigger Event record's sys_id
  gs.info("Proactive Trigger Event Sys Id:"+ eventSysId);

} catch (e) {
    gs.info("error:"+e); // Log the error.
}