---
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) 소요 시간: 43분

NotifyAction API를 사용하면 전화 통신 공급자에게 보낼 작업을 정의할 수 있습니다.

각 작업 유형에 대해 해당 add 함수를 호출하여 NotifyAction 객체에 작업을 추가합니다. 각 add 함수는 addSay() 메서드에 대한 SayAction 객체와 같은 Action 객체를 반환합니다. 반환된 객체에 대한 자세한 내용은 각 메서드 예시를 참조하십시오.  
주:  
NotifyAction API는 전역 애플리케이션 내에서만 유효합니다. 범위가 지정된 애플리케이션 내에서 이러한 유형의 기능을 활용하려면 사용자 지정 알림 워크플로우 활동을 만들어야 합니다. 이러한 활동을 만드는 방법에 대한 자세한 내용은 [알림 워크플로우 활동을](https://www.servicenow.com/docs/access?context=c_NotifyActivities&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하십시오.

## 알림 작업 - addConference() {#ariaid-title2}

현재 통화를 현재 전화 회의로 이동하는 회의 동작을 추가합니다.
{#r_NotifyAction-addConference__table_ef5_xg4_wr__entry__3}

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

{#r_NotifyAction-addConference__table_ef5_xg4_wr} {#r_NotifyAction-addConference__table_ff5_xg4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 회의 작업 | NotifyAction 객체에 추가된 작업입니다. ConferenceAction 개체를 사용하여 전화 회의 이름을 정의하고 참가자가 참가하거나 나갈 때 전화 회의의 동작을 정의합니다. |
[표 2. 반환]

{#r_NotifyAction-addConference__table_ff5_xg4_wr}  
이 예시에서는 회의 동작을 추가하고 회의 이름을 설정하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a conference call action and set its name
    var conference = notifyAction.addConference();
    conference.setName('Brown Bag: Week 3');

## 알림 작업 - addConference.setEndOnExit(부울 endOnExit) {#ariaid-title3}

지정된 호출자가 전화 회의에서 나갈 때 전화 회의를 종료할지 여부를 정의합니다.
{#NotifyAction-addConference_setEndOnExit_B__table_j33_tmc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| endOnExit | 부울 | 지정된 호출자가 현재 전화 회의를 종료할 때 전화 회의를 종료해야 하는지 여부를 나타내는 플래그입니다. * 예: 지정된 호출자가 전화 회의를 종료하면 전화 회의를 종료합니다. * false: 기본값 모든 참가자가 나가면 컨퍼런스 회의 종료 {#NotifyAction-addConference_setEndOnExit_B__ul_bcw_4fc_cgb} |
[표 3. 매개변수]

{#NotifyAction-addConference_setEndOnExit_B__table_j33_tmc_cgb} {#NotifyAction-addConference_setEndOnExit_B__table_k33_tmc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 4. 반환]

{#NotifyAction-addConference_setEndOnExit_B__table_k33_tmc_cgb}  
이 예에서는 전화 회의 동작을 추가한 다음, 지정된 호출자가 나갈 때 컨퍼런스 회의가 종료되도록 설정하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a conference call action and set the caller that starts the meeting
    var conference = notifyAction.addConference();

    // retrieve the participant for which the conference call should exit when they leave
    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
    conference.setEndOnExit(true);
    }

## 알림 작업 - addConference.setHangupOnStar(부울 hangupOnStar) {#ariaid-title4}

참가자가 별(\*) 키를 누를 때 전화 회의를 종료할지 여부를 정의합니다.
{#NotifyAction-addConference_setHangupOnStar_B__table_kjb_jkc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 끊기OnStar | 부울 | 참가자가 별(\*) 키를 누를 때 전화 회의를 종료할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 전화 회의 종료 * false: 기본값 전화 회의를 종료하지 않음 {#NotifyAction-addConference_setHangupOnStar_B__ul_bcw_4fc_cgb} |
[표 5. 매개변수]

{#NotifyAction-addConference_setHangupOnStar_B__table_kjb_jkc_cgb} {#NotifyAction-addConference_setHangupOnStar_B__table_ljb_jkc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 6. 반환]

{#NotifyAction-addConference_setHangupOnStar_B__table_ljb_jkc_cgb}  
이 예시에서는 회의 동작을 추가한 다음 전화 회의를 기록하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a conference call action and set the hang up action
    var conference = notifyAction.addConference();
    conference.setHangupOnStar(true);

## 알림 작업 - addConference.setMuted(부울 음소거됨) {#ariaid-title5}

현재 전화 회의에서 지정된 호출자를 음소거해야 하는지 여부를 정의합니다.
이 메서드를 호출하지 않으면 호출자는 기본적으로 음소거되지 않습니다.
{#NotifyAction-addConference_setMuted_B__table_zws_qgc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 음소거됨 | 부울 | 현재 전화 회의에서 지정된 호출자를 음소거해야 하는지 여부를 나타내는 플래그입니다. * 예: 호출자를 음소거해야 합니다. * false: 기본값 호출자는 음소거하면 안 됩니다. {#NotifyAction-addConference_setMuted_B__ul_bcw_4fc_cgb} |
[표 7. 매개변수]

{#NotifyAction-addConference_setMuted_B__table_zws_qgc_cgb} {#NotifyAction-addConference_setMuted_B__table_axs_qgc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 8. 반환]

{#NotifyAction-addConference_setMuted_B__table_axs_qgc_cgb}  
이 예시에서는 회의 동작을 추가한 다음 지정된 호출자를 음소거하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a conference call action and set it to mute the specified participant
    var conference = notifyAction.addConference();

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
    conference.setMuted(true);
    }

## 알림 작업 - addConference.setName(문자열 이름) {#ariaid-title6}

현재 컨퍼런스 회의의 이름을 지정된 이름으로 설정합니다.
{#NotifyAction-addConference_setName_S__table_okj_rcc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 현재 컨퍼런스 회의에 연결할 이름입니다. |
[표 9. 매개변수]

{#NotifyAction-addConference_setName_S__table_okj_rcc_cgb} {#NotifyAction-addConference_setName_S__table_pkj_rcc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 10. 반환]

{#NotifyAction-addConference_setName_S__table_pkj_rcc_cgb}  
이 예시에서는 회의 동작을 추가하고 전화 회의의 이름을 설정하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a conference call action and set its name
    var conference = notifyAction.addConference();

    conference.setName('Brown Bag: Week 3');

## 알림 작업 - addConference.setRecord(부울 기록) {#ariaid-title7}

관련 컨퍼런스 회의를 기록할지 여부를 정의합니다.
이 메서드를 호출하지 않으면 기본적으로 컨퍼런스 회의가 기록되지 않습니다.
{#NotifyAction-addConference_setRecord_B__table_bz2_ffc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기록 | 부울 | 현재 컨퍼런스 회의를 기록해야 하는지 여부를 나타내는 플래그입니다. * true: 컨퍼런스 회의 기록 시작 * false: 기본값 컨퍼런스 회의가 기록되지 않았습니다. 현재 기록 중이라면 기록이 중지됩니다. {#NotifyAction-addConference_setRecord_B__ul_bcw_4fc_cgb} |
[표 11. 매개변수]

{#NotifyAction-addConference_setRecord_B__table_bz2_ffc_cgb} {#NotifyAction-addConference_setRecord_B__table_cz2_ffc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 12. 반환]

{#NotifyAction-addConference_setRecord_B__table_cz2_ffc_cgb}  
이 예시에서는 회의 동작을 추가한 다음 전화 회의를 기록하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a conference call action and set it to be recorded
    var conference = notifyAction.addConference();
    conference.setRecord(true);

## 알림 작업 - addConference.setStartOnEnter(부울 startOnEnter) {#ariaid-title8}

지정된 호출자가 전화 회의에 참가할 때 전화 회의를 시작할지 여부를 정의합니다.
기본적으로 호출자가 두 명 이상일 때마다 전화 회의가 시작됩니다. 특정 호출자가 참가할 때만 전화 회의가 시작되도록 하려면 다른 각 호출자에 대해 이 메서드를 호출하고 값을 "false"로 설정해야 합니다. 이렇게 하면 원하는 사람이 전화 회의에 참가할 때까지 전화 회의가 시작되지 않습니다.
{#NotifyAction-addConference_setStartOnEnter_B__table_dps_43c_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| startOnEnter | 부울 | 선택한 호출자가 현재 컨퍼런스 회의에 참가할 때 컨퍼런스 회의를 시작해야 하는지 여부를 나타내는 플래그입니다. * true: 기본값 지정된 호출자가 전화 회의에 참가하면 전화 회의를 시작합니다. * false: 추가되면 전화 회의를 시작합니다. {#NotifyAction-addConference_setStartOnEnter_B__ul_bcw_4fc_cgb} |
[표 13. 매개변수]

{#NotifyAction-addConference_setStartOnEnter_B__table_dps_43c_cgb} {#NotifyAction-addConference_setStartOnEnter_B__table_eps_43c_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 14. 반환]

{#NotifyAction-addConference_setStartOnEnter_B__table_eps_43c_cgb}  
이 예에서는 회의 동작을 추가한 다음 지정된 호출자가 참가할 때까지 컨퍼런스 회의가 시작되지 않도록 설정하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a conference call action and set the caller that starts the meeting
    var conference = notifyAction.addConference();

    // retrieve the participant for which the conference call should start when they arrive
    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
    conference.setStartOnEnter(true);
    }

## 알림 작업 - addDial() {#ariaid-title9}

지정된 전화 번호 또는 알림 클라이언트로 호출을 착신 전환합니다.
addDial 작업이 생성되면 연결된 전화 번호(setPhoneNumber()) 또는 알림 클라이언트(setClientRecord())도 설정해야 합니다.
{#r_NotifyAction-addDial__table_ef5_xg4_wr__entry__3}

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

{#r_NotifyAction-addDial__table_ef5_xg4_wr} {#r_NotifyAction-addDial__table_ff5_xg4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 다이얼액션 | NotifyAction 객체에 추가된 작업입니다. |
[표 16. 반환]

{#r_NotifyAction-addDial__table_ff5_xg4_wr}  
이 예에서는 아웃바운드 호출을 걸고 호출을 기록하는 방법을 보여줍니다.

    // Initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addDial() to connect to another party -- this returns an object of type DialAction
    var dialAction = notifyAction.addDial();
     
    // Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
    dialAction.setPhoneNumber('+919765xxxxxxx');
     
    // Invoke setRecord(Boolean record) to record the call to this new number +919765xxxxxxx
    dialAction.setRecord(true);

## 알림 작업 - addDial.setCallerID(문자열 callerID) {#ariaid-title10}

발신 콜의 발신자 ID를 정의합니다.
{#NotifyAction-addDial_setCallerID_S__table_ehj_hzc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 호출자 ID | 문자열 | 발신 콜에 대해 설정할 호출자 식별자입니다. |
[표 17. 매개변수]

{#NotifyAction-addDial_setCallerID_S__table_ehj_hzc_cgb} {#NotifyAction-addDial_setCallerID_S__table_fhj_hzc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 18. 반환]

{#NotifyAction-addDial_setCallerID_S__table_fhj_hzc_cgb}  
이 예에서는 아웃바운드 호출을 걸고 호출 시간 제한을 설정하는 방법을 보여줍니다.

    // Initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addDial() to connect to another party -- this returns an object of type DialAction
    var dialAction = notifyAction.addDial();
     
    // Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
    dialAction.setPhoneNumber('+919765xxxxxxx');
     
    // Set the caller ID
    dialAction.setCallerID('Planning Conf Call');

## 알림 작업 - addDial.setClientRecord(String tableName, String sysID) {#ariaid-title11}

알림 호출자 기록과 호출자의 고유 식별자를 찾을 테이블을 지정하여 현재 호출자를 알림 호출자로 설정합니다.
{#NotifyAction-addDial_setClientRecord_S_S__table_mmn_zbd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 원하는 호출자의 정보가 들어 있는 테이블의 이름입니다. |
| sysID | 문자열 | 원하는 알림 호출자의 고유 식별자(sys_id)입니다. |
[표 19. 매개변수]

{#NotifyAction-addDial_setClientRecord_S_S__table_mmn_zbd_cgb} {#NotifyAction-addDial_setClientRecord_S_S__table_nmn_zbd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 20. 반환]

{#NotifyAction-addDial_setClientRecord_S_S__table_nmn_zbd_cgb}  
이 예는 setClientRecord()를 사용하여 현재 호출자를 알림 호출자로 설정하는 방법을 보여줍니다.

    // set up a dial action to forward the
    // call to the specified client
    var action = new SNC.NotifyAction();
    var dial = action.addDial();
    dial.setClientRecord(notifyClientRecord.getTableName(), notifyClientRecord.getUniqueValue());
    dial.setTimeout(activity.vars.timeout);
    dial.setRecord(activity.vars.record);

## 알림 작업 - addDial.setDTMF(문자열 값) {#ariaid-title12}

콜이 연결될 때 재생할 DTMF 톤을 정의합니다.
{#NotifyAction-addDial_setDTMF_S__table_ult_2fd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 값 | 문자열 | 호출이 연결될 때 재생할 유효한 DTMF 숫자입니다. |
[표 21. 매개변수]

{#NotifyAction-addDial_setDTMF_S__table_ult_2fd_cgb} {#NotifyAction-addDial_setDTMF_S__table_vlt_2fd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 22. 반환]

{#NotifyAction-addDial_setDTMF_S__table_vlt_2fd_cgb}  
이 예에서는 아웃바운드 호출을 하는 방법을 보여 주고 호출이 연결될 때 재생할 DTMF 신호음을 정의합니다.

    // Initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addDial() to connect to another party - this returns an object of type DialAction
    var dialAction = notifyAction.addDial();
     
    // Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
    dialAction.setPhoneNumber('+919765xxxxxxx');
     
    // DTMF tones to play when call connects
    dialAction.setDTMF("1246AF");

## 알림 작업 - addDial.setHangupOnStar(부울 hangupOnStar) {#ariaid-title13}

별(\*) 키를 누를 때 호출을 종료할지 여부를 정의합니다.
{#NotifyAction-addDial_setHangupOnStar_B__table_uns_2gd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 끊기OnStar | 부울 | 별(\*) 키를 누를 때 호출을 종료해야 하는지 여부를 나타내는 플래그입니다. * true: 호출을 종료합니다. * false: 통화를 종료하지 않음 {#NotifyAction-addDial_setHangupOnStar_B__ul_bcw_4fc_cgb} |
[표 23. 매개변수]

{#NotifyAction-addDial_setHangupOnStar_B__table_uns_2gd_cgb} {#NotifyAction-addDial_setHangupOnStar_B__table_vns_2gd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 24. 반환]

{#NotifyAction-addDial_setHangupOnStar_B__table_vns_2gd_cgb}  
이 예시에서는 아웃바운드 전화를 걸고 끊는 키를 별표로 설정하는 방법을 보여줍니다.

    // Initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addDial() to connect to another party -- this returns an object of type DialAction
    var dialAction = notifyAction.addDial();
     
    // Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
    dialAction.setPhoneNumber('+919765xxxxxxx');
     
    // End call by pressing star
    dialAction.setHangupOnStar(true);

## 알림 작업 - addDial.setPhoneNumber(문자열 phoneNumber) {#ariaid-title14}

발신 전화 번호를 정의합니다.
{#NotifyAction-addDial_setPhoneNumber_S__table_cdc_f1d_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| phoneNumber | 문자열 | 발신 대상 E.164 호환 전화 번호입니다. |
[표 25. 매개변수]

{#NotifyAction-addDial_setPhoneNumber_S__table_cdc_f1d_cgb} {#NotifyAction-addDial_setPhoneNumber_S__table_ddc_f1d_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 26. 반환]

{#NotifyAction-addDial_setPhoneNumber_S__table_ddc_f1d_cgb}  
이 예에서는 아웃바운드 호출을 걸고 호출 시간 제한을 설정하는 방법을 보여줍니다.

    // Initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addDial() to connect to another party -- this returns an object of type DialAction
    var dialAction = notifyAction.addDial();
     
    // Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
    dialAction.setPhoneNumber('+919765xxxxxxx');

## 알림 작업 - addDial.setRecord(부울 기록) {#ariaid-title15}

발신 콜을 기록할지 여부를 정의합니다.
{#NotifyAction-addDial_setRecord_B__table_hbp_sdd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기록 |   | 발신 통화를 기록해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 발신 통화를 기록합니다. * false: 발신 통화를 기록하지 않습니다. {#NotifyAction-addDial_setRecord_B__ul_z5r_22d_cgb} |
[표 27. 매개변수]

{#NotifyAction-addDial_setRecord_B__table_hbp_sdd_cgb} {#NotifyAction-addDial_setRecord_B__table_ibp_sdd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 28. 반환]

{#NotifyAction-addDial_setRecord_B__table_ibp_sdd_cgb}  
이 예에서는 아웃바운드 호출을 걸고 호출을 기록하는 방법을 보여줍니다.

    // Initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addDial() to connect to another party -- this returns an object of type DialAction
    var dialAction = notifyAction.addDial();
     
    // Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
    dialAction.setPhoneNumber('+919765xxxxxxx');
     
    // Record the call
    dialAction.setRecord(true);

## 알림 작업 - addDial.setTimeout(Integer timeout) {#ariaid-title16}

발신 콜이 시간 초과되기까지의 시간(초)을 설정합니다.
{#NotifyAction-addDial_setTimeout_I__table_ldb_hyc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시간 제한 | 정수 | 발신 콜이 시간 초과될 때까지의 시간(초)입니다. 기본값: 30 |
[표 29. 매개변수]

{#NotifyAction-addDial_setTimeout_I__table_ldb_hyc_cgb} {#NotifyAction-addDial_setTimeout_I__table_mdb_hyc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 30. 반환]

{#NotifyAction-addDial_setTimeout_I__table_mdb_hyc_cgb}  
이 예에서는 아웃바운드 호출을 걸고 호출 시간 제한을 설정하는 방법을 보여줍니다.

    // Initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addDial() to connect to another party -- this returns an object of type DialAction
    var dialAction = notifyAction.addDial();
     
    // Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
    dialAction.setPhoneNumber('+919765xxxxxxx');
     
    // Set the number of seconds to wait before timing out
    dialAction.setTimeout(45);

## 알림 작업 - addGather() {#ariaid-title17}

호출자에게 지정된 대화형 전화 메뉴를 표시합니다.
{#r_NotifyAction-addGather__table_crt_zg4_wr__entry__3}

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

{#r_NotifyAction-addGather__table_crt_zg4_wr} {#r_NotifyAction-addGather__table_drt_zg4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| GatherAction | NotifyAction 객체에 추가된 작업입니다. GatherAction 개체를 사용하여 사용자에게 표시할 메뉴 설정 및 옵션을 정의합니다. |
[표 32. 반환]

{#r_NotifyAction-addGather__table_drt_zg4_wr}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // present the user with a menu
    var gather = notifyAction.addGather();
    gather.setNumberOfDigits(1);    // the user can type 1 digit
    gather.setFinishKey('#');       // # or *, useful for > 1 digit
    gather.setTimeout(10);          // time to enter answer, in seconds

    // add first menu item
    var usSay = gather.addSay();
    usSay.setText('Press 1 for english');
    usSay.setLanguage('en-US');

    // add second menu item
    var nlSay = gather.addSay();
    nlSay.setText('Kies 2 voor Nederlands');
    nlSay.setLanguage('nl-NL');

    // add third menu item
    var frSay = gather.addSay();
    frSay.setText('Choisissez 3 pour le français.');
    frSay.setLanguage('fr-FR');

    // and finish off with an applause
    var play = gather.addPlay();
    play.setURL('http://www.wavsource.com/snds_2015-04-12_5971820382841326/sfx/applause_y.wav');

## 알림 작업 - addGather.addPlay() {#ariaid-title18}

통화 중에 오디오 파일을 재생합니다.
지원되는 하위 메서드에 대한 설명은 NotifyAction addPlay() 메서드를 참조하십시오.
{#NotifyAction-addGather_addPlay__table_uhd_mpd_cgb__entry__3}

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

{#NotifyAction-addGather_addPlay__table_uhd_mpd_cgb} {#NotifyAction-addGather_addPlay__table_vhd_mpd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 플레이액션 | NotifyAction 객체에 추가된 작업입니다. PlayAction 객체를 사용하여 오디오 파일 URL과 오디오를 반복하는 횟수를 정의합니다. |
[표 34. 반환]

{#NotifyAction-addGather_addPlay__table_vhd_mpd_cgb}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // Create the gather action object
    var gather = notifyAction.addGather();

    // Play an audio file
    var play = gather.addPlay();
    play.setURL('http://www.wavsource.com/snds_2015-04-12_5971820382841326/sfx/applause_y.wav');

## 알림 작업 - addGather.addSay() {#ariaid-title19}

통화 중에 읽을 텍스트 음성 변환을 정의합니다.
지원되는 하위 메서드에 대한 설명은 NotifyAction addSay() 메서드를 참조하십시오.
{#NotifyAction-addGather_addSay__table_cp4_znd_cgb__entry__3}

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

{#NotifyAction-addGather_addSay__table_cp4_znd_cgb} {#NotifyAction-addGather_addSay__table_dp4_znd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| Say액션 | NotifyAction 객체에 추가된 작업입니다. SayAction 객체를 사용하여 읽을 텍스트와 언어를 정의합니다. |
[표 36. 반환]

{#NotifyAction-addGather_addSay__table_dp4_znd_cgb}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // present the user with a menu
    var gather = notifyAction.addGather();
    gather.setNumberOfDigits(1);    // the user can type 1 digit
    gather.setTimeout(20);          // time to enter answer, in seconds

    // add first menu item
    var gatherSay = gather.addSay();
    gatherSay.setText('Press 1 for english');
    gatherSay.setLanguage('en-US');

## 알림 작업 - addGather.setFinishKey(String finishKey) {#ariaid-title20}

호출자가 입력의 끝을 나타내기 위해 입력하는 키를 정의합니다.
{#NotifyAction-addGather_setFinishKey_S__table_pk1_hmd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| finishKey | 문자열 | 호출자 입력의 끝을 나타내는 키입니다. 유효한 값은 다음과 같습니다. * 0-9 * #(기본값) * \* {#NotifyAction-addGather_setFinishKey_S__ul_vv3_vhd_cgb} |
[표 37. 매개변수]

{#NotifyAction-addGather_setFinishKey_S__table_pk1_hmd_cgb} {#NotifyAction-addGather_setFinishKey_S__table_qk1_hmd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 38. 반환]

{#NotifyAction-addGather_setFinishKey_S__table_qk1_hmd_cgb}  
이 예시에서는 수집 작업을 추가하고 호출자 입력의 끝을 나타내는 키를 정의하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    var gather = notifyAction.addGather();
    gather.setNumberOfDigits(4);    // the user can type four digit
    gather.setFinishKey('#');       // # or *, useful for > 1 digit

## 알림 작업 - addGather.setNumberOfDigits(Integer numberOfDigits) {#ariaid-title21}

수집할 자릿수를 정의합니다.
{#NotifyAction-addGather_setNumberOfDigits_I__table_f2w_3ld_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| numberOfDigits | 정수 | 수집할 자릿수입니다. 0은 잘못된 값입니다. |
[표 39. 매개변수]

{#NotifyAction-addGather_setNumberOfDigits_I__table_f2w_3ld_cgb} {#NotifyAction-addGather_setNumberOfDigits_I__table_g2w_3ld_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 40. 반환]

{#NotifyAction-addGather_setNumberOfDigits_I__table_g2w_3ld_cgb}  
이 예시에서는 수집 작업을 추가하고 수집할 키 입력 수를 정의하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // present the user with a menu
    var gather = notifyAction.addGather();
    gather.setNumberOfDigits(4);    // the user can type four digit
    gather.setFinishKey('#');       // # or *, useful for > 1 digits
    gather.setTimeout(20);          // time to enter answer, in seconds

## 알림 작업 - addGather.setTimeout(Integer timeout) {#ariaid-title22}

입력 수집 시간이 초과되기까지의 시간을 정의합니다.
{#NotifyAction-addGather_setTimeout_I__table_ej2_1nd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시간 제한 | 정수 | 시간이 초과되기 전에 호출자 입력을 기다리는 시간(초)입니다. 기본값: 10 |
[표 41. 매개변수]

{#NotifyAction-addGather_setTimeout_I__table_ej2_1nd_cgb} {#NotifyAction-addGather_setTimeout_I__table_fj2_1nd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 42. 반환]

{#NotifyAction-addGather_setTimeout_I__table_fj2_1nd_cgb}  
이 예시에서는 수집 작업을 추가하고 입력 시간 제한 값을 정의하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // present the user with a menu
    var gather = notifyAction.addGather();
    gather.setNumberOfDigits(4);    // the user can type 1 digit
    gather.setFinishKey('#');       // # or *, useful for > 1 digits
    gather.setTimeout(20);          // time to enter answer, in seconds

## 알림 작업 - addHangUp() {#ariaid-title23}

활성 전화 통화를 종료합니다.
{#r_NotifyAction-addHangUp__table_tqt_lh4_wr__entry__3}

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

{#r_NotifyAction-addHangUp__table_tqt_lh4_wr} {#r_NotifyAction-addHangUp__table_uqt_lh4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 끊기 작업 | NotifyAction 객체에 추가된 작업입니다. |
[표 44. 반환]

{#r_NotifyAction-addHangUp__table_uqt_lh4_wr}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // hang up
    notifyAction.addHangUp();

## 알림 작업 - addQueue() {#ariaid-title24}

호출을 큐에 대기하여 호출을 보류합니다.
{#r_NotifyAction-addQueue__table_e5b_j24_wr__entry__3}

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

{#r_NotifyAction-addQueue__table_e5b_j24_wr} {#r_NotifyAction-addQueue__table_f5b_j24_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 큐 작업 | NotifyAction 객체에 추가된 작업입니다. QueueAction 객체를 사용하여 큐 이름과 큐에 대기하거나 큐에서 제거할 동작을 정의합니다. |
[표 46. 반환]

{#r_NotifyAction-addQueue__table_f5b_j24_wr}  
이 예에서는 지정된 큐에 호출을 추가하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // queue the call
    var queue = notifyAction.addQueue();
    queue.setName('my queue');

이 예에서는 큐에서 호출을 제거하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // dequeue the call
    var queue = notifyAction.addQueue();
    queue.setDequeue(true);

## 알림 작업 - addQueue.setDequeue(부울 dequeue) {#ariaid-title25}

현재 통화 큐에서 통화를 제거합니다("보류"에서 해제).
{#NotifyAction-addQueue_setDequeue_B__table_enw_wwd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 큐에서 제거 | 부울 | 큐에서 현재 호출을 제거할지 여부를 나타내는 플래그입니다. * true: 큐에서 호출을 제거합니다. * false: 호출이 큐에 배치됨 {#NotifyAction-addQueue_setDequeue_B__ul_lph_gxd_cgb} |
[표 47. 매개변수]

{#NotifyAction-addQueue_setDequeue_B__table_enw_wwd_cgb} {#NotifyAction-addQueue_setDequeue_B__table_fnw_wwd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 48. 반환]

{#NotifyAction-addQueue_setDequeue_B__table_fnw_wwd_cgb}  
이 예에서는 큐에서 호출을 제거하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // dequeue the call
    var queue = notifyAction.addQueue();
    queue.setDequeue(true);

## 알림 작업 - addQueue.setName(문자열 이름) {#ariaid-title26}

큐와 연결된 이름을 정의합니다.
{#NotifyAction-addQueue_setName_S__table_fph_xvd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 큐에 연결할 이름입니다. |
[표 49. 매개변수]

{#NotifyAction-addQueue_setName_S__table_fph_xvd_cgb} {#NotifyAction-addQueue_setName_S__table_gph_xvd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 50. 반환]

{#NotifyAction-addQueue_setName_S__table_gph_xvd_cgb}  
이 예시에서는 큐의 이름을 정의하는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // queue the call
    var queue = notifyAction.addQueue();
    queue.setName('my queue');

## 알림 작업 - addPlay() {#ariaid-title27}

통화 중에 오디오 파일을 재생합니다.
{#r_NotifyAction-addPlay__table_inp_1g4_wr__entry__3}

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

{#r_NotifyAction-addPlay__table_inp_1g4_wr} {#r_NotifyAction-addPlay__table_jnp_1g4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 플레이액션 | NotifyAction 객체에 추가된 작업입니다. PlayAction 객체를 사용하여 오디오 파일 URL과 오디오를 반복하는 횟수를 정의합니다. |
[표 52. 반환]

{#r_NotifyAction-addPlay__table_jnp_1g4_wr}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a play action
    var play = notifyAction.addPlay();
    play.setURL('http://www.moviesounds.com/2001/imsorry.wav');
    play.setLoop(1);

## 알림 작업 - addPlay.setLoop(정수 루프) {#ariaid-title28}

오디오 파일을 재생(반복)하는 횟수를 정의합니다.
{#NotifyAction-addPlay_setLoop_I__table_akq_1rd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 루프 | 정수 | 오디오 파일을 재생하는 횟수입니다. |
[표 53. 매개변수]

{#NotifyAction-addPlay_setLoop_I__table_akq_1rd_cgb} {#NotifyAction-addPlay_setLoop_I__table_bkq_1rd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 54. 반환]

{#NotifyAction-addPlay_setLoop_I__table_bkq_1rd_cgb}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a play action
    var play = notifyAction.addPlay();
    play.setURL('http://www.moviesounds.com/2001/imsorry.wav');
    play.setLoop(2);

## 알림 작업 - addPlay.setURL(문자열 URL) {#ariaid-title29}

재생할 오디오 파일을 가져올 URL을 정의합니다.
{#NotifyAction-addPlay_setURL_S__table_t3n_pqd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| URL | 문자열 | 재생할 오디오 파일의 URL입니다. |
[표 55. 매개변수]

{#NotifyAction-addPlay_setURL_S__table_t3n_pqd_cgb} {#NotifyAction-addPlay_setURL_S__table_u3n_pqd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 56. 반환]

{#NotifyAction-addPlay_setURL_S__table_u3n_pqd_cgb}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a play action
    var play = notifyAction.addPlay();
    play.setURL('http://www.moviesounds.com/2001/imsorry.wav');
    play.setLoop(1);

## 알림 작업 - addRecord() {#ariaid-title30}

현재 NotifyAction 개체에 호출을 기록하는 작업을 추가합니다.
통화가 완료되거나 지정된 종료를 누르면 기록이 자동으로 종료됩니다(setFinishKey()). 그런 다음 기록은 연결된 호출에 대한 notify_record 테이블에 배치됩니다.
{#NotifyAction-addRecord__table_dyw_22x_zfb__entry__3}

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

{#NotifyAction-addRecord__table_dyw_22x_zfb} {#NotifyAction-addRecord__table_eyw_22x_zfb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 58. 반환]

{#NotifyAction-addRecord__table_eyw_22x_zfb}  
이 예시에서는 호출을 기록하는 방법을 보여줍니다.

    // First we initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Call addRecord() of NotifyAction -- This returns an object of type RecordAction
    var recordAction = notifyAction.addRecord();
     
    // Optional. Define the key that callers use to stop the recording
    recordAction.setFinishKey('#'); // Stop the call recording when caller presses the '#' key.

## 알림 작업 - addRecord.setFinishKey(String finishKey) {#ariaid-title31}

기록을 종료하는 키를 정의합니다.
{#NotifyAction-addRecord_setFinishKey_S__table_t1r_fhd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| finishKey | 문자열 | 기록을 종료하는 키입니다. 유효한 값은 다음과 같습니다. * 0-9 * #(기본값) * \* {#NotifyAction-addRecord_setFinishKey_S__ul_vv3_vhd_cgb} |
[표 59. 매개변수]

{#NotifyAction-addRecord_setFinishKey_S__table_t1r_fhd_cgb} {#NotifyAction-addRecord_setFinishKey_S__table_u1r_fhd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 60. 반환]

{#NotifyAction-addRecord_setFinishKey_S__table_u1r_fhd_cgb}  
이 예시에서는 통화를 기록하고 통화 종료 키를 설정하는 방법을 보여줍니다.

    // First we initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Then we call addRecord() of NotifyAction 
    var recordAction = notifyAction.addRecord();
     
    // Set the key that terminates the recording
    recordAction.setFinishKey('#'); // This means that we stop the call recording when user presses the '#' key.

## 알림 작업 - addRecord.setMaxDuration(Integer seconds) {#ariaid-title32}

기록의 최대 길이를 정의합니다.
{#NotifyAction-addRecord_setMaxDuration_I__table_xv3_cjd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 초 | 정수 | 기록의 최대 길이(초)입니다. 기본값: 3600 |
[표 61. 매개변수]

{#NotifyAction-addRecord_setMaxDuration_I__table_xv3_cjd_cgb} {#NotifyAction-addRecord_setMaxDuration_I__table_yv3_cjd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 62. 반환]

{#NotifyAction-addRecord_setMaxDuration_I__table_yv3_cjd_cgb}  
이 예시에서는 통화를 기록하고 통화 종료 키를 설정하는 방법을 보여줍니다.

    // First we initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Then we call addRecord() of NotifyAction 
    var recordAction = notifyAction.addRecord();
     
    // Set the maximum length of the recording
    recordAction.setMaxDuration(4800); 

## 알림 작업 - addRecord.setTimeout(Integer timeout) {#ariaid-title33}

기록이 종료된 후 무음 시간(초)을 설정합니다.
{#NotifyAction-addrecord_setTimeout_I__table_wnz_f3d_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시간 제한 | 정수 | 통화 중 기록이 종료된 후 무음이 지속되는 시간(초)입니다. 기본값: 10 |
[표 63. 매개변수]

{#NotifyAction-addrecord_setTimeout_I__table_wnz_f3d_cgb} {#NotifyAction-addrecord_setTimeout_I__table_xnz_f3d_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 64. 반환]

{#NotifyAction-addrecord_setTimeout_I__table_xnz_f3d_cgb}  
이 예시에서는 통화를 기록하고 기록 시간 제한 값을 설정하는 방법을 보여줍니다.

    // First we initialize NotifyAction
    var notifyAction = new SNC.NotifyAction();
     
    // Then we call addRecord() of NotifyAction 
    var recordAction = notifyAction.addRecord();
     
    // Set the recoding timeout value
    recordAction.setTimeout(360); 

## 알림 작업 - addReject() {#ariaid-title34}

수신 전화를 거부합니다.
{#r_NotifyAction-addReject__table_z1j_rh4_wr__entry__3}

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

{#r_NotifyAction-addReject__table_z1j_rh4_wr} {#r_NotifyAction-addReject__table_abj_rh4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 작업 거부 | NotifyAction 객체에 추가된 작업입니다. RejectAction 객체를 사용하여 호출 거부 이유를 정의합니다. |
[표 66. 반환]

{#r_NotifyAction-addReject__table_abj_rh4_wr}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // reject the call
    var rejectAction = notifyAction.addReject();
    rejectAction.setReason('busy'); // 'busy' or 'rejected'

## NotifyActon - addReject.setReason(문자열 이유) {#ariaid-title35}

콜이 거부된 이유를 정의합니다.
{#NotifyActon-addReject_setReason_S__table_fdf_bzd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이유 | 문자열 | 콜이 거부된 이유입니다. 유효한 값은 다음과 같습니다. * 통화 중 * 거부됨 {#NotifyActon-addReject_setReason_S__ul_bf1_wpy_cgb}다른 모든 값은 무시합니다. |
[표 67. 매개변수]

{#NotifyActon-addReject_setReason_S__table_fdf_bzd_cgb} {#NotifyActon-addReject_setReason_S__table_gdf_bzd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 68. 반환]

{#NotifyActon-addReject_setReason_S__table_gdf_bzd_cgb}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // reject the call
    var rejectAction = notifyAction.addReject();
    rejectAction.setReason('busy'); // 'busy' or 'rejected'

## 알림 작업 - addSay() {#ariaid-title36}

통화 중에 읽을 텍스트 음성 변환을 정의합니다.
텍스트 음성 변환은 여러 언어가 지원됩니다. 사용 가능한 언어는 전화 통신 공급자에 따라 다릅니다.
{#r_NotifyAction-addSay__table_k1d_v24_wr__entry__3}

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

{#r_NotifyAction-addSay__table_k1d_v24_wr} {#r_NotifyAction-addSay__table_l1d_v24_wr__entry__2}

| 유형 | 설명 |
|-|-|
| Say액션 | NotifyAction 객체에 추가된 작업입니다. SayAction 객체를 사용하여 읽을 텍스트와 언어를 정의합니다. |
[표 70. 반환]

{#r_NotifyAction-addSay__table_l1d_v24_wr}  
이 예시에서는 여러 언어로 된 텍스트를 읽는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a say action to say something in US English
    var usSay = notifyAction.addSay();
    usSay.setText('Welcome. I can speak english');
    usSay.setLanguage('en-US');

    // add a say action to say something in Dutch
    var nlSay = notifyAction.addSay();
    nlSay.setText('Ik spreek ook vloeiend nederlands');
    nlSay.setLanguage('nl-NL');

    // and german
    var deSay = notifyAction.addSay();
    deSay.setText('Und ich kan auch deutsch sprechen');
    deSay.setLanguage('de-DE');

## 알림 작업 - addSay.setLanguage(문자열 언어) {#ariaid-title37}

텍스트를 말할 언어를 정의합니다.
이 메서드를 setText() 메서드와 함께 사용하여 말할 용어를 정의합니다.
{#NotifyAction-addSay_setLanguage_S__table_xsp_3bc_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 언어 | 문자열 | 관련 텍스트를 말할 언어를 정의하는 ISO 3166 언어 코드입니다. 예: "en-US" 또는 "nl-NL". |
[표 71. 매개변수]

{#NotifyAction-addSay_setLanguage_S__table_xsp_3bc_cgb} {#NotifyAction-addSay_setLanguage_S__table_ysp_3bc_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 72. 반환]

{#NotifyAction-addSay_setLanguage_S__table_ysp_3bc_cgb}  
이 예시에서는 여러 언어로 된 텍스트를 읽는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a say action to say something in US English
    var usSay = notifyAction.addSay();
    usSay.setText('Welcome. I can speak english');
    usSay.setLanguage('en-US');

    // add a say action to say something in Dutch
    var nlSay = notifyAction.addSay();
    nlSay.setText('Ik spreek ook vloeiend nederlands');
    nlSay.setLanguage('nl-NL');

    // and german
    var deSay = notifyAction.addSay();
    deSay.setText('Und ich kan auch deutsch sprechen');
    deSay.setLanguage('de-DE');

## 알림 작업 - addSay.setText(문자열 텍스트) {#ariaid-title38}

현재 호출 내에서 읽을 텍스트를 정의합니다.
이 메서드를 setLanguage() 메서드와 함께 사용하여 제공된 텍스트를 말할 언어를 정의합니다.
{#NotifyAction-addSay_setText_S__table_mz3_gvs_1gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 텍스트 | 문자열 | 현재 통화 내에서 소리내어 읽을 텍스트입니다. |
[표 73. 매개변수]

{#NotifyAction-addSay_setText_S__table_mz3_gvs_1gb} {#NotifyAction-addSay_setText_S__table_nz3_gvs_1gb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 74. 반환]

{#NotifyAction-addSay_setText_S__table_nz3_gvs_1gb}  
이 예시에서는 여러 언어로 된 텍스트를 읽는 방법을 보여줍니다.

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // add a say action to say something in US English
    var usSay = notifyAction.addSay();
    usSay.setText('Welcome. I can speak english');
    usSay.setLanguage('en-US');

    // add a say action to say something in Dutch
    var nlSay = notifyAction.addSay();
    nlSay.setText('Ik spreek ook vloeiend nederlands');
    nlSay.setLanguage('nl-NL');

    // and german
    var deSay = notifyAction.addSay();
    deSay.setText('Und ich kan auch deutsch sprechen');
    deSay.setLanguage('de-DE');

## 알림 작업 - addSMS() {#ariaid-title39}

SMS 메시지를 보냅니다.
주:  
활성 호출과 함께 이 함수를 사용하는 경우 반환된 SMSAction 개체에서 setTo 함수를 호출할 필요가 없습니다. SMS가 호출자에게 자동으로 전송됩니다.
{#r_NotifyAction-addSMS__table_gw2_kg4_wr__entry__3}

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

{#r_NotifyAction-addSMS__table_gw2_kg4_wr} {#r_NotifyAction-addSMS__table_hw2_kg4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| SMSAction | NotifyAction 객체에 추가된 작업입니다. SMSAction 객체를 사용하여 메시지 텍스트와 메시지를 보낼 전화 번호를 정의합니다. |
[표 76. 반환]

{#r_NotifyAction-addSMS__table_hw2_kg4_wr}  

    // Instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // Define where to send the SMS to
    var number = new GlideElementPhoneNumber();
    number.setPhoneNumber('+31612345678', true);

    // Add an SMS action
    var sms = notifyAction.addSMS();
    sms.setMessage('Lorem ipsum dolor sit amet, consectetur adipiscing elit.');
    sms.setTo(number);

## 알림 작업 - addSMS.setMessage(문자열 메시지) {#ariaid-title40}

보낼 SMS 메시지의 텍스트를 정의합니다.
{#NotifyAction-addSMS_setMessage_S__table_b2q_szd_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 보낼 SMS 메시지의 텍스트입니다. |
[표 77. 매개변수]

{#NotifyAction-addSMS_setMessage_S__table_b2q_szd_cgb} {#NotifyAction-addSMS_setMessage_S__table_c2q_szd_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 78. 반환]

{#NotifyAction-addSMS_setMessage_S__table_c2q_szd_cgb}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // define where to send the sms to
    var number = new GlideElementPhoneNumber();
    number.setPhoneNumber('+31612345678', true);

    // add a SMS action
    var sms = notifyAction.addSMS();
    sms.setMessage('Lorem ipsum dolor sit amet, consectetur adipiscing elit.');
    sms.setTo(number);

## 알림 작업 - addSMS.setTo(String to) {#ariaid-title41}

SMS 메시지를 보낼 전화 번호를 설정합니다.
{#NotifyAction-addSMS_setTo_S__table_qtf_212_cgb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 대상 | 문자열 | SMS 메시지를 보낼 E.164 호환 전화 번호입니다. |
[표 79. 매개변수]

{#NotifyAction-addSMS_setTo_S__table_qtf_212_cgb} {#NotifyAction-addSMS_setTo_S__table_rtf_212_cgb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 80. 반환]

{#NotifyAction-addSMS_setTo_S__table_rtf_212_cgb}  

    // instantiate NotifyAction
    var notifyAction = new SNC.NotifyAction();

    // define where to send the sms to
    var number = new GlideElementPhoneNumber();
    number.setPhoneNumber('+31612345678', true);

    // add a SMS action
    var sms = notifyAction.addSMS();
    sms.setMessage('Lorem ipsum dolor sit amet, consectetur adipiscing elit.');
    sms.setTo(number);

## 알림 작업 - 추가(알림 작업 작업) {#ariaid-title42}

지정된 NotifyAction 객체를 현재 클라이언트의 NotifyAction 객체에 추가합니다.
NotifyActions에는 터미널과 비터미널의 두 가지 유형이 있습니다. 클라이언트의 NotifyAction 개체에 터미널 작업을 추가하면 추가 작업을 추가할 수 없습니다. 종료되지 않은 작업에는 다음이 포함됩니다.

* 플레이액션
* RecordAction
* Say액션
* SMSAction
{#NotifyAction-append_NA__ul_lfb_rqy_cgb}

다른 모든 알림 작업은 터미널입니다. 터미널 작업 후에 다른 NotifyAction을 추가하려고 하면 호출이 실패합니다.
{#NotifyAction-append_NA__table_rl3_3bx_zfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 작업 | 알림 작업 | 현재 호출자의 NotifyAction 객체에 추가할 NotifyAction 객체입니다. |
[표 81. 매개변수]

{#NotifyAction-append_NA__table_rl3_3bx_zfb} {#NotifyAction-append_NA__table_sl3_3bx_zfb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 82. 반환]

{#NotifyAction-append_NA__table_sl3_3bx_zfb}

## 알림 작업 - fromJson(문자열 json) {#ariaid-title43}

JSON 문자열에서 NotifyAction 객체를 역직렬화합니다.
{#r_NotifyAction-fromJson_String__table_qc2_c34_wr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| JSON | 문자열 | NotifyAction 개체의 JSON 문자열 표현입니다. |
[표 83. 매개변수]

{#r_NotifyAction-fromJson_String__table_qc2_c34_wr} {#r_NotifyAction-fromJson_String__table_rc2_c34_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 84. 반환]

{#r_NotifyAction-fromJson_String__table_rc2_c34_wr}  
이 예제에서는 NotifyAction 개체를 역직렬화하는 방법을 보여 줍니다.

    var json = ".... some json obtained from toJson ....";

    // instantiate notify action
    var notifyAction = new SNC.NotifyAction();

    // deserialize and reconstruct the notify action instance
    notifyAction.fromJson(json);

이 예제에서는 NotifyAction 개체를 직렬화하고 역직렬화하는 방법을 보여 줍니다.

    // instantiate notify action
    var notifyAction = new SNC.NotifyAction();

    // add a queue
    var queue = notifyAction.addQueue();
    queue.setName('myQueueName');
    queue.setDequeue(false);

    // serialize to json
    var json = notifyAction.toJson();
    gs.log('serialization result: ' + json);

    // instantiate a new notify action
    var newAction = new SNC.NotifyAction();

    // deserialize the json generated above
    newAction.fromJson(json);

    // serialize the new object and log the result
    newJson = newAction.toJson();
    gs.log('new serialization result: ' + newJson);
    gs.log('the same: ' + (json == newJson));

출력: \*\*\* 스크립트: 직렬화 결과: {"fClassName":"NotifyAction","fActions":\[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}\]} \*\*\* 스크립트: 새 직렬화 결과: {"fClassName":"NotifyAction","fActions":\[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}\]} \*\*\* 스크립트: 동일: 예

## 알림 작업 - setCallRecord(GlideRecord callRecord) {#ariaid-title44}

후속 작업을 추가할 알림 통화 기록을 정의합니다.
{#NotifyAction-setCallRecord_GR__table_uwv_vvv_zfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 호출 기록 | GlideRecord | 작업을 추가할 호출자의 기록(notify_call 테이블 내)을 포함하는 GlideRecord입니다. 이 호출자는 이 메서드가 다른 호출자에게 다시 호출될 때까지 영향을 받습니다. |
[표 85. 매개변수]

{#NotifyAction-setCallRecord_GR__table_uwv_vvv_zfb} {#NotifyAction-setCallRecord_GR__table_vwv_vvv_zfb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 86. 반환]

{#NotifyAction-setCallRecord_GR__table_vwv_vvv_zfb}  
이 예시에서는 작업을 추가할 호출자를 설정하는 방법을 보여줍니다.

    public NotifyAction runIncomingCallWorkflow(NotifyPhoneNumber notifyPhoneNumber, GlideRecord callRecord) throws NoWorkflowConfiguredException, NoSuchNotifyGroupRecordException {
       NotifyAction notifyAction = runWorkflow(notifyPhoneNumber, COL_INCOMING_CALL_WF, callRecord);
       notifyAction.setCallRecord(callRecord);
       return notifyAction;
    }

## 알림 작업 - toJson() {#ariaid-title45}

NotifyAction 객체를 JSON 문자열로 직렬화합니다.
{#r_NotifyAction-toJson__table_ygy_xh4_wr__entry__3}

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

{#r_NotifyAction-toJson__table_ygy_xh4_wr} {#r_NotifyAction-toJson__table_zgy_xh4_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 이 NotifyAction 객체의 JSON 표현입니다. |
[표 88. 반환]

{#r_NotifyAction-toJson__table_zgy_xh4_wr}  
이 예제에서는 NotifyAction 개체를 직렬화하는 방법을 보여 줍니다.

    // instantiate notify action
    var notifyAction = new SNC.NotifyAction();

    // add one or more notify actions
    // ...

    // and serialize to json
    var json = notifyAction.toJson();

이 예제에서는 NotifyAction 개체를 직렬화하고 역직렬화하는 방법을 보여 줍니다.

    // instantiate notify action
    var notifyAction = new SNC.NotifyAction();

    // add a queue
    var queue = notifyAction.addQueue();
    queue.setName('myQueueName');
    queue.setDequeue(false);

    // serialize to json
    var json = notifyAction.toJson();
    gs.log('serialization result: ' + json);

    // instantiate a new notify action
    var newAction = new SNC.NotifyAction();

    // deserialize the json generated above
    newAction.fromJson(json);

    // serialize the new object and log the result
    newJson = newAction.toJson();
    gs.log('new serialization result: ' + newJson);
    gs.log('the same: ' + (json == newJson));

출력: \*\*\* 스크립트: 직렬화 결과: {"fClassName":"NotifyAction","fActions":\[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}\]} \*\*\* 스크립트: 새 직렬화 결과: {"fClassName":"NotifyAction","fActions":\[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}\]} \*\*\* 스크립트: 동일: 예