RingCentral

  • Forward to DV2000 voicemail
  • Auto login to a mailbox
  • Wakeup calls
  • Extension or telephone number based
  • First and last name change
  • Transfers
  • Wakeup calls
  • Room Clean/Dirt Status
  • Set DND from PMS
  • Room telephone restrict/un-restrict using roles
  • DuVoice 7.2.36 or above.
  • One user account per-DV2000 line.
  • Call Queue for DV2000.
  • JWT credential from RingCentral.
  • DuVoice RingCentral PBXLink Application. Installed via RingCentral.
    • Permissions
      • ReadAccounts
        Used to match DV2000 mailboxes to RingCentral extensions and telephone numbers.
      • EditExtensions
        Used to set the extension fields first name, last name and other optional settings.
      • EditPresence
        Used to set the DND status of an extension.
      • RoleManagement
        Used to set the hospitality group used for restricting calls.
  • Guest phones should be programmed to call the full extension number of the Call Queue or their own extension number for voicemail access.
  • MWI lights must be sent directly to the phone. This is a limitation of RingCentral not supporting 3rd Party SIP Notify.

RingCentral Configuration

Due to the fact the DV2000 integration uses queues for call forwarding each line of the DV2000 must have it's own unique user account and number. These settings should be applied to each user account associated with the DV2000. Phone numbers and extensions have been removed from the screen shots.

For account information click on Existing Phone then Set Up and Provision then Set up manually using SIP. You will need the following for DV2000 configuration:

  • Outbound Proxy address.
  • Outbound Proxy Port.
  • User Name
  • Password
  • Authorization ID

Create a call queue for the DV2000 and add all the extensions of the DV2000 as members.

Set the wait settings which best fit your installation. In this example calls are directed to the operator when all lines are busy.

  • Call information displayed
    Choose Phone Number for the first choice and None for the second.

All guest extensions should be set to wait for 5 rings before forwarding and be forwarded to the queue defined for the DV2000.

RingCentral JWT credential help

Creating Ring Central JWT Credentials for the DuVoice hospitality application.

Create a virtual User

On the Ring Central Admin Portal Home Screen

  1. Select Add User
  2. Under User Type select Video Pro User
  3. Add email (Note: this needs to be a unique email a tech can log into and to finish setup)
  4. Enter First Name: DuVoice Last Name: JWT
  5. Site: Select the organization (If more than one, group with hotel room users)
  6. Select Next
  7. Setup Option: Send Invite
  8. Edit Role: Select Super User
  9. Using the email that was sent select the Set Up Account button
  10. Enter a password (this email and password will be used for creating credentials below)
Create JWT Credentials for that User
  1. Go to “Home”
  2. On right select Developer Portal
  3. On the https://developers.ringcentral.com/login page login in using new DuVoice JWT user email and password.
  4. On the Welcome screen select SKIP
  5. On upper right your will see DuVoice with a drop down arrow and select Credentials
  6. Select Create JWT
  7. For the Label enter DuVoice JWT
  8. For the Environment select Production
  9. For Apps Permitted select: All apps created by developers within my organization
  10. Leave Expiration Date blank
  11. Select Create JWT (lower left)
  12. Copy the JWT onto the clipboard to be pasted into the DuVoice system

DV2000 Configuration

  • IP or DNS Name
    Enter the DNS name of RingCentral SIP. Default is sip.ringcentral.com
  • Port
    Enter 5060.
  • IP or DNS Name
    Enter the proxy address assigned to the DV2000 lines. Example: SIP20.ringcentral.com
  • Port
    Enter the port number of the proxy server. Default is typically 5090.
  • Realm
    Enter sip.ringcentral.com.
  • Register accounts using
    PBX address.
  • Call Progress
    MUST BE SET TO Audio tones after CONNECT event otherwise all callouts will fail.

  • Register
    Check.
  • Extension
    Enter the full telephone number of the telephone number. This cannot be the short extension or the full extension value.
  • Account
    Each user has a unique SIP account number. This is listed as the Authorization ID in the RingCentral Configuration.
  • Password
    Enter the unique password for the SIP account.

Double click on line one in System Configuration and enter the full extension number of the Call Queue assigned to the DV2000. This only needs to be entered on a single line.

  • Hunt group extension is a member of
    Enter the Call Queue full extension number here.

Because the call information changes depending on how a call is directed to the DV2000 mailboxes should be setup in one of following ways. Both require a special call handling item be added. RingCentral will typically never send the extension number of the user and is almost always the full extension or external DID number which includes a 1 plus the area code.

Create mailboxes using the external telephone number. For example: 14258899790 and set the extension number to the users full extension number. In this case calls forwarded to the voicemail will find the number based on the mailbox number.

Create mailboxes using the full extension number of the user and set the office extension number to the full external number. In this case calls forwarded to to the voicemail must perform a extension search while direct calls from the user will find a match based on the mailbox number.

A call routing item should be added to perform an extension search based on Caller ID.

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.

  • First and last name change.
  • 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 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 Your RingCentral credentials for accessing your account.

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.
More Setup Info: View
  • Last modified: 2024/04/17 18:59
  • by jh