RingCentral
Features
- 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
Requirements
- 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.
Issues
- 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
DV2000 Lines
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.
User Details
Phones & Numbers
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
Screening, Greeting & Hold Music
Call Handling
DV2000 Call Queue
Call Handling & Members
Wait Settings
Set the wait settings which best fit your installation. In this example calls are directed to the operator when all lines are busy.
Display Settings
Guest Extensions
All guest extensions should be set to wait for 5 rings before forwarding and be forwarded to the queue defined for the DV2000.
JWT credential
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
- Select Add User
- Under User Type select Video Pro User
- Add email (Note: this needs to be a unique email a tech can log into and to finish setup)
- Enter First Name: DuVoice Last Name: JWT
- Site: Select the organization (If more than one, group with hotel room users)
- Select Next
- Setup Option: Send Invite
- Edit Role: Select Super User
- Using the email that was sent select the Set Up Account button
- Enter a password (this email and password will be used for creating credentials below)
Create JWT Credentials for that User
- Go to “Home”
- On right select Developer Portal
- On the https://developers.ringcentral.com/login page login in using new DuVoice JWT user email and password.
- On the Welcome screen select SKIP
- On upper right your will see DuVoice with a drop down arrow and select Credentials
- Select Create JWT
- For the Label enter DuVoice JWT
- For the Environment select Production
- For Apps Permitted select: All apps created by developers within my organization
- Leave Expiration Date blank
- Select Create JWT (lower left)
- Copy the JWT onto the clipboard to be pasted into the DuVoice system
DV2000 Configuration
SIP Configuration
PBX Settings
- IP or DNS Name
Enter the DNS name of RingCentral SIP. Default is sip.ringcentral.com - Port
Enter 5060.
Proxy server
- 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.
Registration
- Realm
Enter sip.ringcentral.com. - Register accounts using
PBX address.
Options
- Call Progress
MUST BE SET TO Audio tones after CONNECT event otherwise all callouts will fail.
Line Configuration
- 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.
Group Number
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.
Mailbox Configuration
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.
Option 1
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.
Option 2
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.
Call routing
PBX Link RingCentral API Setup
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.
Features
- First and last name change.
Requirements
- DV2000 7.00.10 or above.
- DuVoice Hospitality PBXLink application from RingCentral.
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.
Configuration
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.
Network
Field | Description |
---|---|
Server URL | Enter the URL for RingCentral for communications. Default is https://platform.ringcentral.com. |
JWT Credential | Your RingCentral credentials for accessing your account. |
Options
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. |
Field | Description |
---|---|
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. |
Scheduling
Field | Description |
---|---|
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. |
Other
Field | Description |
---|---|
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: |