Conversation - Dans le champ d’application

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture

    • L’API 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 d’espace de noms sn_connect. Le module d’extension Connect Scriptable API (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 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 type. Le système de base comprend les options de type suivantes :
    • connexion
    • soutien
    • groupe
    • pair
    • 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 : get(String sysID)

    Renvoie une conversation Connect existante par sys_id.

    Tableau 5. Paramètres
    Nom Type Description
    sysID Chaîne Le 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 la chaîne, champ de chaîne)

    Envoie un message dans une conversation.

    Tableau 9. Paramètres
    Nom Type Description
    Corps Chaîne Texte principal du message.
    Champ Chaîne Champ dans lequel vous souhaitez que le message s’affiche. N’utilisez cette option que 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"});