RingCentral

This PBXLink uses the RingCentral API for Account User Settings in order to update extensions with first name, last name, and other extension changes.

Mailbox numbers can either be configured using the RingCentral extension number or the RingCentral telephone number. By default the system will attempt to match the telephone number with a mailbox number otherwise it will attempt to find a mailbox based on the extension. When it finds a match, the unique extension ID associated with RingCentral will be stored in the mailbox. This ID cannot be modified or viewed.

Supported

  • Extension or telephone number based.
  • First and last name change.
  • Transfers
  • Wakeup calls
  • Room Clean/Dirt Status
  • Busy / RNA calls (guest voice mail)
  • Do not disturb on/off
  • Class of service to restrict/un-restrict long distance/international calls
  • DV2000 7.00.10 or above.
  • DuVoice Hospitality PBXLink application from RingCentral.

RingCentral enforces strict rate limits in order to provide better service among it's clients. Due to these rate limits changes are limited to 40 per-minute.

The public application has the following application permissions and only accounts associated with the account/password configured can be changed.

  • Contacts
  • Read Accounts
  • Edit Extensions
  • SMS

The typical configuration would be to configure all DV2000 mailboxes with the extension number associated with a room. Optionally the extension of the mailbox can either be set as the extension number or the telephone number. Either should work equally well for guest wakeup calls.

Upon startup and when scheduled will read all the telephone numbers configured under the RingCentral account. If an extension number has been assigned to the telephone number the DV2000 will attempt to match it with a mailbox number in order to perform name changes.

FieldDescription
Server URL Enter the URL for RingCentral for communications. Default is https://platform.ringcentral.com.
JWT Credential Enter your unique JWT credential for this site. This must be done from your developer console at https://developers.ringcentral.com/my-account.html

The system can optionally set some user account fields to settings stored in the DuVoice.

Each of these fields can be changed to any of the following options.

Disabled Field will not be set.
Tenant name Name of the tenant the extension is associated with.
Checked in/out state State of the room, showing if it's checked in or out along with the date.
Mailbox description Description field located in the mailbox.
Mailbox room ID Room ID field located in the mailbox.
FieldDescription
Set department Set the user account department field.
Set company Set the user account company field.
Set job title Set the user account job tile field.
FieldDescription
Retries Number of attempts to make changes on PBX before giving up. Default: 3
Interval (seconds) Number of seconds to wait between retries. Default: 60.
Refresh cache Number of minutes between refreshing cache of extensions. Always refreshed on startup. Default: 720.
FieldDescription
Enable debug All communication packets will be logged. WARNING: This will make very large log files and should only be used during testing. The system doesn't need to be shutdown for this to take effect.
  • Last modified: 2024/01/25 11:37
  • by admin