---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 会話 - スコープ対象

# 会話 - スコープ対象 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

Conversation API を使用すると、Connect の会話を作成または変更できます。

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

## 会話 - addSubscriber(文字列 sysID) {#ariaid-title2}

会話にユーザーを追加します。
{#conversation-addSubscriber_string__table_e3k_bmx_cbb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysID | 文字列 | 会話に追加するユーザーの sys_id です。 |
[表 : 1. パラメーター]

{#conversation-addSubscriber_string__table_e3k_bmx_cbb} {#conversation-addSubscriber_string__table_f3k_bmx_cbb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 2. 返される内容]

{#conversation-addSubscriber_string__table_f3k_bmx_cbb}  

    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.addSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

## 会話 - create(文字列名) {#ariaid-title3}

コネクト会話を作成します。
{#conversation-create_String_String__table_lwg_b4w_cbb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | 特定の名前の会話を作成します。 |
| type | 文字列 | 特定の会話タイプを含めます。タイプは、タイプ選択リストによって決定されます。基本システムには、次のタイプのオプションがあります。 * 接続 * サポート * グループ * ピア * クンダ * チーム {#conversation-create_String_String__ul_ut2_4df_wbb} |
[表 : 3. パラメーター]

{#conversation-create_String_String__table_lwg_b4w_cbb} {#conversation-create_String_String__table_mwg_b4w_cbb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | スクリプト可能な会話 |
[表 : 4. 返される内容]

{#conversation-create_String_String__table_mwg_b4w_cbb}  

    var conversation = sn_connect.Conversation.create({
        name: "Hello world",
        type: "connect"
    });

## 会話:get(文字列 sysID) {#ariaid-title4}

コネクトの既存の会話をsys_id別に返します。
{#conversation-get-string__table_zkg_1x5_bbb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysID | 文字列 | 対話レコードの sys_id |
[表 : 5. パラメーター]

{#conversation-get-string__table_zkg_1x5_bbb} {#conversation-get-string__table_alg_1x5_bbb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 会話オブジェクト |
[表 : 6. 返される内容]

{#conversation-get-string__table_alg_1x5_bbb}  

    var conversation = sn_connect.Conversation.get("27b9844c1385030034bb58a12244b037");

## 会話 - removeSubscriber(文字列 sysID) {#ariaid-title5}

会話からユーザーを削除します。
{#conversation-removeSubscriber_string__table_e3k_bmx_cbb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| SysID | 文字列 | 会話から削除するユーザーの sys_id |
[表 : 7. パラメーター]

{#conversation-removeSubscriber_string__table_e3k_bmx_cbb} {#conversation-removeSubscriber_string__table_f3k_bmx_cbb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 8. 返される内容]

{#conversation-removeSubscriber_string__table_f3k_bmx_cbb}  

    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.removeSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

## 会話 - sendMessage(文字列 body, 文字列 field) {#ariaid-title6}

会話にメッセージを送信します。
{#conversation-sendMessage_String_String__table_kcw_pmv_2bb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 本文 | 文字列 | メッセージの本文 |
| フィールド | 文字列 | メッセージを表示するフィールド。レコード会話にメッセージを追加する場合にのみ、このオプションを使用します。work_notes、コメント、またはシステムから選択してください。フィールドシステムを使用すると、メッセージがシステムメッセージとして扱われます。 |
[表 : 9. パラメーター]

{#conversation-sendMessage_String_String__table_kcw_pmv_2bb} {#conversation-sendMessage_String_String__table_lcw_pmv_2bb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 10. 返される内容]

{#conversation-sendMessage_String_String__table_lcw_pmv_2bb}  

    var conversation = sn_connect.Conversation.get("2064fa3919010300964f5270e9840fbb");
    conversation.sendMessage({body: "Hello world", field: "work_notes"});