NotifyPhoneNumber - Global

The NotifyPhoneNumber API allows you to query information about a Notify phone number.

Access the global NotifyPhoneNumber class and its associated methods in the SNC namespace.

NotifyPhoneNumber - getDialCode()

Returns the international dialing code for a Notify phone number.

Table 1. Parameters

Name	Type	Description
None

Table 2. Returns

Type	Description
String	International phone code for a country.

This example shows how to obtain the dial code for a phone number.

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());
}

Scoped equivalent

To use the getDialCode() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - getDialCode().

NotifyPhoneNumber - getID()

Returns the ID of this phone number as defined by the telephony provider.

Table 3. Parameters

Name	Type	Description
None

Table 4. Returns

Type	Description
String	Identifier of the number within the telephony provider.

This example shows how to obtain the unique identifier for a phone number.

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());
}

Scoped equivalent

To use the getID() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - getID().

NotifyPhoneNumber - getNumber()

Returns the numerical phone number for the current Notify caller.

Table 5. Parameters

Name	Type	Description
None

Table 6. Returns

Type	Description
String	E.164-compliant phone number.

This example shows how to obtain a Notify caller's phone number.

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());
}

Scoped equivalent

To use the getNumber() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - getNumber().

NotifyPhoneNumber - getOwner()

Returns the telephony provider associated with this phone number.

Table 7. Parameters

Name	Type	Description
None

Table 8. Returns

Type	Description
String	Telephony provider associated with the number: Twilio.

This example shows how to obtain the telephony provide that owns the specified phone number.

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());
}

Scoped equivalent

To use the getOwner() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - getOwner().

NotifyPhoneNumber - getTerritory()

Returns the country associated with the phone number.

Table 9. Parameters

Name	Type	Description
None

Table 10. Returns

Type	Description
String	Name of the country to which the phone number belongs.

This example shows how to obtain the country of a Notify caller.

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());
}

Scoped equivalent

To use the getTerritory() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - getTerritory().

NotifyPhoneNumber - isShortCode()

Determines whether the current Notify phone number is a short code.

Table 11. Parameters

Name	Type	Description
None

Table 12. Returns

Type	Description
Boolean	Flag that indicates whether the current Notify phone number is a short code. true: phone number is a short code. false: phone number is not a short code.

This example shows how to check if the current Notify phone number is a short code.

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());
  }

NotifyPhoneNumber - supportsConferenceCall()

Determines if the Notify phone number supports conference calling.

Table 13. Parameters

Name	Type	Description
None

Table 14. Returns

Type	Description
Boolean	Value that indicates whether the Notify phone number supports conference calling. true: phone number does support conference calling false: phone number does not support conference calling

This example shows how to determine if a Notify caller supports conference calls.

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());
}

Scoped equivalent

To use the supportsConferenceCall() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - supportsConferenceCall().

NotifyPhoneNumber - supportsIncomingPhoneCall()

Determines if the Notify phone number supports receiving phone calls.

Table 15. Parameters

Name	Type	Description
None

Table 16. Returns

Type	Description
Boolean	Value that indicates whether the Notify phone number supports incoming phone calls. true: phone number does support incoming phone calls false: phone number does not support incoming phone calls

This example shows how to determine if a Notify caller can receive incoming phone calls.

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());
}

Scoped equivalent

To use the supportsIncomingPhoneCall() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - supportsIncomingPhoneCall().

NotifyPhoneNumber - supportsIncomingSMS()

Determines if the Notify phone number supports receiving SMS messages.

Table 17. Parameters

Name	Type	Description
None

Table 18. Returns

Type	Description
Boolean	Value that indicates whether the Notify phone number supports receiving incoming MMS messages. true: phone number does support receiving incoming MMS messages false: phone number does not support receiving incoming MMS messages

This example shows how to determine if a Notify caller can receive incoming SMS messages.

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());
}

Scoped equivalent

To use the supportsIncomingSMS() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - supportsIncomingSMS().

NotifyPhoneNumber - supportsOutgoingPhoneCall()

Determines if the Notify phone number supports initiating phone calls.

Table 19. Parameters

Name	Type	Description
None

Table 20. Returns

Type	Description
Boolean	Value that indicates whether the Notify phone number supports initiating outgoing phone calls. true: phone number does support initiating outgoing phone calls false: phone number does not support initiating outgoing phone calls

This example shows how to determine if a Notify caller can make outgoing phone calls.

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());
}

Scoped equivalent

To use the supportsOutgoingPhoneCall() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - supportsOutgoingPhoneCall().

NotifyPhoneNumber - supportsOutgoingSMS()

Determines if the Notify phone number supports sending SMS messages.

Table 21. Parameters

Name	Type	Description
None

Table 22. Returns

Type	Description
Boolean	Value that indicates whether the Notify phone number supports sending SMS messages. true: phone number does support sending SMS messages false: phone number does not support sending SMS messages

This example shows how to determine if a Notify caller can initiate outgoing SMS messages.

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());
}

Scoped equivalent

To use the supportsOutgoingSMS() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - supportsOutgoingSMS().

NotifyPhoneNumber - supportsRecording()

Determines if the Notify phone number supports recording phone calls.

Table 23. Parameters

Name	Type	Description
None

Table 24. Returns

Type	Description
Boolean	Value that indicates whether the Notify phone number supports recording phone calls. true: phone number does support recording phone calls false: phone number does not support recording phone calls

This example shows how to determine if a Notify caller can record calls.

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());
}

Scoped equivalent

To use the supportsRecording() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - supportsRecording().

NotifyPhoneNumber - supportsWebRTC()

Determines if the Notify phone number supports calls to a browser, such as in a WebRTC implementation.

Table 25. Parameters

Name	Type	Description
None

Table 26. Returns

Type	Description
Boolean	Value that indicates whether the Notify phone number supports calls to a browser. true: phone number does support calls to a browser false: phone number does not support calls to a browser

This example shows how to determine if a Notify caller can initiate/accept browser-to-browser calls.

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());
}

Scoped equivalent

To use the supportsWebRTC() method in a scoped application, use the corresponding scoped method: Scoped NotifyPhoneNumber - supportsWebRTC().