---
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


---

# NotifyConferenceUtil - 범위, 전역

# NotifyConferenceUtil - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 31분

NotifyConferenceUtil API에는 다양한 Webex전화 통신 서비스 공급자(Zoom예: )에 대한 알림 컨퍼런스 회의 및 SMS 메시지를 관리하는 메서드가 있습니다.

NotifyConferenceUtil API를 사용하여 다음을 수행할 수 있습니다.  
* 새 컨퍼런스 회의 생성
* 전화번호 또는 사용자 ID로 참가자 추가
* 전화 회의에서 참가자 제거
* 전화 회의에서 참가자 음소거
* 전화 회의에서 참가자 음소거 해제
* 지정된 서비스 제공자의 역량 확보
* 전화 회의 종료
{#NotifyConferenceUtils__ul_qvb_kqy_4hb}

범위가 지정된 스크립트와 전역 스크립트 모두에서 이 API를 사용할 수 있습니다. 이 API를 사용하려면 별도의 구독이 필요한 Conference Notify 플러그인(com.snc.notify)을 활성화해야 합니다. 이 플러그인 활성화에 대한 자세한 내용은 [알림 활성화를](https://www.servicenow.com/docs/access?context=t_ActivateNotify&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하십시오.

## 알림ConferenceUtils - 알림ConferenceUtils() {#ariaid-title2}

NotifyConferenceUtils 객체(생성자)를 인스턴스화합니다.
{#NUtil-NotifyConferenceUtils__table_qy1_cym_d3b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

{#NUtil-NotifyConferenceUtils__table_qy1_cym_d3b}  

    function () {
    	var confGR = new GlideRecord('notify_conference_call');
    	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

    	var confUtils = new NotifyConferenceUtils();
    	var actionResult = confUtils.addToConferenceByPhoneNumber("+917799555331", confGR)
    	if (actionResult.status)
    		gs.info('Participant has been added to conference');
    	else {
    		gs.info('join operation failed');
    		actionResult.warnMessages.forEach(function (msg) {
    			gs.info(msg);
    		});
    		actionResult.errorMessages.forEach(function (msg) {
    			gs.info(msg);
    		})
    	}
    })();

## NotifyConferenceUtils - addToConferenceByPhoneNumber(String toNumber, GlideRecord confGR) {#ariaid-title3}

참가자를 식별하기 위해 전화 번호를 사용하여 지정된 전화 회의에 참가자를 추가합니다.
{#NUtil-addToConferenceByPhoneNumber_S_GR__table_lt1_kth_nhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| toNumber | 문자열 | 전화 회의에 추가할 참가자의 전화 번호입니다. |
| 회의 GR | GlideRecord | 지정된 참가자를 추가할 전화 회의의 GlideRecord입니다. 테이블: 알림 컨퍼런스 회의 \[notify_conference_call\] |
[표 2. 매개변수]

{#NUtil-addToConferenceByPhoneNumber_S_GR__table_lt1_kth_nhb} {#NUtil-addToConferenceByPhoneNumber_S_GR__table_mt1_kth_nhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 회의 작업의 결과입니다. `<action>.status`: 회의 작업의 상태입니다. * 데이터 유형: 부울 * 가능한 값: * true: 회의 작업 성공 * false: 회의 작업 실패 {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_w5y_hyt_b3b} {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_psg_gyt_b3b} `<action>.successMessages`: <var class="keyword varname">상태</var> 가 예일 경우 성공 메시지가 표시되고, 그렇지 않으면 비어 있습니다. * 데이터 유형: 문자열 배열 {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_qm2_myt_b3b} `<action>.warnMessages`: <var class="keyword varname">상태</var> 가 아니오인 경우 처리 중에 발생한 경고 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`: <var class="keyword varname">상태</var> 가 false인 경우 처리 중에 발생하는 오류 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_tht_4yt_b3b} |
[표 3. 반환]

{#NUtil-addToConferenceByPhoneNumber_S_GR__table_mt1_kth_nhb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    function () {
    	var confGR = new GlideRecord('notify_conference_call');
    	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

    	var confUtils = new NotifyConferenceUtils();
    	var actionResult = confUtils.addToConferenceByPhoneNumber("+917799555331", confGR)
    	if (actionResult.status)
    		gs.info('Participant has been added to conference');
    	else {
    		gs.info('join operation failed');
    		actionResult.warnMessages.forEach(function (msg) {
    			gs.info(msg);
    		});
    		actionResult.errorMessages.forEach(function (msg) {
    			gs.info(msg);
    		})
    	}
    })();

## NotifyConferenceUtils - addToConferenceByUserId(문자열 userId, GlideRecord confGR) {#ariaid-title4}

고유 사용자 식별자를 사용하여 전달된 GlideRecord에서 참조하는 컨퍼런스 회의에 참가자를 추가합니다.
{#NUtil-addToConferenceByUserId_S_GR__table_xld_mwh_nhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| userID | 문자열 | 지정된 전화 회의에 추가할 참가자의 시스템 ID입니다. 테이블: 사용자 \[sys_user\] |
| 회의 GR | GlideRecord | 지정된 참가자를 추가하기 위한 전화 회의의 GlideRecord입니다. 테이블: 알림 컨퍼런스 회의 \[notify_conference_call\] |
[표 4. 매개변수]

{#NUtil-addToConferenceByUserId_S_GR__table_xld_mwh_nhb} {#NUtil-addToConferenceByUserId_S_GR__table_yld_mwh_nhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 회의 작업의 결과입니다. `<action>.status`: 회의 작업의 상태입니다. * 데이터 유형: 부울 * 가능한 값: * true: 회의 작업 성공 * false: 회의 작업 실패 {#NUtil-addToConferenceByUserId_S_GR__ul_w5y_hyt_b3b} {#NUtil-addToConferenceByUserId_S_GR__ul_psg_gyt_b3b} `<action>.successMessages`: <var class="keyword varname">상태</var> 가 예일 경우 성공 메시지가 표시되고, 그렇지 않으면 비어 있습니다. * 데이터 유형: 문자열 배열 {#NUtil-addToConferenceByUserId_S_GR__ul_qm2_myt_b3b} `<action>.warnMessages`: <var class="keyword varname">상태</var> 가 아니오인 경우 처리 중에 발생한 경고 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-addToConferenceByUserId_S_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`: <var class="keyword varname">상태</var> 가 false인 경우 처리 중에 발생하는 오류 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-addToConferenceByUserId_S_GR__ul_tht_4yt_b3b} |
[표 5. 반환]

{#NUtil-addToConferenceByUserId_S_GR__table_yld_mwh_nhb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    (function () {
    	var confGR = new GlideRecord('notify_conference_call');
    	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

    	var confUtils = new NotifyConferenceUtils();
    	var actionResult = confUtils.addToConferenceByUserId(gs.getUserID(), confGR)
    	if (actionResult.status)
    		gs.info('Participant has been added to conference');
    	else {
    		gs.info('join operation failed');
    		actionResult.warnMessages.forEach(function (msg) {
    			gs.info(msg);
    		});
    		actionResult.errorMessages.forEach(function (msg) {
    			gs.info(msg);
    		})
    	}
    })();

## NotifyConferenceUtils - doConferenceAction(문자열 작업, 객체 데이터) {#ariaid-title5}

전화 회의 시작/종료 또는 전화 회의에서 참가자 참가, 제거, 음소거 또는 음소거 해제와 같은 지정된 전화 회의 작업을 수행합니다.
새 전화 회의를 시작하고 단일 호출 내에 이 메서드에 참가자를 추가하거나 메서드를 여러 번 호출하여 통화를 시작한 다음 참가자를 별도로 관리할 수 있습니다. 또한 전달된 데이터 객체를 통해 메서드를 다음과 같이 구성할 수 있습니다.

* 전화 회의 기록의 포인터를 인시던트나 문제 등, 전화 회의의 토론 주제인 특정 기록(원본 기록)에 저장합니다.
* 소스 기록에 대한 여러 컨퍼런스 회의를 허용/허용하지 않습니다.
* 소스 기록의 "작업 메모" 필드에 전화 회의에 참석한 참가자를 자동으로 기록합니다.
* 참가자가 회의에서 전화를 걸 때 메시지를 큰 소리로 읽어달라고 합니다.
{#NUtil-doConferenceAction_S_O__ul_rqn_z2y_vhb}
{#NUtil-doConferenceAction_S_O__table_qqs_vdv_nhb__entry__3}{#NUtil-doConferenceAction_S_O__data-entry-NConf}{#NUtil-doConferenceAction_S_O__data.addToWorkNotes-p-NConf}{#NUtil-doConferenceAction_S_O__data.allowMulticonference-p-NConf}{#NUtil-doConferenceAction_S_O__data.confId-p-NConf}{#NUtil-doConferenceAction_S_O__data.fromNumber-p-NConf}{#NUtil-doConferenceAction_S_O__data.isNewConference-p-NConf}{#NUtil-doConferenceAction_S_O__data.items-p-NConf}{#NUtil-doConferenceAction_S_O__data.message-p-NConf}{#NUtil-doConferenceAction_S_O__data.serviceProvider-p-NConf}{#NUtil-doConferenceAction_S_O__data.sys_id-p-NConf}{#NUtil-doConferenceAction_S_O__data.table-p-NConf}

| 이름 | 유형 | 설명 |
|-|-|-|
| 작업 | 문자열 | 수행할 전화 회의 작업을 정의합니다. 사용 가능한 전화 회의 작업은 다음과 같습니다. * end: 에서 식별된 컨퍼런스 회의를 종료합니다.data.confId * join: 배열에 지정된 data.items 참가자를 에 식별 data.confId된 컨퍼런스 회의에 추가합니다. * 킥: 배열에 data.items 지정된 참가자를 에 식별된 전화 회의에서 제거합니다.data.confId * multiJoin: 배열에 지정된 data.items 참가자를 다음에서 식별된 컨퍼런스 회의에 추가합니다. data.confId * multiKick: 배열에 data.items 지정된 참가자를 에 식별 data.confId된 컨퍼런스 회의에서 제거합니다. * multiMute: 에 식별된 전화 회의의 배열에 data.items 지정된 참가자를 음소거합니다.data.confId * multiUnmute: 에 식별된 컨퍼런스 회의에서 배열에 data.items 지정된 참가자를 음소거합니다.data.confId * 음소거: 에 식별된 컨퍼런스 회의의 배열에 data.items 지정된 참가자를 음소거합니다.data.confId * selfJoin: 현재 로그인한 사용자를 컨퍼런스 회의에 추가합니다(항목 data.items 필요 없음). * start: 에서 data.confId식별된 컨퍼런스 회의를 시작합니다. * 음소거 해제: 에 식별된 전화 회의에서 배열에 data.items 지정된 참가자를 음소거 해제합니다.data.confId {#NUtil-doConferenceAction_S_O__ul_pq5_qfv_nhb} |
| 데이터 | 객체 | 전화 회의를 설명하는 객체입니다. |
| data.addToWorkNotes | 부울 | 전화 회의에 포함된 참가자에 대한 정보를 연결된 기록의 작업 메모 필드에 추가할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 작업 메모를 추가할 기록을 식별합니다.{#NUtil-doConferenceAction_S_O__data.addToWorkNotes2-p-NConf} 기본값: false 이 매개변수가 유효한 작업: * 가입 * 다중 조인 * 자체 조인 * 시작 {#NUtil-doConferenceAction_S_O__ul_kwg_ktx_vhb} |
| data.allowMulticonference | 부울 | 특정 기록에 대해 한 번에 여러 컨퍼런스 회의를 허용할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 여러 컨퍼런스 회의를 가질 수 있는 기록을 식별합니다.{#NUtil-doConferenceAction_S_O__data.allowMulticonference2-p-NConf} 기본값: false 이 매개변수가 유효한 작업: * 시작 {#NUtil-doConferenceAction_S_O__ul_ay4_mtx_vhb} |
| data.confId | 문자열 | 컨퍼런스 회의의 Sys_id입니다. 테이블: 알림 컨퍼런스 회의 \[notify_conference_call\]{#NUtil-doConferenceAction_S_O__data.confId2-p-NConf} 이 매개변수가 필요한 작업: * 끝 * 가입 * 다중 조인 * 자체 조인 {#NUtil-doConferenceAction_S_O__ul_afs_qsx_vhb} 주: 음소거, 음소거 해제, 킥과 같은 참가자 작업은 메서드가 알림 컨퍼런스 회의 참가자 \[notify_participant\] 테이블에서 이 정보를 가져오므로 이 매개변수를 설정할 필요가 없습니다. |
| data.fromNumber | 문자열 | 전화 회의를 위해 호출할 서비스 제공자 번호입니다. 알림 전화 번호 \[notify_number\] 테이블의 번호 또는 전화 번호 열에서 이 값을 찾습니다.{#NUtil-doConferenceAction_S_O__data.fromNumber2-p-NConf} 이 매개변수가 필요한 작업: * 시작 {#NUtil-doConferenceAction_S_O__ul_exs_stx_vhb} |
| data.isNewConference | 부울 | 이 전화 회의가 새 전화 회의인지 기존 전화 회의인지 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 새 컨퍼런스 회의 * false: 기존 컨퍼런스 회의 {#NUtil-doConferenceAction_S_O__ul_q1m_wbv_nhb} 기본값: false 이 매개변수가 유효한 작업: * 시작 {#NUtil-doConferenceAction_S_O__ul_d1d_stx_vhb} |
| 데이터.항목 | 배열 | 전화 회의에 포함할 각 참가자에 대한 정보입니다. 유효한 배열 값: * ID: 사용자의 Sys_id입니다. 사용자 \[sys_User\] 테이블에 있습니다.유효한 작업: join, multiJoin, start * notifyParticipantId: 알림 참가자의 시스템 ID입니다. 알림 참가자 \[notify_participant\] 테이블에 있습니다.유효한 작업: join, kick, multiJoin, 음소거, 시작, 음소거 해제 * phoneNumber: 참가자의 전화 번호입니다. 이 값이 OR notifyParticipantId과 id 함께 전달되는 경우 이 값은 사용자/참가자 기록의 전화 번호를 대체하고 전화를 걸 때 사용됩니다. 유효한 작업: join, multiJoin, start * 이메일: 참가자의 이메일 주소입니다.유효한 작업: join, multiJoin, start {#NUtil-doConferenceAction_S_O__ul_qzh_pqt_rhb} |
| 데이터.메시지 | 문자열 | 사용자가 통화에 응답할 때 소리내어 읽히는 메시지입니다(예: "P1 인시던트가 생성되었습니다. 인스턴스에 로그인하십시오." 이 매개변수가 유효한 작업: * 가입 * 다중 조인 * 시작 {#NUtil-doConferenceAction_S_O__ul_jnl_ntx_vhb} |
| data.serviceProvider | 문자열 | 필수 Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다. 이 매개변수가 필요한 작업: * 모두 {#NUtil-doConferenceAction_S_O__ul_vwb_psx_vhb} |
| data.sysId | 문자열 | 전화 회의와 연결할 소스 기록의 Sys_id입니다. 예를 들어, 특정 인시던트나 문제를 논의하기 위해 전화 회의를 열면 인시던트나 문제 기록의 sys_id을 이 값에 입력합니다. 이 sys_id는 NotifyConference Call\[notify_conference_call\] 테이블의 소스 열에 저장되며 나중에 추적할 수 있습니다. {#NUtil-doConferenceAction_S_O__data.sys_id-p2-NConf} 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.Table함께 사용됩니다.{#NUtil-doConferenceAction_S_O__data.sys_id-p3-NConf} 이 매개변수가 유효한 작업: * 시작 {#NUtil-doConferenceAction_S_O__ul_h3l_qsx_vhb} |
| 데이터.테이블 | 문자열 | 전화 회의에 연결할 소스 기록이 포함된 테이블입니다. 소스 기록은 전화 회의에서 논의 주제인 "인시던트" 또는 "문제"와 같은 모든 기록일 수 있습니다. 이 테이블 이름은 NotifyConference Call \[notify_conference_call\] 테이블의 테이블 열에 저장되며 추적할 수 있습니다.{#NUtil-doConferenceAction_S_O__data.table-p2-NConf} 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.sysId함께 사용됩니다.{#NUtil-doConferenceAction_S_O__data.table-p3-NConf} 이 매개변수가 유효한 작업: * 시작 {#NUtil-doConferenceAction_S_O__ul_mj1_4sx_vhb} |
[표 6. 매개변수]

{#NUtil-doConferenceAction_S_O__table_qqs_vdv_nhb} {#NUtil-doConferenceAction_S_O__table_rqs_vdv_nhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 회의 작업의 결과입니다. `<action>.status`: 회의 작업의 상태입니다. * 데이터 유형: 부울 * 가능한 값: * true: 회의 작업 성공 * false: 회의 작업 실패 {#NUtil-doConferenceAction_S_O__ul_w5y_hyt_b3b} {#NUtil-doConferenceAction_S_O__ul_psg_gyt_b3b} `<action>.successMessages`: <var class="keyword varname">상태</var> 가 예일 경우 성공 메시지가 표시되고, 그렇지 않으면 비어 있습니다. * 데이터 유형: 문자열 배열 {#NUtil-doConferenceAction_S_O__ul_qm2_myt_b3b} `<action>.warnMessages`: <var class="keyword varname">상태</var> 가 아니오인 경우 처리 중에 발생한 경고 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-doConferenceAction_S_O__ul_xbz_nyt_b3b} `<action>.errorMessages`: <var class="keyword varname">상태</var> 가 false인 경우 처리 중에 발생하는 오류 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-doConferenceAction_S_O__ul_tht_4yt_b3b} |
[표 7. 반환]

{#NUtil-doConferenceAction_S_O__table_rqs_vdv_nhb}  

    (function (confId) {
    	var confUtils = new NotifyConferenceUtils();
    	var data = confUtils.getConferenceInputDataTemplate();
    	data.table = 'incident';
    	data.sysId = '1234';
    	data.addToWorkNotes = false;
    	data.confId = confId;
    	data.message = 'p1 incident has been created';
    	data.fromNumber = 'twilio/Telephony driver number';
    	data.items.push({ id: 'user3SysId', phoneNumber: '+917799555332' });
    	data.items.push({ id: 'user4SysId', email: 'yln99518@gmail.com' });

    	var result = confUtils.doConferenceAction('start', data);
    	if (result.status) {
    		gs.info('Start conference action succeeded');
    	} else
    		gs.info('Start conference action failed');

    	result.errorMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.warnMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.successMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    })('activeConfSysId');

## NotifyConferenceUtils - getConferenceInputDataTemplate() {#ariaid-title6}

doConferenceAction() 메서드와 함께 사용할 JSON 데이터 템플릿을 반환합니다. 이 템플릿을 사용하면 데이터 객체가 자동으로 구조화되므로 수동으로 생성할 필요가 없습니다.
doConferenceAction() 메서드를 호출하기 전에 이 메서드를 호출합니다. 원하는 전화 회의 작업에 대해 템플릿 내에서 원하는 매개변수를 설정한 다음 doConferenceAction() 호출에서 템플릿을 전달합니다. 각 작업의 유효한 매개변수에 대한 자세한 내용은 [doConferenceAction()](https://servicenow-prod.fluidtopics.net/qHg7bmBSD6yFGbgsNWnvKQ#NotifyConferenceUtils "NotifyConferenceUtil API에는 다양한 Webex전화 통신 서비스 공급자(Zoom예: )에 대한 알림 컨퍼런스 회의 및 SMS 메시지를 관리하는 메서드가 있습니다.")을 참조하십시오.  
주:  
도우미 메서드입니다. 이 객체를 수동으로 생성하고 해당 객체를 doConferenceAction() 메서드에 전달하면 동일한 결과를 얻을 수도 있습니다.
{#NUtil-getConferenceInputDataTemplate__table_azh_qyg_nhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 8. 매개변수]

{#NUtil-getConferenceInputDataTemplate__table_azh_qyg_nhb} {#NUtil-getConferenceInputDataTemplate__table_c2h_cwd_vhb__entry__2}{#NUtil-getConferenceInputDataTemplate__data.addToWorkNotes-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.allowMulticonference-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.confId-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.fromNumber-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.isNewConference-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.items-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.message-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.serviceProvider-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.sys_id-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.table-p-NConf}

| 유형 | 설명 |
|-|-|
| 데이터 | 전화 회의를 설명하는 객체입니다. |
| data.addToWorkNotes | 전화 회의에 포함된 참가자에 대한 정보를 연결된 기록의 작업 메모 필드에 추가할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 작업 메모를 추가할 기록을 식별합니다.{#NUtil-getConferenceInputDataTemplate__data.addToWorkNotes2-p-NConf} 기본값: false 이 매개변수가 유효한 작업: * 가입 * 다중 조인 * 자체 조인 * 시작 {#NUtil-getConferenceInputDataTemplate__ul_kwg_ktx_vhb} |
| data.allowMult컨퍼런스 | 특정 기록에 대해 한 번에 여러 컨퍼런스 회의를 허용할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 여러 컨퍼런스 회의를 가질 수 있는 기록을 식별합니다.{#NUtil-getConferenceInputDataTemplate__data.allowMulticonference2-p-NConf} 기본값: false 이 매개변수가 유효한 작업: * 시작 {#NUtil-getConferenceInputDataTemplate__ul_ay4_mtx_vhb} |
| data.confId | 컨퍼런스 회의의 Sys_id입니다. 테이블: 알림 컨퍼런스 회의 \[notify_conference_call\]{#NUtil-getConferenceInputDataTemplate__data.confId2-p-NConf} 이 매개변수가 필요한 작업: * 끝 * 가입 * 다중 조인 * 자체 조인 {#NUtil-getConferenceInputDataTemplate__ul_afs_qsx_vhb} 주: 음소거, 음소거 해제, 킥과 같은 참가자 작업은 메서드가 알림 컨퍼런스 회의 참가자 \[notify_participant\] 테이블에서 이 정보를 가져오므로 이 매개변수를 설정할 필요가 없습니다. |
| data.fromNumber | 전화 회의를 위해 호출할 서비스 제공자 번호입니다. 알림 전화 번호 \[notify_number\] 테이블의 번호 또는 전화 번호 열에서 이 값을 찾습니다.{#NUtil-getConferenceInputDataTemplate__data.fromNumber2-p-NConf} 이 매개변수가 필요한 작업: * 시작 {#NUtil-getConferenceInputDataTemplate__ul_exs_stx_vhb} |
| data.isNewConference | 이 전화 회의가 새 전화 회의인지 기존 전화 회의인지 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 새 컨퍼런스 회의 * false: 기존 컨퍼런스 회의 {#NUtil-getConferenceInputDataTemplate__ul_q1m_wbv_nhb} 기본값: false 이 매개변수가 유효한 작업: * 시작 {#NUtil-getConferenceInputDataTemplate__ul_d1d_stx_vhb} |
| 데이터.항목 | 전화 회의에 포함할 각 참가자에 대한 정보입니다. 유효한 배열 값: * ID: 사용자의 Sys_id입니다. 사용자 \[sys_User\] 테이블에 있습니다.유효한 작업: join, multiJoin, start * notifyParticipantId: 알림 참가자의 시스템 ID입니다. 알림 참가자 \[notify_participant\] 테이블에 있습니다.유효한 작업: join, kick, multiJoin, 음소거, 시작, 음소거 해제 * phoneNumber: 참가자의 전화 번호입니다. 이 값이 OR notifyParticipantId과 id 함께 전달되는 경우 이 값은 사용자/참가자 기록의 전화 번호를 대체하고 전화를 걸 때 사용됩니다. 유효한 작업: join, multiJoin, start * 이메일: 참가자의 이메일 주소입니다.유효한 작업: join, multiJoin, start {#NUtil-getConferenceInputDataTemplate__ul_qzh_pqt_rhb} |
| 데이터.메시지 | 사용자가 통화에 응답할 때 소리내어 읽히는 메시지입니다(예: "P1 인시던트가 생성되었습니다. 인스턴스에 로그인하십시오." 이 매개변수가 유효한 작업: * 가입 * 다중 조인 * 시작 {#NUtil-getConferenceInputDataTemplate__ul_jnl_ntx_vhb} |
| data.serviceProvider | 필수 Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다. 이 매개변수가 필요한 작업: * 모두 {#NUtil-getConferenceInputDataTemplate__ul_vwb_psx_vhb} |
| data.sysId | 전화 회의와 연결할 소스 기록의 Sys_id입니다. 예를 들어, 특정 인시던트나 문제를 논의하기 위해 전화 회의를 열면 인시던트나 문제 기록의 sys_id을 이 값에 입력합니다. 이 sys_id는 NotifyConference Call\[notify_conference_call\] 테이블의 소스 열에 저장되며 나중에 추적할 수 있습니다. {#NUtil-getConferenceInputDataTemplate__data.sys_id-p2-NConf} 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.Table함께 사용됩니다.{#NUtil-getConferenceInputDataTemplate__data.sys_id-p3-NConf} 이 매개변수가 유효한 작업: * 시작 {#NUtil-getConferenceInputDataTemplate__ul_h3l_qsx_vhb} |
| 데이터.테이블 | 전화 회의에 연결할 소스 기록이 포함된 테이블입니다. 소스 기록은 전화 회의에서 논의 주제인 "인시던트" 또는 "문제"와 같은 모든 기록일 수 있습니다. 이 테이블 이름은 NotifyConference Call \[notify_conference_call\] 테이블의 테이블 열에 저장되며 추적할 수 있습니다.{#NUtil-getConferenceInputDataTemplate__data.table-p2-NConf} 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.sysId함께 사용됩니다.{#NUtil-getConferenceInputDataTemplate__data.table-p3-NConf} 이 매개변수가 유효한 작업: * 시작 {#NUtil-getConferenceInputDataTemplate__ul_mj1_4sx_vhb} |
[표 9. 반환]

{#NUtil-getConferenceInputDataTemplate__table_c2h_cwd_vhb}  

    (function (confId) {
    	var confUtils = new NotifyConferenceUtils();
    	var data = confUtils.getConferenceInputDataTemplate();
    	data.confId = confId;
    	var result = confUtils.doConferenceAction('end', data);
    	if (result.status) {
    		gs.info('Conference call has been ended');
    	} else
    		gs.info('End conference call action failed');

    	result.errorMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.warnMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.successMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    })('activeConfSysId');

## NotifyConferenceUtils - getServiceProvidersCapabilities() {#ariaid-title7}

인스턴스에 있는 모든 전화 통신 서비스 제공자 드라이버의 기능을 반환합니다.
가능한 기능은 다음과 같습니다.

* 보관: 회의가 종료된 후 보관합니다.
* beepOnLeave: 참가자가 전화 회의에서 나가면 "삐" 신호음을 재생합니다.
* beepOnJoin: 참가자가 전화 회의에 참가하면 "삐" 음이 재생됩니다.
* 종료: 식별된 컨퍼런스 회의를 종료합니다.
* 파일 공유: 참가자 간 파일 공유 허용
* 참가: 전화 회의에 참가자를 추가합니다.
* 킥: 전화 회의에서 참가자를 제거합니다.
* multiJoin: 전화 회의에 여러 참가자 추가
* multiKick: 전화 회의에서 여러 참가자를 제거합니다.
* muteOnJoin: 참가자가 처음 전화 회의에 참가할 때 참가자를 음소거합니다.
* multiUnmute: 전화 회의에서 여러 참가자를 음소거 해제합니다.
* 기록: 컨퍼런스 회의 기록
* 기록: 전화 회의가 기록될 때 화면에 표시기를 제공합니다.
* screenSharing: 참가자 화면을 그룹과 공유할 수 있습니다.
* selfJoin: 현재 로그인한 사용자를 전화 회의에 추가합니다.
* 말하기: 현재 말하는 사람에 대한 화면 메시지를 제공합니다.
* 시작: 식별된 전화 회의를 시작합니다.
* 음소거 해제: 전화 회의 참가자의 음소거를 해제합니다.
{#NUtil-getServiceProvidersCapabilities__ul_pq5_qfv_nhb}
{#NUtil-getServiceProvidersCapabilities__table_azh_qyg_nhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 10. 매개변수]

{#NUtil-getServiceProvidersCapabilities__table_azh_qyg_nhb} {#NUtil-getServiceProvidersCapabilities__table_bzh_qyg_nhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 각 드라이버 역량 상태의 키-값 쌍입니다. 유효한 값은 다음과 같습니다. * isSupported = 0: 역량이 지원되지 않습니다. * isSupported = 1: 역량이 지원됩니다. {#NUtil-getServiceProvidersCapabilities__ul_jbq_mdt_rhb} |
[표 11. 반환]

{#NUtil-getServiceProvidersCapabilities__table_bzh_qyg_nhb}  
인스턴스의 모든 전화 통신 서비스 제공자 드라이버에 대한 드라이버 기능을 나열합니다.

    (function () {
    	var confUtils = new NotifyConferenceUtils();
    	var providerToCapability = confUtils.getServiceProvidersCapabilites();
    	for (var provider in providerToCapability) {
    		gs.info('{0} supported capabilities \n\n', provider);
    		var capabilities = providerToCapability[provider]
    		for (var cap in capabilities)
    			if(confUtils.isActionSupported(capabilities[cap].isSupported))
    				gs.info('"{0}" action supported', cap);
    			else
    				gs.info("'{0}' action is not supported by this conference driver", cap);
    	}
    })();

출력: 메서드는 인스턴스 내의 각 활성 전화 통신 서비스 공급자에 대해 다음과 유사한 노드를 반환합니다.

    {
        "Telephony": {
            "start": {
                "isSupported": 1,
                "meta": {}
            },
            "end": {
                "isSupported": 1,
                "meta": {}
            },
            "selfJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "join": {
                "isSupported": 1,
                "meta": {}
            },
            "multiJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "mute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiMute": {
                "isSupported": 1,
                "meta": {}
            },
            "unmute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiUnmute": {
                "isSupported": 1,
                "meta": {}
            },
            "kick": {
                "isSupported": 1,
                "meta": {}
            },
            "multiKick": {
                "isSupported": 1,
                "meta": {}
            },
            "record": {
                "isSupported": 0,
                "meta": {}
            },
            "speaking": {
                "isSupported": 0,
                "meta": {}
            },
            "recording": {
                "isSupported": 0,
                "meta": {}
            },
            "screenSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "fileSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "archive": {
                "isSupported": 0,
                "meta": {}
            },
            "muteOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnLeave": {
                "isSupported": 0,
                "meta": {}
            }
        }
    }

## NotifyConferenceUtils - isActionSupported(숫자 작업) {#ariaid-title8}

전화 통신 서비스 제공자가 알림 회의 작업을 지원하는지 여부를 결정합니다.
이 메서드를 사용하려면 먼저 getServiceProviderCapabilities() 메서드를 호출해야 합니다. 이 메서드는 인스턴스에 구성된 각 서비스 제공자에 대해 가능한 각 알림 회의 작업의 가용성에 대한 정보가 포함된 객체를 반환합니다.

예:  

    {
        "Telephony": {
            "start": {
                "isSupported": 1,
                "meta": {}
            },
            "end": {
                "isSupported": 1,
                "meta": {}
            },
            "selfJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "join": {
                "isSupported": 1,
                "meta": {}
            },
            "multiJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "mute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiMute": {
                "isSupported": 1,
                "meta": {}
            },
            "unmute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiUnmute": {
                "isSupported": 1,
                "meta": {}
            },
            "kick": {
                "isSupported": 1,
                "meta": {}
            },
            "multiKick": {
                "isSupported": 1,
                "meta": {}
            },
            "record": {
                "isSupported": 0,
                "meta": {}
            },
            "speaking": {
                "isSupported": 0,
                "meta": {}
            },
            "recording": {
                "isSupported": 0,
                "meta": {}
            },
            "screenSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "fileSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "archive": {
                "isSupported": 0,
                "meta": {}
            },
            "muteOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnLeave": {
                "isSupported": 0,
                "meta": {}
            }
        }
    }

{#NUtil-isActionSupported_N__table_gsw_vd2_vhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 작업 | 번호 | 특정 작업 및 서비스 제공자에 대해 getServiceProvidersCapabilities() 메서드에서 반환하는 매개변수의 값 isSupported 입니다. 주: 값이 부울처럼 보일 수 있지만 isSupported 실제로는 숫자입니다. 역량을 부울 값으로 평가하려고 시도하지 마십시오. 연결된 값이 향후 버전에서 확장될 수 있으므로 이 방법을 사용합니다. |
[표 12. 매개변수]

{#NUtil-isActionSupported_N__table_gsw_vd2_vhb} {#NUtil-isActionSupported_N__table_hsw_vd2_vhb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 전화 통신 서비스 제공자가 지정된 작업을 지원하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 서비스 제공자가 작업을 지원합니다. * false: 서비스 제공자가 작업을 지원하지 않습니다. {#NUtil-isActionSupported_N__ul_pkt_mf2_vhb} |
[표 13. 반환]

{#NUtil-isActionSupported_N__table_hsw_vd2_vhb}  

    (function () {
      var confUtils = new NotifyConferenceUtils();
      var providerToCapability = confUtils.getServiceProvidersCapabilites();
        for (var provider in providerToCapability) {
          gs.info('{0} supported capabilities \n\n', provider);
          var capabilities = providerToCapability[provider]
          for (var cap in capabilities)
            if (confUtils.isActionSupported(capabilities[cap].isSupported))
              gs.info('"{0}" action supported', cap);
            else
              gs.info("'{0}' action is not supported by this conference driver", cap);
        }
    })();

## NotifyConferenceUtils - kickByParticipantGR(GlideRecord notifyParticipantGR) {#ariaid-title9}

현재 컨퍼런스 회의에서 전달된 GlideRecord와 관련된 참가자를 제거합니다.
{#NUtil-kickByParticipantGR_GR__table_inj_thh_nhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림ParticipantGR | GlideRecord | 전화 회의에서 제거할 참가자의 GlideRecord 객체입니다. 테이블: 알림 참가자 \[notify_participant\] |
[표 14. 매개변수]

{#NUtil-kickByParticipantGR_GR__table_inj_thh_nhb} {#NUtil-kickByParticipantGR_GR__table_jnj_thh_nhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 회의 작업의 결과입니다. `<action>.status`: 회의 작업의 상태입니다. * 데이터 유형: 부울 * 가능한 값: * true: 회의 작업 성공 * false: 회의 작업 실패 {#NUtil-kickByParticipantGR_GR__ul_w5y_hyt_b3b} {#NUtil-kickByParticipantGR_GR__ul_psg_gyt_b3b} `<action>.successMessages`: <var class="keyword varname">상태</var> 가 예일 경우 성공 메시지가 표시되고, 그렇지 않으면 비어 있습니다. * 데이터 유형: 문자열 배열 {#NUtil-kickByParticipantGR_GR__ul_qm2_myt_b3b} `<action>.warnMessages`: <var class="keyword varname">상태</var> 가 아니오인 경우 처리 중에 발생한 경고 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-kickByParticipantGR_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`: <var class="keyword varname">상태</var> 가 false인 경우 처리 중에 발생하는 오류 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-kickByParticipantGR_GR__ul_tht_4yt_b3b} |
[표 15. 반환]

{#NUtil-kickByParticipantGR_GR__table_jnj_thh_nhb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    (function () {
        var confUtils = new NotifyConferenceUtils();
        var participantGR = new GlideRecord('notify_participant');  // Participant record contains conf call ID
        participantGR.get('validParticipantSysId');
        var actionResult = confUtils.kickByParticipantGR(participantGR);
        if (actionResult.status)
            gs.info('Participant has been kicked out of conference');
        else {
            gs.info('kick operation failed');
            actionResult.warnMessages.forEach(function (msg) {
                gs.info(msg);
            });
            actionResult.errorMessages.forEach(function (msg) {
                gs.info(msg);
            })
        }
    })()

## NotifyConferenceUtils - muteByParticipantGR(GlideRecord notifyParticipantGR) {#ariaid-title10}

현재 컨퍼런스 회의에서 전달된 GlideRecord와 관련된 참가자를 음소거합니다.
{#NUtil-muteByParticipantGR_GR__table_vpk_ckh_nhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림ParticipantGR | 객체 | 음소거할 참가자의 GlideRecord 객체입니다. 테이블: 알림 참가자 \[notify_participant\] |
[표 16. 매개변수]

{#NUtil-muteByParticipantGR_GR__table_vpk_ckh_nhb} {#NUtil-muteByParticipantGR_GR__table_wpk_ckh_nhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 회의 작업의 결과입니다. `<action>.status`: 회의 작업의 상태입니다. * 데이터 유형: 부울 * 가능한 값: * true: 회의 작업 성공 * false: 회의 작업 실패 {#NUtil-muteByParticipantGR_GR__ul_w5y_hyt_b3b} {#NUtil-muteByParticipantGR_GR__ul_psg_gyt_b3b} `<action>.successMessages`: <var class="keyword varname">상태</var> 가 예일 경우 성공 메시지가 표시되고, 그렇지 않으면 비어 있습니다. * 데이터 유형: 문자열 배열 {#NUtil-muteByParticipantGR_GR__ul_qm2_myt_b3b} `<action>.warnMessages`: <var class="keyword varname">상태</var> 가 아니오인 경우 처리 중에 발생한 경고 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-muteByParticipantGR_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`: <var class="keyword varname">상태</var> 가 false인 경우 처리 중에 발생하는 오류 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-muteByParticipantGR_GR__ul_tht_4yt_b3b} |
[표 17. 반환]

{#NUtil-muteByParticipantGR_GR__table_wpk_ckh_nhb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    (function () {
        var confUtils = new NotifyConferenceUtils();
        var participantGR = new GlideRecord('notify_participant');
        participantGR.get('validSysId');
        var actionResult = confUtils.muteByParticipantGR(participantGR);
        if (actionResult.status)
            gs.info('Participant has been muted');
        else {
            gs.info('mute operation failed');
            actionResult.warnMessages.forEach(function (msg) {
                gs.info(msg);
            });
            actionResult.errorMessages.forEach(function (msg) {
                gs.info(msg);
            })
        }
    })()

## NotifyConferenceUtils - unmuteByParticipantGR(GlideRecord notifyParticipantGR) {#ariaid-title11}

현재 컨퍼런스 회의에서 전달된 GlideRecord와 관련된 참가자를 음소거합니다.
{#NUtil-unmuteByParticipantGR_GR__table_byp_zqh_nhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림ParticipantGR | GlideRecord | 음소거를 해제할 참가자의 GlideRecord 객체입니다. 이러한 기록은 참가자에게 알림\[notify_participant\] 테이블에 있습니다. |
[표 18. 매개변수]

{#NUtil-unmuteByParticipantGR_GR__table_byp_zqh_nhb} {#NUtil-unmuteByParticipantGR_GR__table_cyp_zqh_nhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 회의 작업의 결과입니다. `<action>.status`: 회의 작업의 상태입니다. * 데이터 유형: 부울 * 가능한 값: * true: 회의 작업 성공 * false: 회의 작업 실패 {#NUtil-unmuteByParticipantGR_GR__ul_w5y_hyt_b3b} {#NUtil-unmuteByParticipantGR_GR__ul_psg_gyt_b3b} `<action>.successMessages`: <var class="keyword varname">상태</var> 가 예일 경우 성공 메시지가 표시되고, 그렇지 않으면 비어 있습니다. * 데이터 유형: 문자열 배열 {#NUtil-unmuteByParticipantGR_GR__ul_qm2_myt_b3b} `<action>.warnMessages`: <var class="keyword varname">상태</var> 가 아니오인 경우 처리 중에 발생한 경고 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-unmuteByParticipantGR_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`: <var class="keyword varname">상태</var> 가 false인 경우 처리 중에 발생하는 오류 메시지입니다. * 데이터 유형: 문자열 배열 {#NUtil-unmuteByParticipantGR_GR__ul_tht_4yt_b3b} |
[표 19. 반환]

{#NUtil-unmuteByParticipantGR_GR__table_cyp_zqh_nhb}  

    (function () {
        var confUtils = new NotifyConferenceUtils();
        var participantGR = new GlideRecord('notify_participant');
        participantGR.get('validSysId');
        var actionResult = confUtils.unmuteByParticipantGR(participantGR);
        if (actionResult.status)
            gs.info('Participant has been Unmuted');
        else {
            gs.info('Unmute operation failed');
            actionResult.warnMessages.forEach(function (msg) {
                gs.info(msg);
            });
            actionResult.errorMessages.forEach(function (msg) {
                gs.info(msg);
            })
        }
    })();