대화 - 범위 지정

대화 API를 사용하면 커넥 트 대화를 만들거나 수정할 수 있습니다.

범위가 지정된 응용 프로그램에서 이 클래스를 사용하려면 sn_connect 네임스페이스 식별자를 사용합니다. 대화 API에 접근하려면 Connect Scriptable APIs 플러그인(ID: com.glide.connect.scriptable)을 활성화해야 합니다.

범위가 지정된 대화 - get(문자열 sysID)

sys_id별 기존 Connect 대화를 가져옵니다.

표 1. 매개변수

이름	유형	설명
sysID	문자열	대화 기록의 sys_id입니다.

표 2. 반환

유형	설명
객체	대화 객체

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

범위가 지정된 대화 - create(문자열 이름)

커넥트 대화를 생성합니다.

표 3. 매개변수

이름	유형	설명
name	문자열	특정 이름의 대화를 생성합니다.
type	문자열	특정 대화 유형을 포함합니다. 유형은 유형 선택 목록에 따라 결정됩니다. 기본 시스템에는 다음과 같은 유형 옵션이 있습니다. 연결 support 그룹 피어 콴다 팀

표 4. 반환

유형	설명
객체	스크립트 대화

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

범위 지정 대화 - addSubscriber(String sysID)

대화에 사용자를 추가합니다.

표 5. 매개변수

이름	유형	설명
sysID	문자열	대화에 추가할 사용자의 Sys_ID입니다.

표 6. 반환

유형	설명
void

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

범위가 지정된 대화 - removeSubscriber(String sysID)

대화에서 사용자를 제거합니다.

표 7. 매개변수

이름	유형	설명
SysID	문자열	대화에서 제거하려는 사용자의 sys_id입니다.

표 8. 반환

유형	설명
void

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

범위 지정 대화 - sendMessage(문자열 본문, 문자열 필드)

대화에 메시지를 보냅니다.

표 9. 매개변수

이름	유형	설명
본문	문자열	메시지의 주 텍스트입니다.
필드	문자열	메시지를 표시할 필드입니다. 기록 대화에 메시지를 추가하는 경우에만 이 옵션을 사용합니다. work_notes, 코멘트 또는 시스템 중에서 선택합니다. 필드 시스템을 사용하면 메시지가 시스템 메시지로 처리됩니다.

표 10. 반환

유형	설명
void

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