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

알림 API를 사용하면 스크립트를 사용하여 알림 콜 및 SMS 메시지와 상호작용할 수 있습니다.

`SNC` 네임스페이스에서 전역 Notify 클래스 및 관련 메서드에 액세스합니다.

## 알림 - call(문자열 notifyPhoneNumber, 문자열 toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, 문자열 userSysId, 문자열 groupSysId, GlideRecord sourceRecord) {#ariaid-title2}

지정된 E.164 호환 전화 번호로 전화를 겁니다.
또한 이 메서드는 지정된 전화 회의에 지정된 전화 번호를 자동으로 추가할 수 있습니다.
{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림 전화 번호 | String 또는 NotifyPhoneNumber | 전화를 걸 알림 전화 번호입니다. 전화를 걸면 이 번호와 연결된 번호 그룹에 대한 발신 통화 워크플로우가 실행됩니다. 사용자를 전화 회의에 연결하기 위한 이 워크플로우에 전화 회의 참가 활동이 포함되어 있는지 확인합니다. |
| toPhoneNumber | 문자열 | 발신 대상 전화 번호입니다. 발신 번호가 전화 회의에 추가됩니다. |
| 컨퍼런스 회의 | GlideRecord | 옵션입니다. 이 매개변수가 전달되면 매개변수에 toPhoneNumber 식별된 호출자가 이 기록으로 식별된 컨퍼런스 회의에 자동으로 참가합니다. 전화 회의 기록을 식별하는 알림 통화 \[notify_call\] 테이블에 대한 GlideRecord입니다. 이 기록은 발신 콜 워크플로우 스크래치패드에 workflow.scratchpad.conference_call 변수로 자동 추가됩니다. |
| userSysId | 문자열 | 옵션입니다. 호출과 연결된 사용자의 고유 식별자(sys_id)입니다. |
| groupSysId | 문자열 | 옵션입니다. 호출과 연결된 그룹의 고유 식별자(sys_id)입니다. |
| sourceRecord | GlideRecord | 옵션입니다. 이 호출을 촉발한 소스 기록입니다. |
[표 1. 매개변수]

{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr} {#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr__entry__2}

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

{#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr}  
이 예시에서는 다른 전화 번호로 전화를 걸는 방법을 보여줍니다.

    var from = '+14048007337';
    var to = '+31646810495';

    // set up call
    new SNC.Notify().call(from, to);

이 예에서는 전화 번호 목록에 대한 통화를 시작하고 해당 번호를 새 전화 회의에 자동으로 참가시키는 방법을 보여줍니다.

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

이 예시에서는 새 전화 회의를 시작하는 방법을 보여줍니다.

    SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), null, null, null);

이 예에서는 사용자 기록을 사용하여 새 전화 회의를 시작하는 방법을 보여줍니다.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active conference sys id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), sysUserGr.getUniqueValue(), null, null);
    }

이 예는 사용자, 그룹 및 소스 기록으로 새 전화 회의를 시작하는 방법을 보여줍니다.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active sys user sys id');
     
    var sysUserGroupGr = new GlideRecord('sys_user_group');
    sysUserGroupGr.get('active sys user group sys id');
     
    var incidentGr = new GlideRecord('incident');
    incidentGr.get('incident sys_id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX',
            SNC.Notify.conferenceCall(),
            sysUserGr.getUniqueValue(),
            sysUserGroupGr.getUniqueValue(),
            incidentGr.getUniqueValue());
    }

### 범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 call() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - call()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-call_S_S_GR_GR_S_S_GR "지정된 E.164 호환 전화 번호로 전화를 겁니다.")을 사용합니다.

## 알림 - conferenceCall(GlideRecord sourceRecord) {#ariaid-title3}

새 컨퍼런스 회의 GlideRecord를 작성합니다.
{#r_N-conferenceCall__table_ysr_5mk_js__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sourceRecord | GlideRecord | 옵션입니다. 전화 회의 생성 요청을 시작한 기록입니다. notify_conference_call 기록의 소스 및 테이블 필드를 채우는 데 사용됩니다. |
[표 3. 매개변수]

{#r_N-conferenceCall__table_ysr_5mk_js} {#r_N-conferenceCall__table_zsr_5mk_js__entry__2}

| 유형 | 설명 |
|-|-|
| GlideRecord | 새 알림 전화 회의 \[notify_conference_call\] 기록입니다. |
[표 4. 반환]

{#r_N-conferenceCall__table_zsr_5mk_js}  

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

### 범위가 지정된 해당 항목 {#r_N-conferenceCall__section_wzp_1dd_1gb}

범위가 지정된 애플리케이션에서 conferenceCall() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - conferenceCall()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-conferenceCall "새 컨퍼런스 회의 GlideRecord를 작성합니다.")을 사용합니다.
**관련 참조**   

* [알림 - call(문자열 notifyPhoneNumber, 문자열 toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, 문자열 userSysId, 문자열 groupSysId, GlideRecord sourceRecord)](https://servicenow-prod.fluidtopics.net/02pgKTA1GfGkSfMTSGrBWg#r_N-call_NotifyPhoneNumber_S_GR "지정된 E.164 호환 전화 번호로 전화를 겁니다.")

## 알림 - dequeueCall(GlideRecord, callRecord) {#ariaid-title4}

큐에 놓인 호출(보류 중)을 재개합니다.
이 메서드를 사용하여 queueCall() 메서드와 함께 큐에 넣은 호출을 다시 시작합니다.
{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 호출 기록 | GlideRecord | 알림 통화 \[notify_call\] 테이블에 재개하려는 보류된 통화가 있는 GlideRecord 객체입니다. |
[표 5. 매개변수]

{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js} {#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js__entry__2}

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

{#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js}  
다음 예는 보류 상태였던 호출을 다시 활성화하는 방법을 보여줍니다.

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.dequeueCall(notifyCallGr);
    }

### 범위가 지정된 해당 항목 {#r_N-dequeueCall_GlideRecord__section_dws_mnd_1gb}

범위가 지정된 애플리케이션에서 dequeueCall() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - dequeueCall()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-dequeueCall_GR "큐에 놓인 호출(보류 중)을 재개합니다.")을 사용합니다.

## 알림 - forwardCall(GlideRecord call, 문자열 대상, 문자열 dtmf) {#ariaid-title5}

지정된 호출을 다른 호출 수신자에게 착신 전환합니다.
{#r_N-forwardCall_GR_S_S__table_byv_vml_ts__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 호출 | GlideRecord 또는 문자열 | 전달할 통화의 통화 기록 또는 전화 통신 공급자 통화 ID를 통지합니다. |
| 대상 | GlideRecord 또는 문자열 | 호출을 전달할 호출자의 전화 번호 기록 또는 E.164 호환 전화 번호를 통지합니다. |
| DTMF | 문자열 | 이중 톤 - 호출 연결 시 전송할 DTMF(다중 주파수) 코드입니다. |
[표 7. 매개변수]

{#r_N-forwardCall_GR_S_S__table_byv_vml_ts} {#r_N-forwardCall_GR_S_S__table_cyv_vml_ts__entry__2}

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

{#r_N-forwardCall_GR_S_S__table_cyv_vml_ts}  
다음 예는 다른 전화 번호로 통화를 착신 전환하는 방법을 보여줍니다.

    var callID = 'CA92374b5aa561dab476a7001db6026edc'; // Twilio Call ID
    var phoneNumber = '+91406xxxxxxx';
    var dtmfTones = null;
     
    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.forwardCall(notifyCallGr(or) callID, phoneNumber, dtmfTones)
    }

### 범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 forwardCall() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - forwardCall()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-forwardCall_GR_S_S "지정된 호출을 다른 호출 수신자에게 착신 전환합니다.")을 사용합니다.

## 알림 - getAvailableClients(문자열 notifyNumber) {#ariaid-title6}

전화를 받을 수 있는 클라이언트 세션의 목록을 반환합니다.
{#r_N-getAvailableClients_String__table_ibs_r1n_ms__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림번호 | 문자열 | 유효한 알림 전화 번호입니다. |
[표 9. 매개변수]

{#r_N-getAvailableClients_String__table_ibs_r1n_ms} {#r_N-getAvailableClients_String__table_jbs_r1n_ms__entry__2}

| 유형 | 설명 |
|-|-|
| GlideRecord | 지정된 전화 번호에 대한 테이블의 notify_client_session GlideRecord. 사용 가능한 클라이언트 세션이 없는 경우 "0"을 반환합니다. |
[표 10. 반환]

{#r_N-getAvailableClients_String__table_jbs_r1n_ms}  
다음 예제는 getAvailableClients() 메서드를 사용하여 notify_client_session 테이블로 인덱싱한 다음 사용 가능한 모든 Notify 클라이언트에서 반복하는 방법을 보여줍니다.

    var clientSessionGr = SNC.Notify.getAvailableClients('+185xxxxxxxx'); 
    // Here clientSessionGr is of type GlideRecord on 'notify_client_session' table.
     
    var isLoggedInUserAvailable = false;
    while (clientSessionGr.next()) {
      if (clientSessionGr.user == gs.getUserID())
        isLoggedInUserAvailable = clientSessionGr.available;
    }
    gs.info('isLoggedInUserAvailable - ' + isLoggedInUserAvailable);

### 범위가 지정된 해당 항목 {#r_N-getAvailableClients_String__section_bgp_tk2_1gb}

범위가 지정된 애플리케이션에서 getAvailableClients() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - getAvailableClients()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-getAvailableClients_S "전화를 받을 수 있는 클라이언트 세션의 목록을 반환합니다.")를 사용합니다.

## 알림 - getParentCallID(GlideRecord callRecord) {#ariaid-title7}

지정된 호출의 상위 호출 sys_id 반환합니다.
전달 워크플로우 활동 사용과 같이 다른 호출을 전달하여 시작된 모든 호출은 원래 호출의 하위 호출로 간주됩니다. 원래 호출이 상위 호출입니다.
{#r_N-getParentCallID_GR__table_sqs_jxn_wr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 호출 기록 | GlideRecord | 통화 상태를 반환할 알림 통화 \[notify_call\] 테이블의 기록입니다. |
[표 11. 매개변수]

{#r_N-getParentCallID_GR__table_sqs_jxn_wr} {#r_N-getParentCallID_GR__table_tqs_jxn_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 상위 콜 기록의 고유 sys_id입니다. |
[표 12. 반환]

{#r_N-getParentCallID_GR__table_tqs_jxn_wr}  
이 예에서는 지정된 호출의 상위 호출을 가져오는 방법을 보여줍니다.

    var callRecord = new GlideRecord('notify_call');
    callRecord.get("0f4f5863ff13310014ecffffffffff28");

    var notify = new SNC.Notify();
    var parentCallID = notify.getParentCallID(callRecord);

## 알림 - getPhoneNumbers() {#ariaid-title8}

알림에 사용할 수 있는 모든 전화번호와 약식 코드를 반환합니다.
{#r_N-getPhoneNumbers__table_hsf_mwf_wr__entry__3}

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

{#r_N-getPhoneNumbers__table_hsf_mwf_wr} {#r_N-getPhoneNumbers__table_isf_mwf_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 목록 | NotifyPhoneNumber 개체의 목록으로, 각 개체는 알림에 사용할 수 있는 하나의 전화 번호를 나타냅니다. |
[표 14. 반환]

{#r_N-getPhoneNumbers__table_isf_mwf_wr}  

    var list = SNC.Notify.getPhoneNumbers();
    for (var i = 0; i < list.size(); i++) {
        var num = list.get(i);
        gs.info(num.getNumber())
    }

### 범위가 지정된 해당 항목 {#r_N-getPhoneNumbers__section_it5_ktc_1gb}

범위가 지정된 애플리케이션에서 getPhoneNumbers() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - getPhoneNumbers()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-getPhoneNumbers "알림에 사용할 수 있는 모든 전화번호와 약식 코드를 반환합니다.")를 사용합니다.

## 알림 - getTokens(GlideRecord, record) {#ariaid-title9}

WebRTC 또는 모바일 클라이언트에서 사용할 활성 전화 통신 드라이버에 대한 클라이언트 토큰을 반환합니다.
{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기록 | GlideRecord | 그룹 기록 또는 사용자 기록과 같은 알림 클라이언트를 식별하는 데 사용할 GlideRecord입니다. |
[표 15. 매개변수]

{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr} {#r_N-getTokens_GlideRecord__table_wsx_c3n_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지원되는 드라이버에 대한 웹 RTC 토큰으로, {driverName1: "token1", driverName2: "token2"} 형식의 JSON 문자열로 표시됩니다(예: "TwilioDirect":"eyJhxxxx.eyJleHAiOiIxxxx.7fejxxx_mbLxxx" |
[표 16. 반환]

{#r_N-getTokens_GlideRecord__table_wsx_c3n_wr}  
이 예시에서는 현재 로그인한 사용자에 대한 클라이언트 토큰을 가져오는 방법을 보여줍니다.

    // get Notify client Tokens per active Notify driver for the currently logged in user
    var json = new SNC.Notify().getTokens();
     
    // Parse the JSON that was return into a tokens object
    var tokens = JSON.parse(json);

    // Log line
    gs.log('Notify client tokens for the currently logged in user');

     // iterate over the driver tokens
    for (var driver in tokens) {
     	gs.log(driver + ' Driver token: ' + tokens[driver]);
    }

이 예시에서는 모든 알림 그룹에 대한 클라이언트 토큰을 가져오는 방법을 보여줍니다.

    // instantiate Notify
    var notify = new SNC.Notify();
     
    // get all Notify Groups
    var notifyGroup = new GlideRecord("notify_group");
    notifyGroup.query();
     
    // iterate over all notify groups
    while (notifyGroup.next()) {
      // generate Notify Client tokens per active Notify Driver for this group
      var json = notify.getTokens(notifyGroup);
      var tokens = JSON.parse(json);
     
      for (var driver in tokens) {
        gs.log(gs.getMessage("Notify Client token for {0} driver and Notify Group '{1}': {2}", [driver, notifyGroup.getValue('name'), tokens[driver]]));
      }
    }

### 범위가 지정된 해당 항목 {#r_N-getTokens_GlideRecord__section_x32_ysl_1gb}

범위가 지정된 애플리케이션에서 getTokens() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - getTokens()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-getTokens_GR "WebRTC 또는 모바일 클라이언트에서 사용할 활성 전화 통신 드라이버에 대한 클라이언트 토큰을 반환합니다.")를 사용합니다.

## 알림 - getTokenTTL(문자열 소유자) {#ariaid-title10}

자동으로 시간 초과되기 전에 지정된 전화 통신 드라이버에 대해 클라이언트 세션이 활성 상태로 유지되는 최대 시간을 반환합니다.
{#Notify-getTokenTTL_S__table_mnj_xqb_zfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 소유자 | 문자열 | 세션 길이를 검색할 전화 통신 드라이버의 이름입니다. 유효한 값은 다음과 같습니다. * Twilio: 이전 드라이버용 * TwilioDirect: 새 드라이버용 {#Notify-getTokenTTL_S__ul_ql5_vgc_1gb} |
[표 17. 매개변수]

{#Notify-getTokenTTL_S__table_mnj_xqb_zfb} {#Notify-getTokenTTL_S__table_nnj_xqb_zfb__entry__2}

| 유형 | 설명 |
|-|-|
| 정수 | 세션의 최대 길이(초)입니다. 기본값: 1800초 |
[표 18. 반환]

{#Notify-getTokenTTL_S__table_nnj_xqb_zfb}  
다음 예제에서는 이 메서드 및 관련 응답을 올바르게 호출하는 방법을 보여 줍니다. 또한 잘못된 드라이버가 전달되면 반환되는 내용도 보여줍니다.

    var owner = "TwilioDirect";  // Valid driver
    var ttl = SNC.Notify.getTokenTTL(owner);
    gs.info("Token TTL for " + owner + " --> " + ttl);
     
    owner = "Abcxyz";  // Invalid driver
    ttl = SNC.Notify.getTokenTTL(owner);
    // For an invalid driver, we throw NoSuchNotifyDriverException saying that Abcxyzdriver is not available
    // and return the default value of TTL
    gs.info("Token TTL for " + owner + " --> " + ttl); 

### 범위가 지정된 해당 항목 {#Notify-getTokenTTL_S__section_bgp_tk2_1gb}

범위가 지정된 애플리케이션에서 getTokenTTL() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - getAvailableClients()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-getTokenTTL_S "자동으로 시간 초과되기 전에 지정된 전화 통신 드라이버에 대해 클라이언트 세션이 활성 상태로 유지되는 최대 시간을 반환합니다.")를 사용합니다.

## 알림 - hasCapability(문자열 notifyPhoneNumber, 문자열 capability) {#ariaid-title11}

지정된 전화 번호에 지정된 기능이 있는지 확인합니다.
전화 번호와 연결된 전화 통신 드라이버에는 전화기의 모든 기능 목록이 포함되어 있습니다.  
주:  
기본 시스템에서 Notify JS 드라이버에는 기능으로 'show_speakers'만 있습니다. 이는 수정할 수 있습니다.
{#Notify-hasCapability_S_S__table_vsy_rdg_yfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림 전화 번호 | 문자열 | 지정된 역량을 확인할 전화 번호입니다. |
| 역량 | 문자열 | 탐지할 역량입니다. 문자열 텍스트는 전화기의 내용과 정확히 일치해야 합니다. |
[표 19. 매개변수]

{#Notify-hasCapability_S_S__table_vsy_rdg_yfb} {#Notify-hasCapability_S_S__table_wsy_rdg_yfb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 지정된 전화기에 지정된 기능이 있는지 여부를 나타내는 플래그입니다. * true: 전화기에 역량이 있습니다. * false: 전화에 역량이 없습니다. {#Notify-hasCapability_S_S__ul_ryg_y2g_yfb} |
[표 20. 반환]

{#Notify-hasCapability_S_S__table_wsy_rdg_yfb}  
이 예에서는 전화기에 특정 기능이 있는지 확인하는 방법을 보여줍니다.

    // Each driver has a defined set of capabilities.

    var capability = 'show_speakers';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // true
     
    capability = 'send_sms';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // false

### 범위가 지정된 해당 항목 {#Notify-hasCapability_S_S__section_bgp_tk2_1gb}

범위가 지정된 애플리케이션에서 hasCapability() 메서드를 사용하려면 해당 범위가 지정된 메서드인 [NotifyScoped - hasCapability()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-hasCapabilitiy_S_S "지정된 전화 번호에 지정된 기능이 있는지 확인합니다.")을 사용합니다.

## 알림 - 킥(GlideRecord 참가자) {#ariaid-title12}

현재 알림 전화 회의에서 지정된 호출자를 제거합니다.
{#r_N-kick_GlideRecord__table_asm_xdx_ls__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 참가자 | GlideRecord | 전화 회의에서 제거할 호출자의 알림 참가자 \[notify_participant\] 기록을 포함하는 GlideRecord 객체입니다. |
[표 21. 매개변수]

{#r_N-kick_GlideRecord__table_asm_xdx_ls} {#r_N-kick_GlideRecord__table_bsm_xdx_ls__entry__2}

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

{#r_N-kick_GlideRecord__table_bsm_xdx_ls}  
다음 예는 전화 회의에서 참가자를 제거하는 방법을 보여줍니다.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.kick(notifyParticipantGr);
    }

### 범위가 지정된 해당 항목 {#r_N-kick_GlideRecord__section_myh_bfd_1gb}

범위가 지정된 애플리케이션에서 kick() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - kick()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-kick_GR "현재 알림 전화 회의에서 지정된 호출자를 제거합니다.")을 사용합니다.

## 알림 - modifyCall(GlideRecord, callRecord, 알림 작업 알림 작업) {#ariaid-title13}

활성 알림 전화 통화에서 하나 이상의 작업을 수행합니다.
통화 대기열에 대기하거나 대기열에서 제거하거나, 텍스트 읽기, 오디오 재생, 착신 전환 등을 수행할 수 있는 작업을 수행할 수 있습니다. 사용자 지정 작업을 생성할 수도 있습니다. 지정된 호출에 적용할 모든 작업을 지정한 후에 modifyCall() 메서드를 호출합니다. 사용 가능한 작업에 대한 자세한 내용은 [NotifyAction](https://servicenow-prod.fluidtopics.net/M1nJbhr0BMohzIL74RALLg#c_NotifyActionApi "NotifyAction API를 사용하면 전화 통신 공급자에게 보낼 작업을 정의할 수 있습니다.") API 설명서를 참조하십시오.
{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 호출 기록 | GlideRecord | 작업을 적용할 콜의 알림 콜 \[notify_call\] 기록입니다. |
| 알림 작업 | 알림 작업 | 호출에서 수행할 하나 이상의 작업을 설명하는 NotifyAction 객체입니다. 하나 이상의 NotifyAction() 메서드를 호출하여 이 객체를 만듭니다. |
[표 23. 매개변수]

{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr} {#r_N-modifyCall_GR_NA__table_srh_gzn_wr__entry__2}

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

{#r_N-modifyCall_GR_NA__table_srh_gzn_wr}  
이 예시에서는 호출을 수정하는 방법을 보여줍니다.

    // get the most recent call record
    var callRecord = new GlideRecord('notify_call');
    callRecord.orderByDesc('sys_created_on');
    callRecord.query();
     
    if (callRecord.next()) {
        // instantiate notify action container class
        var notifyAction = new SNC.NotifyAction();
        // The call is already in progress. Now, we want to modify the call behavior by putting this call in a queue.
        // So, we add a queue action to queue the call
        notifyAction.addQueue('my fancy queue');
       
        // modify the call by passing in the above action, putting the call in a queue
        new SNC.Notify().modifyCall(callRecord, notifyAction);
    } else {
        gs.log('no such call record');
    }

### 범위가 지정된 해당 항목 {#r_N-modifyCall_GR_NA__section_a4l_chd_1gb}

범위가 지정된 애플리케이션에서 modifyCall() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - modifyCall()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-modifyCall_GR_NA "활성 알림 전화 통화에서 하나 이상의 활동을 수행합니다.")을 사용합니다.

## 알림 - 음소거(GlideRecord participantRecord) {#ariaid-title14}

지정된 전화 회의 참가자를 음소거합니다.
{#Notify-mute_GR__table_bch_xfg_yfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| participantRecord | GlideRecord | 참가자가 음소거할 수 있도록 notify_participant 테이블의 GlideRecord입니다. |
[표 25. 매개변수]

{#Notify-mute_GR__table_bch_xfg_yfb} {#Notify-mute_GR__table_cch_xfg_yfb__entry__2}

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

{#Notify-mute_GR__table_cch_xfg_yfb}  
다음 예는 호출자를 음소거하는 방법을 보여줍니다.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.mute(notifyParticipantGr);
    }

### 범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 mute() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - mute()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-mute_GR "지정된 전화 회의 참가자를 음소거합니다.")를 사용합니다.

## 알림 - queueCall(GlideRecord, callRecord) {#ariaid-title15}

지정된 호출을 큐에 넣습니다(보류 중).
dequeueCall() 메서드를 사용하여 대기 중인 호출을 다시 시작합니다.
{#r_N-queueCall_GlideRecord__table_uhl_mcy_js__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 호출 기록 | GlideRecord | 보류할 알림 통화 기록(notify_call 테이블)의 GlideRecord 객체입니다. |
[표 27. 매개변수]

{#r_N-queueCall_GlideRecord__table_uhl_mcy_js} {#r_N-queueCall_GlideRecord__table_vhl_mcy_js__entry__2}

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

{#r_N-queueCall_GlideRecord__table_vhl_mcy_js}  
다음 예는 호출을 (큐에서) 보류하는 방법을 보여줍니다.

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.queueCall(notifyCallGr);
    }

### 범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 queueCall() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - queueCall()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-queueCall_GR "지정된 호출을 큐에 넣습니다(보류 중).")을 사용합니다.

## 알림 - sendBulkSMS(문자열 notifyPhoneNumber, 배열 toPhoneNumbers, 문자열 messageBody, GlideRecord 소스) {#ariaid-title16}

지정된 SMS 메시지를 알림 클라이언트(전화 번호) 목록으로 보냅니다.
{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림 전화 번호 | 문자열 | SMS 메시지가 전송되는 알림 전화 번호입니다. |
| toPhoneNumbers | 문자열 배열 | SMS 메시지를 보낼 전화 번호의 쉼표로 구분된 목록입니다. 형식: E.164 |
| messageBody | 문자열 | 보낼 SMS 텍스트입니다. |
| 소스 | GlideRecord | 인시던트와 같이 이 SMS 메시지를 안내한 소스 기록입니다. |
[표 29. 매개변수]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb} {#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | null |
[표 30. 반환]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb}  
다음 예제에서는 대량 SMS 메시지를 보내는 방법을 보여줍니다.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get(active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendBulkSMS('+15413970605', ['+919885XXXXXX', '+919775XXXXXX'], 'Test automation message', incidentGr);
    }

### 범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 sendBulkSMS() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - sendBulkSMS()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-sendBulkSMS_NPN_S_S_GR "지정된 SMS 메시지를 알림 클라이언트(전화 번호) 목록으로 보냅니다.")를 사용합니다.

## 알림 - sendSMS(문자열 notifyPhoneNumber, 문자열 toPhoneNumber, 문자열 messageBody, GlideRecord 소스) {#ariaid-title17}

E.164 호환 전화 번호로 SMS 문자 메시지를 보냅니다.
이 메서드는 알림 메시지 \[notify_message\] 테이블에 새 레코드를 만들고 소스 레코드와 연결합니다.
{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 알림 전화 번호 | 문자열 | SMS 메시지가 전송되는 알림 전화 번호입니다. |
| toPhoneNumber | 문자열 | SMS 메시지를 보낼 E.164 호환 전화 번호입니다. |
| messageBody | 문자열 | SMS 텍스트 메시지의 본문입니다. |
| 소스 | GlideRecord | 인시던트와 같이 이 SMS 메시지를 안내한 소스 기록입니다. |
[표 31. 매개변수]

{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr} {#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 고유 메시지 SID입니다. 알림 메시지 \[notify_message\] 기록에 message_id로 저장됩니다. |
[표 32. 반환]

{#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr}  
다음 예시에서는 SMS 메시지를 보내는 방법을 보여줍니다.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get('active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendSMS('+15413970605', '+919885XXXXXX', 'Test automation message', incidentGr);
    }

### 범위가 지정된 해당 항목 {#r_N-sendSMS_NPN_S_S_GR__section_kby_cyc_1gb}

범위가 지정된 애플리케이션에서 sendSMS() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [NotifyScoped - sendSMS()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-sendSMS_NPN_S_S_GR "E.164 호환 전화 번호로 SMS 문자 메시지를 보냅니다.")를 사용합니다.

## 알림 - 음소거 해제(GlideRecord participantRecord) {#ariaid-title18}

지정된 전화 회의 참가자의 음소거를 해제합니다.
{#Notify-unmute_GR__table_v1w_p3g_yfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| participantRecord | GlideRecord | 참가자가 음소거를 해제할 수 있도록 notify_participant 테이블의 GlideRecord입니다. |
[표 33. 매개변수]

{#Notify-unmute_GR__table_v1w_p3g_yfb} {#Notify-unmute_GR__table_w1w_p3g_yfb__entry__2}

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

{#Notify-unmute_GR__table_w1w_p3g_yfb}  
다음 예는 호출자의 음소거를 해제하는 방법을 보여줍니다.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.unmute(notifyParticipantGr);
    }

### 범위가 지정된 해당 항목 {#Notify-unmute_GR__section_a4l_chd_1gb}

범위가 지정된 애플리케이션에서 unmute() 메서드를 사용하려면 해당 범위가 지정된 메서드인 [NotifyScoped - unmute()](https://servicenow-prod.fluidtopics.net/uQHRm1QkpFFPiIQWprAwzA#NotifyScoped-unmute_GR "지정된 전화 회의 참가자의 음소거를 해제합니다.")를 사용합니다.