---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 会話 - スコープ対象

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

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

会話 API を使用すると、コネクトの会話を作成または変更できます。

スコープ対象のアプリケーションでこのクラスを使用するには、 `sn_connect` 名前空間識別子を使用します。会話 API にアクセスするには、Connect Scriptable APIs プラグイン (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 | 文字列 | 特定の会話タイプを含めます。タイプは、タイプ選択リストによって決まります。ベースシステムには、次のタイプオプションが含まれています。 * 接続 * サポート * グループ * ピア * QANDA * team {#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(文字列本文, 文字列フィールド) {#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"});