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.

Example

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.

Example

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.

Example

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.

Example

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.

Example

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.

Example

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

Example

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

Example

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

Example

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

Example

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

Example

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

Example

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

Example

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().