---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

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에 접근하려면 커넥트 스크립트 가능 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 특정 이름으로 대화를 생성합니다. |
| 유형 | 문자열 | 특정 대화 유형을 포함합니다. 유형은 유형 선택 목록에 따라 결정됩니다. 기본 시스템에는 다음과 같은 유형 옵션이 포함됩니다. * 연결 * 지원 * 그룹 * 피어 * 콴다 * 팀 {#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(String 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(String 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"});