Conversation - Dans le champ d’application
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.
| Nom | Type | Description |
|---|---|---|
| sysID | Chaîne | sys_id de l’enregistrement de conversation. |
| 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.
| 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 :
|
| 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.
| Nom | Type | Description |
|---|---|---|
| sysID | Chaîne | Sys_ID de l’utilisateur que vous souhaitez ajouter à une conversation. |
| 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.
| Nom | Type | Description |
|---|---|---|
| SysID | Chaîne | L’sys_id de l’utilisateur que vous souhaitez supprimer d’une conversation. |
| 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.
| 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. |
| Type | Description |
|---|---|
| nul |
var conversation = sn_connect.Conversation.get("2064fa3919010300964f5270e9840fbb");
conversation.sendMessage({body: "Hello world", field: "work_notes"});