Conversation - スコープ対象

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む3読むのに数分
  • Conversation API を使用すると、Connect の会話を作成または変更できます。

    スコープ対象のアプリケーションでこのクラスを使用するには、sn_connect 名前空間識別子を使用します。会話 API にアクセスするには、Connect Scriptable API プラグイン (ID:com.glide.connect.scriptable) を有効にする必要があります。

    ScopedConversation - get(String sysID)

    既存の Connect 会話を sys_id で取得します。

    表 : 1. パラメーター
    名前 タイプ 説明
    sysID 文字列 対話レコードの sys_id
    表 : 2. 返される内容
    タイプ 説明
    オブジェクト 会話オブジェクト
    var conversation = sn_connect.Conversation.get("27b9844c1385030034bb58a12244b037");

    ScopedConversation - create(String name)

    コネクト会話を作成します。

    表 : 3. パラメーター
    名前 タイプ 説明
    name 文字列 特定の名前の会話を作成します。
    type 文字列 特定の会話タイプを含めます。タイプは、タイプ選択リストによって決定されます。基本システムには、次のタイプのオプションがあります。
    • 接続
    • サポート
    • グループ
    • ピア
    • クンダ
    • チーム
    表 : 4. 返される内容
    タイプ 説明
    オブジェクト スクリプト可能な会話
    var conversation = sn_connect.Conversation.create({
        name: "Hello world",
        type: "connect"
    });

    ScopedConversation - addSubscriber(String sysID)

    会話をユーザーに追加します。

    表 : 5. パラメーター
    名前 タイプ 説明
    sysID 文字列 会話に追加するユーザーの sys_id です。
    表 : 6. 返される内容
    タイプ 説明
    なし
    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.addSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

    ScopedConversation - removeSubscriber(String sysID)

    会話から削除します。

    表 : 7. パラメーター
    名前 タイプ 説明
    SysID 文字列 会話から削除するユーザーの sys_id
    表 : 8. 返される内容
    タイプ 説明
    なし
    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.removeSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

    ScopedConversation - sendMessage(String body, String field)

    会話にメッセージを送信します。

    表 : 9. パラメーター
    名前 タイプ 説明
    本文 文字列 メッセージの本文
    フィールド 文字列 メッセージを表示するフィールド。レコード会話にメッセージを追加する場合にのみ、このオプションを使用します。work_notes、コメント、またはシステムから選択してください。フィールドシステムを使用すると、メッセージがシステムメッセージとして扱われます。
    表 : 10. 返される内容
    タイプ 説明
    なし
    var conversation = sn_connect.Conversation.get("2064fa3919010300964f5270e9840fbb");
    conversation.sendMessage({body: "Hello world", field: "work_notes"});