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


---

# NotifyOnTaskClient - 클라이언트

# NotifyOnTaskClient - 클라이언트 {#ariaid-title1}

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

NotifyOnTaskClient API는 와 Webex같은 Zoom 다양한 전화 통신 서비스 공급자에 대해 SMS 메시지를 보내거나 전화 회의를 시작/관리하는 메서드를 제공합니다.

모든 UI는 NotifyOnTaskClient UI 스크립트를 명시적으로 포함하여 NotifyOnTaskClient API를 사용할 수 있습니다.

NotifyOnTaskClient API를 사용하여 다음을 수행할 수 있습니다.  
* 전화 회의 시작
* 전화 회의 종료
* 참가자 추가
* 다음과 같이 전화 통신 드라이버를 통해 사용할 수 있는 작업을 수행합니다.
  * 참가자 음소거/음소거 해제
  * 전화 회의에서 참가자 제거
  * 전화 회의에 참가자 추가
  * 전화 회의 시작
  * 전화 회의 종료
  {#NotifyOnTaskClient__ul_e5f_pqy_4hb}
{#NotifyOnTaskClient__ul_qvb_kqy_4hb}

알림(com.snc.notify) 플러그인을 사용하려면 별도의 구독이 필요합니다. 알림 플러그인 활성화에 대한 자세한 내용은 [알림 활성화를](https://www.servicenow.com/docs/access?context=t_ActivateNotify&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하십시오.

## NotifyOnTaskClient - addParticipants(객체 데이터) {#ariaid-title2}

지정된 참가자를 지정된 전화 회의에 추가합니다.
{#NClient-addParticipants_O__dataObject-table-NConf__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 데이터 | 객체 | 전화 회의를 설명하는 객체입니다. |
| data.addToWorkNotes | 부울 | 전화 회의에 포함된 참가자에 대한 정보를 연결된 기록의 작업 메모 필드에 추가할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 작업 메모를 추가할 기록을 식별합니다. 기본값: false |
| data.confId | 문자열 | 컨퍼런스 회의의 Sys_id입니다. 테이블: 알림 컨퍼런스 회의 \[notify_conference_call\] |
| 데이터.항목 | 배열 | 전화 회의에 포함할 각 참가자에 대한 정보입니다. "items": [ "email": "String", "id": "String", "notifyParticipantId": "String", "phoneNumber": "String" ] |
| data.items.email | 문자열 | 참가자의 이메일 주소입니다. |
| data.items.id | 문자열 | 사용자 sys_id. 테이블: 사용자 \[sys_User\] |
| data.items.notifyParticipantId | 문자열 | 참가자 sys_id 테이블: 알림 참가자 \[notify_participant\] |
| 데이터.항목.전화 번호 | 문자열 | 참가자의 전화번호입니다. 이 값이 OR notifyParticipantId 매개변수와 id 함께 전달되는 경우 이 값은 사용자/참가자 기록의 전화 번호를 대체하고 전화를 걸 때 사용됩니다. |
| 데이터.메시지 | 문자열 | 사용자가 통화에 응답할 때 소리내어 읽히는 메시지입니다(예: "P1 인시던트가 생성되었습니다. 인스턴스에 로그인하십시오." |
| data.serviceProvider | 문자열 | 필수 Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다. |
| data.sysId | 문자열 | 전화 회의와 연결할 소스 기록의 Sys_id입니다. 예를 들어, 특정 인시던트나 문제를 논의하기 위해 전화 회의를 열면 인시던트나 문제 기록의 sys_id을 이 값에 입력합니다. 이 sys_id는 NotifyConference Call\[notify_conference_call\] 테이블의 소스 열에 저장되며 나중에 추적할 수 있습니다. 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.Table함께 사용됩니다. "시작" 작업을 통해 전화 회의를 처음 만들 때 이 값을 구성해야 합니다. 필요한 경우 이 방법을 통해 이 값을 설정할 수도 있습니다. |
| 데이터.테이블 | 문자열 | 전화 회의에 연결할 소스 기록이 포함된 테이블입니다. 소스 기록은 전화 회의에서 논의 주제인 "인시던트" 또는 "문제"와 같은 모든 기록일 수 있습니다. 이 테이블 이름은 NotifyConference Call \[notify_conference_call\] 테이블의 테이블 열에 저장되며 추적할 수 있습니다. 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.sysId함께 사용됩니다. "시작" 작업을 통해 전화 회의를 처음 만들 때 이 값을 구성해야 합니다. 필요한 경우 이 방법을 통해 이 값을 설정할 수도 있습니다. |
[표 1. 매개변수]

{#NClient-addParticipants_O__dataObject-table-NConf} {#NClient-addParticipants_O__table_rpj_1y5_nhb__entry__2}

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

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

    function addToConferenceCall() {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';
        data.items.push({ id: 'userSysId' });
        data.items.push({ phoneNumber: '+917799555331' });
        data.items.push({ email: 'yln99518@gmail.com' });

        NotifyOnTaskClient.addParticipants(data).then(function (result) {
            var joinActionResult = result[0];
            if(joinActionResult.status) {
                joinActionResult.successMessages.forEach(function(msg) {
                    console.log(msg);
                });
                return;
            }

            joinActionResult.warnMessages.forEach(function(msg) {
                console.warn(msg);
            });
            joinActionResult.errorMessages.forEach(function(msg) {
                console.error(msg);
            });
        }, function (errMsg) {
            console.log(errMsg);
        });
    }

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

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

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

{#NClient-doConferenceAction_S_O__table_qqs_vdv_nhb} {#NClient-doConferenceAction_S_O__table_rqs_vdv_nhb__entry__2}

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

{#NClient-doConferenceAction_S_O__table_rqs_vdv_nhb}  
다음 예제는 doConferenceAction()을 호출하는 함수를 만들어 작업과 참가자를 전달하여 전화 회의 참가자를 조작하는 방법을 보여줍니다.


    /**
     * 
     * @param {string} action - action to perform on the conference object or participant object
     * @param {Array} participants;
     */
    function doConferenceAction(action, participants) {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';
        data.items = participants;

        NotifyOnTaskClient.doConferenceAction(action, data).then(function (result) {
            var kickActionResult = result[0];
            if (kickActionResult.status)
                console.log(action + ' succeeded');
            else {
                kickActionResult.warnMessages.forEach(function (msg) {
                    console.warn(msg);
                });
                kickActionResult.errorMessages.forEach(function (msg) {
                    console.error(msg);
                });
            }
        }, function (errMsg) {
                console.log(errMsg)
        });
    }

    // kick participants

    doConferenceAction('kick', [{notifyParticipantId: 'notifyParticipantSysId'}]);

    // kick multiple participants

    doConferenceAction('multiKick',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);

    // Mute participants
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);

    doConferenceAction('multiMute',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);

    // self join to any confernece. 
    doConferenceAction('selfJoin', [{id: 'logged in userId'}]);

## NotifyOnTaskClient - endConference(객체 데이터) {#ariaid-title4}

지정된 전화 회의를 종료합니다.
{#NClient-endConference_O__entry__3}{#NClient-endConference_O__data-row-NConf}{#NClient-endConference_O__data.confId-row-NConf}

| 이름 | 유형 | 설명 |
|-|-|-|
| 데이터 | 객체 | 전화 회의를 설명하는 객체입니다. |
| data.confId | 문자열 | 컨퍼런스 회의의 Sys_id입니다. |
| data.serviceProvider | 문자열 | 필수 Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다. |
[표 5. 매개변수]

{#NClient-endConference_O__table_dqd_qcv_nhb__entry__2}

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

{#NClient-endConference_O__table_dqd_qcv_nhb}  

    function endConferenceCall() {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';

        NotifyOnTaskClient.endConference(data).then(function (result) {
            var endActionResult = result[0];
            if (endActionResult.status)
                console.log('Conference has been ended');
            else {
                endActionResult.warnMessages.forEach(function (msg) {
                    console.warn(msg);
                });
                endActionResult.errorMessages.forEach(function (msg) {
                    console.error(msg);
                });
            }
        }, function (errMsg) {
            console.log(errMsg);
        });
    }

## 알림OnTaskClient - getNotifyActionTemplate() {#ariaid-title5}

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

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

{#NClient-getNotifyActionTemplate__table_azh_qyg_nhb} {#NClient-getNotifyActionTemplate__table_c2h_cwd_vhb__entry__2}{#NClient-getNotifyActionTemplate__data.addToWorkNotes-p-NConf}{#NClient-getNotifyActionTemplate__data.allowMulticonference-p-NConf}{#NClient-getNotifyActionTemplate__data.confId-p-NConf}{#NClient-getNotifyActionTemplate__data.fromNumber-p-NConf}{#NClient-getNotifyActionTemplate__data.isNewConference-p-NConf}{#NClient-getNotifyActionTemplate__data.items-p-NConf}{#NClient-getNotifyActionTemplate__data.message-p-NConf}{#NClient-getNotifyActionTemplate__data.serviceProvider-p-NConf}{#NClient-getNotifyActionTemplate__data.sys_id-p-NConf}{#NClient-getNotifyActionTemplate__data.table-p-NConf}

| 유형 | 설명 |
|-|-|
| 데이터 | 전화 회의를 설명하는 객체입니다. |
| data.addToWorkNotes | 전화 회의에 포함된 참가자에 대한 정보를 연결된 기록의 작업 메모 필드에 추가할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 작업 메모를 추가할 기록을 식별합니다.{#NClient-getNotifyActionTemplate__data.addToWorkNotes2-p-NConf} 기본값: false 이 매개변수가 유효한 작업: * 가입 * 다중 조인 * 자체 조인 * 시작 {#NClient-getNotifyActionTemplate__ul_kwg_ktx_vhb} |
| data.allowMult컨퍼런스 | 특정 기록에 대해 한 번에 여러 컨퍼런스 회의를 허용할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 여러 컨퍼런스 회의를 가질 수 있는 기록을 식별합니다.{#NClient-getNotifyActionTemplate__data.allowMulticonference2-p-NConf} 기본값: false 이 매개변수가 유효한 작업: * 시작 {#NClient-getNotifyActionTemplate__ul_ay4_mtx_vhb} |
| data.confId | 컨퍼런스 회의의 Sys_id입니다. 테이블: 알림 컨퍼런스 회의 \[notify_conference_call\]{#NClient-getNotifyActionTemplate__data.confId2-p-NConf} 이 매개변수가 필요한 작업: * 끝 * 가입 * 다중 조인 * 자체 조인 {#NClient-getNotifyActionTemplate__ul_afs_qsx_vhb} 주: 음소거, 음소거 해제, 킥과 같은 참가자 작업은 메서드가 알림 컨퍼런스 회의 참가자 \[notify_participant\] 테이블에서 이 정보를 가져오므로 이 매개변수를 설정할 필요가 없습니다. |
| data.fromNumber | 전화 회의를 위해 호출할 서비스 제공자 번호입니다. 알림 전화 번호 \[notify_number\] 테이블의 번호 또는 전화 번호 열에서 이 값을 찾습니다.{#NClient-getNotifyActionTemplate__data.fromNumber2-p-NConf} 이 매개변수가 필요한 작업: * 시작 {#NClient-getNotifyActionTemplate__ul_exs_stx_vhb} |
| data.isNewConference | 이 전화 회의가 새 전화 회의인지 기존 전화 회의인지 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 새 컨퍼런스 회의 * false: 기존 컨퍼런스 회의 {#NClient-getNotifyActionTemplate__ul_q1m_wbv_nhb} 기본값: false 이 매개변수가 유효한 작업: * 시작 {#NClient-getNotifyActionTemplate__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 {#NClient-getNotifyActionTemplate__ul_qzh_pqt_rhb} |
| 데이터.메시지 | 사용자가 통화에 응답할 때 소리내어 읽히는 메시지입니다(예: "P1 인시던트가 생성되었습니다. 인스턴스에 로그인하십시오." 이 매개변수가 유효한 작업: * 가입 * 다중 조인 * 시작 {#NClient-getNotifyActionTemplate__ul_jnl_ntx_vhb} |
| data.serviceProvider | 필수 Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다. 이 매개변수가 필요한 작업: * 모두 {#NClient-getNotifyActionTemplate__ul_vwb_psx_vhb} |
| data.sysId | 전화 회의와 연결할 소스 기록의 Sys_id입니다. 예를 들어, 특정 인시던트나 문제를 논의하기 위해 전화 회의를 열면 인시던트나 문제 기록의 sys_id을 이 값에 입력합니다. 이 sys_id는 NotifyConference Call\[notify_conference_call\] 테이블의 소스 열에 저장되며 나중에 추적할 수 있습니다. {#NClient-getNotifyActionTemplate__data.sys_id-p2-NConf} 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.Table함께 사용됩니다.{#NClient-getNotifyActionTemplate__data.sys_id-p3-NConf} 이 매개변수가 유효한 작업: * 시작 {#NClient-getNotifyActionTemplate__ul_h3l_qsx_vhb} |
| 데이터.테이블 | 전화 회의에 연결할 소스 기록이 포함된 테이블입니다. 소스 기록은 전화 회의에서 논의 주제인 "인시던트" 또는 "문제"와 같은 모든 기록일 수 있습니다. 이 테이블 이름은 NotifyConference Call \[notify_conference_call\] 테이블의 테이블 열에 저장되며 추적할 수 있습니다.{#NClient-getNotifyActionTemplate__data.table-p2-NConf} 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.sysId함께 사용됩니다.{#NClient-getNotifyActionTemplate__data.table-p3-NConf} 이 매개변수가 유효한 작업: * 시작 {#NClient-getNotifyActionTemplate__ul_mj1_4sx_vhb} |
[표 8. 반환]

{#NClient-getNotifyActionTemplate__table_c2h_cwd_vhb}  
다음 예제는 getNotifyActionTemplate()을 호출하여 doConferenceAction()에 대한 작업을 정의하는 데 필요한 데이터 템플릿을 가져오는 방법을 보여줍니다.


    /**
     * 
     * @param {string} action - action to perform on the conference object or participant object
     * @param {Array} participants;
     */
    function doConferenceAction(action, participants) {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';
        data.items = participants;

        NotifyOnTaskClient.doConferenceAction(action, data).then(function (result) {
            var kickActionResult = result[0];
            if (kickActionResult.status)
                console.log(action + ' succeeded');
            else {
                kickActionResult.warnMessages.forEach(function (msg) {
                    console.warn(msg);
                });
                kickActionResult.errorMessages.forEach(function (msg) {
                    console.error(msg);
                });
            }
        }, function (errMsg) {
                console.log(errMsg)
        });
    }

    // kick participants

    doConferenceAction('kick', [{notifyParticipantId: 'notifyParticipantSysId'}]);

    // kick multiple participants

    doConferenceAction('multiKick',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);

    // Mute participants
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);

    doConferenceAction('multiMute',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);

    // self join to any confernece. 
    doConferenceAction('selfJoin', [{id: 'logged in userId'}]);

## NotifyOnTaskClient - start(객체 데이터) {#ariaid-title6}

새 전화 회의를 시작합니다.
{#NClient-start_O__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 데이터 | 객체 | 전화 회의를 설명하는 객체입니다. |
| data.addToWorkNotes | 부울 | 옵션입니다.전화 회의에 포함된 참가자에 대한 정보를 연결된 기록의 작업 메모 필드에 추가할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 작업 메모를 추가할 기록을 식별하는 매개변수 값 data.tabledata.sysId 도 지정해야 합니다.{#NClient-start_O__data.addToWorkNotes2-p-NConf} 기본값: false |
| data.allowMulticonference | 부울 | 옵션입니다. 특정 기록에 대해 한 번에 여러 컨퍼런스 회의를 허용할지 여부를 나타내는 플래그입니다. 이 기능이 작동하려면 및 매개변수 data.sysId 에 data.table 값도 지정해야 합니다. 이러한 매개변수는 여러 컨퍼런스 회의를 가질 수 있는 기록을 식별합니다. 기본값: false |
| data.fromNumber | 문자열 | 필수 전화 회의를 위해 호출할 서비스 제공자 번호입니다. 알림 전화 번호 \[notify_number\] 테이블의 번호 또는 전화 번호 열에서 이 값을 찾습니다. |
| 데이터.항목 | 배열 | 옵션입니다. 전화 회의에 포함할 각 참가자에 대한 정보입니다. "items": [ "email": "String", "id": "String", "notifyParticipantId": "String", "phoneNumber": "String" ] |
| data.items.email | 문자열 | 참가자의 이메일 주소입니다. |
| data.items.id | 문자열 | 사용자 sys_id. 테이블: 사용자 \[sys_User\] |
| data.items.notifyParticipantId | 문자열 | 참가자 sys_id 테이블: 알림 참가자 \[notify_participant\] |
| 데이터.항목.전화 번호 | 문자열 | 참가자의 전화번호입니다. 이 값이 OR notifyParticipantId 매개변수와 id 함께 전달되는 경우 이 값은 사용자/참가자 기록의 전화 번호를 대체하고 전화를 걸 때 사용됩니다. |
| 데이터.메시지 | 문자열 | 옵션입니다. 사용자가 통화에 응답할 때 소리내어 읽히는 메시지입니다(예: "P1 인시던트가 생성되었습니다. 인스턴스에 로그인하십시오." |
| data.serviceProvider | 문자열 | 필수 Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다. |
| data.sysId | 문자열 | 옵션입니다. 전화 회의와 연결할 소스 기록의 Sys_id입니다. 예를 들어, 특정 인시던트나 문제를 논의하기 위해 전화 회의를 열면 인시던트나 문제 기록의 sys_id을 이 값에 입력합니다. 이 sys_id는 NotifyConference Call\[notify_conference_call\] 테이블의 소스 열에 저장되며 나중에 추적할 수 있습니다. 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.Table함께 사용됩니다. |
| 데이터.테이블 | 문자열 | 옵션입니다. 전화 회의에 연결할 소스 기록이 포함된 테이블입니다. 소스 기록은 전화 회의에서 논의 주제인 "인시던트" 또는 "문제"와 같은 모든 기록일 수 있습니다. 이 테이블 이름은 NotifyConference Call \[notify_conference_call\] 테이블의 테이블 열에 저장되며 추적할 수 있습니다. 이 매개변수는 , data.addToWorkNotes및 allowMulticonference 매개변수와 data.sysId함께 사용됩니다. |
[표 9. 매개변수]

{#NClient-start_O__table_jrr_133_nhb__entry__2}

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

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

    function startConferenceCall() {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.table = 'incident';
        data.sysId = '1234';
        data.serviceProvider = serviceProvider;
        data.addToWorkNotes = true;
        data.fromNumber = 'Telephony Number';
        data.items.push({ id: 'userSysId' });
        data.items.push({ phoneNumber: '+917799555332' });
        data.items.push({ email: 'yln99517@gmail.com' });

        NotifyOnTaskClient.start(data).then(function (result) {
            var startActionResult = result[0];
            if(startActionResult.status) {
                startActionResult.successMessages.forEach(function(msg) {
                    console.log(msg);
                });
                return;
            }

            startActionResult.warnMessages.forEach(function(msg) {
                console.warn(msg);
            });
            startActionResult.errorMessages.forEach(function(msg) {
                console.error(msg);
            });
        }, function (errMsg) {
            console.log(errMsg);
        });
    }