Conversation - Dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 1 minute de lecture

    • L’API de conversation vous permet de créer ou de modifier des conversations de connexion.

    Pour utiliser cette classe dans une application incluse dans le périmètre, utilisez l’identificateur de l’espace de noms sn_connect . Le module d’extension API de script Connect (ID : com.glide.connect.scriptable) doit être activé pour accéder à l’API de conversation .

    Conversation : addSubscriber(String sysID)

    Ajoute un utilisateur à une conversation.

    Tableau 1. Paramètres
    Nom Type Description
    sysID Chaîne Sys_ID de l’utilisateur que vous souhaitez ajouter à une conversation.
    Tableau 2. Renvoie
    Type Description
    nul 
    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
conversation.addSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

    Conversation : create(nom de chaîne)

    Crée une Connect conversation.

    Tableau 3. Paramètres
    Nom Type Description
    nom Chaîne Créez une conversation avec un nom spécifique.
    type Chaîne Incluez un type de conversation spécifique. Le type est déterminé par la liste de choix des types. Le système de base comprend les options de type suivantes :
    • connexion
    • soutien
    • groupe
    • pair
    • Questions-réponses
    • équipe
    Tableau 4. Renvoie
    Type Description
    Objet Conversation pouvant contenir des scripts 
    var conversation = sn_connect.Conversation.create({
    name: "Hello world",
    type: "connect"
});

    Conversation : get(String sysID)

    Renvoie une conversation de Connexion existante par sys_id.

    Tableau 5. Paramètres
    Nom Type Description
    sysID Chaîne sys_id de l’enregistrement de conversation.
    Tableau 6. Renvoie
    Type Description
    Objet Objet de conversation 
    var conversation = sn_connect.Conversation.get("27b9844c1385030034bb58a12244b037");

    Conversation : removeSubscriber(String sysID)

    Supprime un utilisateur d’une conversation.

    Tableau 7. Paramètres
    Nom Type Description
    SysID Chaîne Le sys_id de l’utilisateur que vous souhaitez supprimer d’une conversation.
    Tableau 8. Renvoie
    Type Description
    nul 
    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
conversation.removeSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

    Conversation : sendMessage(corps de chaîne, champ de chaîne)

    Envoie un message à une conversation.

    Tableau 9. Paramètres
    Nom Type Description
    Détails Chaîne Le texte principal du message.
    Champ Chaîne Le champ sous lequel vous souhaitez que le message apparaisse. Utilisez uniquement cette option si vous ajoutez un message à une conversation d’enregistrement. Choisissez entre work_notes, commentaires ou système. L’utilisation du système de champs traite le message comme un message système.
    Tableau 10. Renvoie
    Type Description
    nul 
    var conversation = sn_connect.Conversation.get("2064fa3919010300964f5270e9840fbb");
conversation.sendMessage({body: "Hello world", field: "work_notes"});