NotifyPhoneNumber - 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기12분

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

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

    알림 전화 번호 - getDialCode()

    알림 전화 번호의 국제 전화 번호를 반환합니다.

    표 1. 매개변수
    이름 유형 설명
    없음
    표 2. 반환
    유형 설명
    문자열 국가의 국제 전화 코드입니다.

    이 예에서는 전화 번호에 대한 다이얼 코드를 가져오는 방법을 보여줍니다.

    var numbers = SNC.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.getDialCode());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getDialCode() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 범위가 지정된 NotifyPhoneNumber - getDialCode()를 사용합니다.

    알림 전화 번호 - getID()

    전화 통신 공급자가 정의한 이 전화 번호의 ID를 반환합니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    문자열 전화 통신 공급자 내의 번호 식별자입니다.

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

    var numbers = SNC.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());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getID() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 Scoped NotifyPhoneNumber - getID()를 사용합니다.

    알림 전화 번호 - getNumber()

    현재 알림 호출자의 숫자 전화 번호를 반환합니다.

    표 5. 매개변수
    이름 유형 설명
    없음
    표 6. 반환
    유형 설명
    문자열 E.164 호환 전화 번호.

    이 예시에서는 알림 발신자의 전화 번호를 얻는 방법을 보여줍니다.

    var numbers = SNC.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.getNumber());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getNumber() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 Scoped NotifyPhoneNumber - getNumber()를 사용합니다.

    알림 전화 번호 - getOwner()

    이 전화 번호와 연결된 전화 통신 공급자를 반환합니다.

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 번호와 연결된 전화 통신 제공자(Twilio)입니다.

    이 예에서는 지정된 전화 번호를 소유하는 전화 통신 공급자를 가져오는 방법을 보여 줍니다.

    var numbers = SNC.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.getOwner());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getOwner() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 범위가 지정된 NotifyPhoneNumber - getOwner()를 사용합니다.

    알림 전화 번호 - getTerritory()

    전화 번호와 연결된 국가를 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 전화 번호가 속한 국가의 이름입니다.

    이 예는 알림 호출자의 국가를 가져오는 방법을 보여줍니다.

    var numbers = SNC.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.getTerritory());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getTerritory() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 Scoped NotifyPhoneNumber - getTerritory()를 사용합니다.

    알림 전화 번호 - isShortCode()

    현재 알림 전화 번호가 약식 코드인지 여부를 확인합니다.

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    부울 현재 알림 전화 번호가 약식 코드인지 여부를 나타내는 플래그입니다.
    • true: 전화번호가 짧은 코드입니다.
    • false: 전화번호가 단축 코드가 아닙니다.

    이 예시에서는 현재 알림 전화 번호가 짧은 코드인지 확인하는 방법을 보여줍니다.

    GlideRecord notifyNumber = new GlideRecord(TABLE_NOTIFY_NUMBER);
notifyNumber.query(COL_NUMBER, notifyPhoneNumber.getNumber());

if (!notifyNumber.next()) {
  notifyNumber.initialize();
  notifyNumber.setValue(COL_OWNER, notifyPhoneNumber.getOwner());
  if (notifyPhoneNumber.isShortCode()) {
    notifyNumber.setValue(COL_SHORT_CODE, notifyPhoneNumber.getNumber());
  } else {
    notifyNumber.setValue(COL_PHONE_NUMBER, notifyPhoneNumber.getNumber());
  }

    알림 전화 번호 - supportsConferenceCall()

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

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    부울 알림 전화 번호가 컨퍼런스 회의를 지원하는지 여부를 나타내는 값입니다.
    • true: 전화 번호가 전화 회의를 지원합니다.
    • False: 전화 번호가 컨퍼런스 회의를 지원하지 않습니다.

    이 예시에서는 알림 호출자가 컨퍼런스 회의를 지원하는지 여부를 확인하는 방법을 보여줍니다.

    var numbers = SNC.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.supportsConferenceCall());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 supportsConferenceCall() 메서드를 사용하려면, 해당하는 범위가 지정된 메서드인 범위가 지정된 NotifyPhoneNumber - supportsConferenceCall()을 사용합니다.

    알림 전화 번호 - supportsIncomingPhoneCall ()

    알림 전화 번호가 전화 통화를 받을 수 있도록 지원하는지 여부를 결정합니다.

    표 15. 매개변수
    이름 유형 설명
    없음
    표 16. 반환
    유형 설명
    부울 알림 전화 번호가 수신 전화 통화를 지원하는지 여부를 나타내는 값입니다.
    • True: 전화 번호가 수신 전화 통화를 지원합니다.
    • false: 전화번호가 수신 전화를 지원하지 않음

    이 예시에서는 알림 호출자가 수신 전화를 받을 수 있는지 여부를 확인하는 방법을 보여줍니다.

    var numbers = SNC.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.supportsIncomingPhoneCall());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 supportsIncomingPhoneCall() 메서드를 사용하려면 해당하는 범위가 지정된 메서드를 사용합니다. 범위가 지정된 NotifyPhoneNumber - supportsIncomingPhoneCall().

    알림 전화 번호 - supportsIncomingSMS ()

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

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    부울 알림 전화 번호에서 수신 MMS 메시지 수신을 지원하는지 여부를 나타내는 값입니다.
    • true: 전화번호가 수신 MMS 메시지 수신을 지원합니다.
    • false: 전화번호에서 수신 MMS 메시지 수신을 지원하지 않음

    이 예시에서는 알림 호출자가 수신 SMS 메시지를 수신할 수 있는지 여부를 결정하는 방법을 보여줍니다.

    var numbers = SNC.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.supportsIncomingSMS());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 supportsIncomingSMS() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 범위가 지정된 NotifyPhoneNumber - supportsIncomingSMS()를 사용합니다.

    NotifyPhoneNumber - supportsOutgoingPhoneCall()

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

    표 19. 매개변수
    이름 유형 설명
    없음
    표 20. 반환
    유형 설명
    부울 알림 전화 번호가 발신 전화 통화 시작을 지원하는지 여부를 나타내는 값입니다.
    • true: 전화 번호는 발신 전화 통화 시작을 지원합니다.
    • false: 전화 번호가 발신 전화 통화 시작을 지원하지 않습니다.

    이 예시에서는 알림 호출자가 전화를 걸 수 있는지 여부를 확인하는 방법을 보여줍니다.

    var numbers = SNC.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());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 supportsOutgoingPhoneCall() 메서드를 사용하려면 해당하는 범위가 지정된 메서드를 사용합니다. 범위가 지정된 NotifyPhoneNumber - supportsOutgoingPhoneCall()을 사용합니다.

    NotifyPhoneNumber - SupportsOutgoingSMS()

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

    표 21. 매개변수
    이름 유형 설명
    없음
    표 22. 반환
    유형 설명
    부울 알림 전화 번호에서 SMS 메시지 전송을 지원하는지 여부를 나타내는 값입니다.
    • true: 전화번호에서 SMS 메시지 전송을 지원합니다.
    • false: 전화번호에서 SMS 메시지 전송을 지원하지 않음

    이 예제에서는 알림 호출자가 발신 SMS 메시지를 시작할 수 있는지 여부를 결정하는 방법을 보여줍니다.

    var numbers = SNC.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.supportsOutgoingSMS());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 supportsOutgoingSMS() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 Scoped NotifyPhoneNumber - supportsOutgoingSMS()를 사용합니다.

    알림 전화 번호 - supportsRecording()

    알림 전화 번호가 전화 통화 녹음을 지원하는지 확인합니다.

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    부울 알림 전화 번호에서 전화 통화 기록을 지원하는지 여부를 나타내는 값입니다.
    • True: 전화번호는 통화 녹음을 지원합니다.
    • False: 전화번호에서 통화 녹음을 지원하지 않음

    이 예제에서는 Notify 호출자가 통화를 녹음할 수 있는지 확인하는 방법을 보여 줍니다.

    var numbers = SNC.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());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 supportsRecording() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 범위가 지정된 NotifyPhoneNumber - supportsRecording()을 사용합니다.

    NotifyPhoneNumber - SupportsWebRTC()

    알림 전화 번호가 WebRTC 구현에서와 같이 브라우저에 대한 호출을 지원하는지 여부를 결정합니다.

    표 25. 매개변수
    이름 유형 설명
    없음
    표 26. 반환
    유형 설명
    부울 알림 전화 번호가 브라우저에 대한 호출을 지원하는지 여부를 나타내는 값입니다.
    • true: 전화번호는 브라우저 호출을 지원합니다.
    • false: 전화 번호가 브라우저 호출을 지원하지 않음

    이 예제에서는 Notify 호출자가 브라우저 간 호출을 시작/수락할 수 있는지 여부를 확인하는 방법을 보여 줍니다.

    var numbers = SNC.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());
}

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 supportsWebRTC() 메서드를 사용하려면 해당 범위가 지정된 메서드인 Scoped NotifyPhoneNumber - supportsWebRTC()를 사용합니다.