Conversation - Dans le champ d’application

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 1 minute de lecture
  • L’API Conversation vous permet de créer ou de modifier des conversations Connect.

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

    Conversation incluse dans le périmètre : get(String sysID)

    Obtenir une conversation Connect existante par sys_id.

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

    Conversation incluse dans le périmètre : create(nom de chaîne)

    Créez une Connexion 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 de types. Le système de base comprend les options de type suivantes :
    • connexion
    • Soutien
    • groupe
    • Peer
    • Qanda
    • équipe
    Tableau 4. Renvoie
    Type Description
    Objet Conversation pouvant contenir des scripts
    var conversation = sn_connect.Conversation.create({
        name: "Hello world",
        type: "connect"
    });

    Conversation incluse dans le périmètre : addSubscriber(String sysID)

    Ajoutez un utilisateur à une conversation.

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

    Conversation incluse dans le périmètre : removeSubscriber(String sysID)

    Supprimer un utilisateur d’une conversation.

    Tableau 7. Paramètres
    Nom Type Description
    SysID Chaîne L’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 incluse dans le périmètre : sendMessage (corps de chaîne, champ de chaîne)

    Envoyer un message à une conversation.

    Tableau 9. Paramètres
    Nom Type Description
    Corps Chaîne Texte principal du message.
    Champ Chaîne Champ dans lequel vous souhaitez afficher le message. 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"});