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


---

# NotifyPhoneNumber - 범위 지정됨

# NotifyPhoneNumber - 범위 지정됨 {#ariaid-title1}

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

NotifyPhoneNumber API를 사용하면 알림 전화 번호에 대한 정보를 쿼리할 수 있습니다.

`sn_notify` 네임스페이스에서 범위가 지정된 NotifyPhoneNumber API 및 관련 메서드를 실행합니다.

## 범위가 지정된 알림 전화 번호 - getDialCode() {#ariaid-title2}

알림 전화 번호의 국제 전화 코드를 반환합니다.
{#NPNScoped-getDialCode__table_uvw_tv5_bgb__entry__3}

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

{#NPNScoped-getDialCode__table_uvw_tv5_bgb} {#NPNScoped-getDialCode__table_vvw_tv5_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 국가의 국제 전화 코드입니다. |
[표 2. 반환]

{#NPNScoped-getDialCode__table_vvw_tv5_bgb}  
이 예시에서는 전화 번호의 다이얼 코드를 가져오는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.getDialCode());
    }

## 범위가 지정된 알림 전화 번호 - getID() {#ariaid-title3}

전화 통신 공급자가 정의한 이 전화 번호의 ID를 반환합니다.
{#NPNScoped-getID__table_hkv_ny5_bgb__entry__3}

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

{#NPNScoped-getID__table_hkv_ny5_bgb} {#NPNScoped-getID__table_ikv_ny5_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 전화 통신 공급자 내의 번호 식별자입니다. |
[표 4. 반환]

{#NPNScoped-getID__table_ikv_ny5_bgb}  
이 예시에서는 전화 번호의 고유 식별자를 가져오는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.getID());
    }

## 범위가 지정된 알림 전화 번호 - getNumber() {#ariaid-title4}

현재 알림 발신자의 전화 번호를 반환합니다.
{#NPNScoped-getNumber__table_dgp_m1v_bgb__entry__3}

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

{#NPNScoped-getNumber__table_dgp_m1v_bgb} {#NPNScoped-getNumber__table_egp_m1v_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | E.164 호환 전화 번호입니다. |
[표 6. 반환]

{#NPNScoped-getNumber__table_egp_m1v_bgb}  
이 예는 알림 발신자의 전화 번호를 가져오는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.getNumber());
    }

## 범위가 지정된 알림 번호 - getOwner() {#ariaid-title5}

이 전화 번호와 연결된 전화 통신 제공자를 반환합니다.
{#NPNScoped-getOwner__table_scw_2bv_bgb__entry__3}

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

{#NPNScoped-getOwner__table_scw_2bv_bgb} {#NPNScoped-getOwner__table_tcw_2bv_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 번호와 연결된 전화 통신 제공자: Twilio. |
[표 8. 반환]

{#NPNScoped-getOwner__table_tcw_2bv_bgb}  
이 예시에서는 지정된 전화 번호를 소유한 전화 통신 공급자를 가져오는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.getOwner());
    }

## 범위가 지정된 알림 전화 번호 - getTerritory() {#ariaid-title6}

전화 번호와 연결된 국가를 반환합니다.
{#NPNScoped-getTerritory__table_e1q_32v_bgb__entry__3}

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

{#NPNScoped-getTerritory__table_e1q_32v_bgb} {#NPNScoped-getTerritory__table_f1q_32v_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 전화 번호가 속한 국가의 이름입니다. |
[표 10. 반환]

{#NPNScoped-getTerritory__table_f1q_32v_bgb}  
이 예는 알림 호출자의 국가를 가져오는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.getTerritory());
    }

## 범위가 지정된 알림 전화 번호 - supportsConferenceCall() {#ariaid-title7}

알림 전화 번호가 컨퍼런스 회의를 지원하는지 여부를 결정합니다.
{#NPNScoped-supportsConferenceCall__table_rfg_jmv_bgb__entry__3}

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

{#NPNScoped-supportsConferenceCall__table_rfg_jmv_bgb} {#NPNScoped-supportsConferenceCall__table_sfg_jmv_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 알림 전화 번호가 컨퍼런스 회의를 지원하는지 여부를 나타내는 값입니다. * 예: 전화 번호가 컨퍼런스 회의를 지원합니다. * false: 전화 번호가 컨퍼런스 회의를 지원하지 않습니다. {#NPNScoped-supportsConferenceCall__ul_xkc_qmv_bgb} |
[표 12. 반환]

{#NPNScoped-supportsConferenceCall__table_sfg_jmv_bgb}  
이 예는 알림 호출자가 컨퍼런스 회의를 지원하는지 여부를 확인하는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.supportsConferenceCall());
    }

## 범위가 지정된 알림 전화 번호 - supportsIncomingPhoneCall() {#ariaid-title8}

알림 전화 번호가 전화 통화 수신을 지원하는지 여부를 결정합니다.
{#NPNScoped-supportsIncomingPhoneCall__table_wlt_lnv_bgb__entry__3}

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

{#NPNScoped-supportsIncomingPhoneCall__table_wlt_lnv_bgb} {#NPNScoped-supportsIncomingPhoneCall__table_xlt_lnv_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 알림 전화 번호가 수신 전화 통화를 지원하는지 여부를 나타내는 값입니다. * 예: 전화 번호가 수신 전화 통화를 지원합니다. * false: 전화 번호가 수신 전화 통화를 지원하지 않습니다. {#NPNScoped-supportsIncomingPhoneCall__ul_xkc_qmv_bgb} |
[표 14. 반환]

{#NPNScoped-supportsIncomingPhoneCall__table_xlt_lnv_bgb}  
이 예시에서는 알림 발신자가 수신 전화를 받을 수 있는지 확인하는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.supportsIncomingPhoneCall());
    }

## 범위가 지정된 알림 전화 번호 - supportsIncomingSMS() {#ariaid-title9}

알림 전화 번호가 SMS 메시지 수신을 지원하는지 여부를 결정합니다.
{#NPNScoped-supportsIncomingSMS__table_lxf_x4v_bgb__entry__3}

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

{#NPNScoped-supportsIncomingSMS__table_lxf_x4v_bgb} {#NPNScoped-supportsIncomingSMS__table_mxf_x4v_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 알림 전화 번호가 수신 SMS 메시지를 지원하는지 여부를 나타내는 값입니다. * 예: 전화 번호가 수신 SMS 메시지를 지원합니다. * false: 전화 번호가 수신 SMS 메시지를 지원하지 않습니다. {#NPNScoped-supportsIncomingSMS__ul_xkc_qmv_bgb} |
[표 16. 반환]

{#NPNScoped-supportsIncomingSMS__table_mxf_x4v_bgb}  
이 예시에서는 알림 호출자가 수신 SMS 메시지를 받을 수 있는지 확인하는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.supportsIncomingSMS());
    }

## 범위가 지정된 알림 PhoneNumber - supportsOutgoingPhoneCall() {#ariaid-title10}

알림 전화 번호가 전화 통화 시작을 지원하는지 여부를 결정합니다.
{#NPNScoped-supportsOutgoingPhoneCall__table_vkq_bqv_bgb__entry__3}

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

{#NPNScoped-supportsOutgoingPhoneCall__table_vkq_bqv_bgb} {#NPNScoped-supportsOutgoingPhoneCall__table_wkq_bqv_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 알림 전화 번호가 발신 전화 통화 시작을 지원하는지 여부를 나타내는 값입니다. * 예: 전화 번호가 발신 전화 통화 시작을 지원합니다. * false: 전화 번호가 발신 전화 통화 시작을 지원하지 않습니다. {#NPNScoped-supportsOutgoingPhoneCall__ul_xkc_qmv_bgb} |
[표 18. 반환]

{#NPNScoped-supportsOutgoingPhoneCall__table_wkq_bqv_bgb}  
이 예는 알림 호출자가 발신 전화를 걸 수 있는지 여부를 확인하는 방법을 보여줍니다.

    var numbers = sn_notfy.Notify.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.supportsOutgoingPhoneCall());
    }

## 범위가 지정된 알림 전화 번호 - supportsOutgoingSMS() {#ariaid-title11}

알림 전화 번호가 SMS 메시지 전송을 지원하는지 여부를 결정합니다.
{#NPNScoped-supportsOutgoingSMS__table_pct_srv_bgb__entry__3}

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

{#NPNScoped-supportsOutgoingSMS__table_pct_srv_bgb} {#NPNScoped-supportsOutgoingSMS__table_qct_srv_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 알림 전화 번호가 SMS 메시지 전송을 지원하는지 여부를 나타내는 값입니다. * 예: 전화 번호가 SMS 메시지 전송을 지원합니다. * 아니오: 전화 번호가 SMS 메시지 전송을 지원하지 않습니다. {#NPNScoped-supportsOutgoingSMS__ul_xkc_qmv_bgb} |
[표 20. 반환]

{#NPNScoped-supportsOutgoingSMS__table_qct_srv_bgb}  
이 예는 알림 호출자가 발신 SMS 메시지를 시작할 수 있는지 여부를 확인하는 방법을 보여줍니다.

    var numbers = sn_notify.NotifyScoped.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.supportsOutgoingSMS());
    }

## 범위가 지정된 알림 전화 번호 - supportsRecording() {#ariaid-title12}

알림 전화 번호가 전화 통화 녹음을 지원하는지 여부를 결정합니다.
{#NPNScoped-supportsRecording__table_qxv_5sv_bgb__entry__3}

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

{#NPNScoped-supportsRecording__table_qxv_5sv_bgb} {#NPNScoped-supportsRecording__table_rxv_5sv_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 알림 전화 번호가 전화 통화 녹음을 지원하는지 여부를 나타내는 값입니다. * 예: 전화번호가 통화 녹음을 지원합니다. * 아니오: 전화 번호가 전화 통화 녹음을 지원하지 않습니다. {#NPNScoped-supportsRecording__ul_xkc_qmv_bgb} |
[표 22. 반환]

{#NPNScoped-supportsRecording__table_rxv_5sv_bgb}  
이 예시에서는 알림 호출자가 통화를 녹음할 수 있는지 확인하는 방법을 보여줍니다.

    var numbers = sn_notify.Notify.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.supportsRecording());
    }

## 범위가 지정된 알림 전화 번호 - supportsWebRTC() {#ariaid-title13}

알림 전화 번호가 WebRTC 구현과 같은 브라우저로의 호출을 지원하는지 여부를 결정합니다.
{#NPNScoped-supportsWebRTC__table_knk_vtv_bgb__entry__3}

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

{#NPNScoped-supportsWebRTC__table_knk_vtv_bgb} {#NPNScoped-supportsWebRTC__table_lnk_vtv_bgb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 알림 전화 번호가 WebRTC(브라우저 간) 통화를 지원하는지 여부를 나타내는 값입니다. * true: 전화 번호가 WebRTC(브라우저 간) 통화를 지원합니다. * 아니오: 전화 번호가 WebRTC(브라우저 간) 통화를 지원하지 않습니다. {#NPNScoped-supportsWebRTC__ul_xkc_qmv_bgb} |
[표 24. 반환]

{#NPNScoped-supportsWebRTC__table_lnk_vtv_bgb}  
이 예는 알림 호출자가 브라우저 간 호출을 시작/수락할 수 있는지 여부를 확인하는 방법을 보여줍니다.

    var numbers = sn_notify.Notify.getPhoneNumbers();
     
    // Here numbers is of type List
    if (numbers.size() > 0) {
       var number = numbers.get(0);
     
       // Here number is of type NotifyPhoneNumber
      gs.info(number.supportsWebRTC());
    }