RingCentral

• The DuVoice DV2000 provides hospitality features to RingCentral hosted VoIP service.
• The features include a link to the property management system (PMS) to push the guest names into the RingCentral guest room extension profile, allow housekeeping to use the guest room telephone to report room clean/dirt status to the PMS, guest wake-up calls and guest voice mail.
• The DV2000 connects to the RingCentral system using a combination of standard SIP extensions and through a RingCentral App developed by DuVoice.
• New or existing guest VoIP or analog telephones can be used in the application.
• The features will meet and/or exceed any existing on premise based PBX solution.

• Forward guest extension to DV2000 for guest voicemail.
• Auto login to guest mailbox with no password.
• Wake-up calls set by guest or staff.
• Extension or telephone (DID) number based.
• First and last name change in RingCentral.
• Room Clean/Dirt Status from guest room telephone.
• Set DND or wake-ups from PMS.
• Guest room telephone restrict/un-restrict using roles.

• DuVoice 8.0.33 or above.
• One extension per room.
• One user and extension created per DV2000 port.
• Call Queue for DV2000.
• DuVoice RingCentral App added through Super User account.

• Two NIC connections are recommended (not required) to separate the VoIP and PMS data links.
  • Two NICs are provided on a DuVoice Nano appliance.
• The DV2000 sends the message light (SIP Notify) directly to the guest room telephone which requires the guest telephone IP address be stored in the DV2000.
  • Several telephones can be configured to send the IP address to the DV2000.
  • If not the telephones have to have fixed IP addresses.

• Confirm you have the right admin permissions.
  • RingCentral says admins can add licenses, desk phones, and phone numbers.
    • Without purchasing permissions, you can still assign users, but not new purchases.
• Sign in to the RingCentral Admin Portal.

1. Repeat this process to create additional User Extensions for the DV2000 ports:
   1. The DV2000 requires one user extension per port.
2. Go to RingCentral Admin Portal Home Page.
   1. Quick Access Menu
      1. Users submenu
   2. Add user:
      1. Choose user type:
         1. Base license should work just fine.
            1. Select RingEX user.
      2. Add user info:
         1. Require unique email IDs: unchecked
         2. email: enter an email address (something that someone on site has access to - not used by DuVoice).
         3. Firstname: DuVoice
         4. Lastname: Port 1
         5. Ext: <duvoice-extension-port-01>
            1. (Something that works for their dial plan).
         6. Phone: Bring your own device.
         7. Number: set state and area code (local to site’s location).
      3. Setup Options:
         1. You May Select Activate Later, but if not:
            1. Password: (Create something strong and random - not used by DuVoice)
            2. Pin: (Create something strong and random - not used by DuVoice)
            3. Security Question: (create something strong and random - not used by DuVoice)
            4. Emergency Responce location: You should have the ability to pick the site’s address.

• Example Image(s):

1. Return to RingCentral Admin Portal Home Page.
   1. At top of page click on 'users'.
      1. On this new page under 'user list':
         1. Click 'Users with extensions'.
            1. Find and select: DV2000 Port 1
            2. On the right under <duvoice-extension-port-01>
            3. 'Phone' drop down
               1. Incoming call rules
                  1. enable this option: audio while connecting
            4. expand 'Hold' drop down:
            5. Under 'missed calls'
            6. forward to: <frontdesk-extension-number>

• Example Image(s):

1. Return to RingCentral Admin Portal Home Page.
   1. At top of page click on 'users'.
      1. On this new page under 'user list':
      2. Click 'Users with extensions'.
      3. Find and select: DV2000 Port 1
         1. Expand this drop down menu: 'devices and numbers'.
            1. Existing phone
            2. Actions column
            3. Click the 3 dots
            4. 'Setup and provision'

*These settings for each extension must be provided to the DuVoice tech to enter into the DV2000 configuration:

1. Return to RingCentral Admin Portal Home Page.
2. Under the 'Quick Access Menu' section.
   1. Find the 'Groups' submenu.
3. Click the 'Create Call Queue' option.
   1. Extension Number:
      1. Pick something that works with the call queue.
   2. Group Name: DV2000 Queue.

1. Change these settings of the queue:
   1. Call Handling and members:
   2. Wait Settings:
      1. When queue is full: advise callers of heavy call volume and disconnect.
      2. Max wait time: 3 minutes.
      3. When max time is reached, send caller to:
         1. Extension:
            1. Select RC’s internal AA#.
      4. When members are available but no members answer or all members are busy or unavailable: wait for primary members.
      5. Route calls to members: sequential.
      6. Number of rings before trying next member: 3 rings.
      7. After call wrap-up time: 15 seconds.
      8. Allow members to change their queue status: not allowed.
      9. Primary members: select all DuVoice ports.

• Example Image(s):

• This portion should be done by the phone system admin.
• To add several users at once, enter the number of users next to Add, then click Add.
• You are limited to adding a max of 25 users at a time.
• You can also duplicate an entry and then change the first name, last name, and email.

1. Return to RingCentral Admin Portal Home Page.
   1. At top of page click on 'users'.
   2. Click Users with Extensions.
   3. Click Add User.
      1. 1. Choose User Type
         1. Select the user type: RingEx User
            1. The base license should work.
      2. 2. Add User Info:
         1. Enter the user details:
            1. Email address:
            2. Firstname:
            3. Lastname:
            4. Cost Center:
            5. Extension:
            6. Phone:
            7. Number:
      3. 3. Setup Options:
         1. Choose Activate later.

• Example Image(s):

• This portion should be done by the phone system admin.
• These settings need to be done for every Guest Extension.

1. Return to RingCentral Admin Portal Home Page.
   1. At top of page click on 'users'.
   2. Click Users with Extensions.
   3. Find the Extension you would like to edit.
2. A few settings need to be disabled:
   1. User Greeting.
   2. Connecting Message.
   3. Hold Music.
   4. Call Screening.
   5. Audio While Connecting.
3. Call Handing drop down:
   1. Missed Calls:
      1. Select Forward to Extension.
         1. Extension
            1. Edit
               1. Set to: DV2000 Queue.

• Example Image(s):

Note: Proxy server port number despite showing as 5096 within RingCentral configuration needed to be set to 5090 within DuVoice configuration for registration to occur.

1. Create a virtual User.
   1. On the Ring Central Admin Portal Home Screen.
   2. Select Add User.
   3. Under User Type select Video Pro User.
      1. Add email (Note: this needs to be a unique email that someone from the site can log into and to finish setup).
      2. Enter First Name: DV2000.
      3. Last Name: Hospitality.
      4. Site: Select the organization (If more than one, group with hotel room users).
   4. Select Next.
      1. Setup Option: Send Invite.
      2. Edit Role: Select Super User.
   5. Using the email that was sent select the Set-Up Account button.
      1. Enter a password (this email and password will be used for creating credentials below).
   6. Log into the DuVoice Hospitality Account.
      1. On the Ring Central Admin Portal Home Screen.
      2. Log in using the new credentials for the DuVoice Hospitality user.
      3. On right select Developer Portal.
         1. If required, use the same credentials for the DuVoice Hospitality user.
      4. On the Welcome screen select SKIP.
         1. On upper right you will see DuVoice with a drop-down arrow and select Credentials.
      5. Select Create JWT.
         1. For the Label enter DuVoice Hospitality.
         2. For the Environment select Production.
         3. For Apps Permitted select: Only specific apps of my choice.
         4. Enter Client ID #: qagg5jl_Q-WgoN3ieVdP3Q.
      6. Then select Add App.
         1. You should see:
         2. App Name: DV2000 Hospitality
         3. Provider: DuVoice Corporation
         4. Leave Expiration Date blank.
         5. Select Create JWT (lower right).
      7. Copy the JWT onto the clipboard.
      8. Use the JWT Credential in the DV2000 configuration.

** More details on LINK-PBX configuration: https://support.duvoice.com/vs8/pbxlinks/ringcentral

When testing with a checked-in guest, the RC API getting 200 OK.

However, when a guest was checked-out, the RC API was responding with a 400 Bad Request.

To fix this issue:

1. Opened DuVoice DV2000 Manager.
2. Clicked on 'System'.
3. Then clicked on 'tenant'.
4. Then double-clicked the corresponding tenant.
5. Then clicked on the 'name translations tab'
6. By default under the 'vacant' table the 'first' and 'last' use the wild cards for the first and last name corresponding to the mailbox.
7. Updated it so that the 'first' field was 'Room' and the 'last' field was the wildcard for roomid.

Example below:

Since Dialogic HMP can only be bound to one interface, the interface it is bound to must have internet access to RingCentral as well as direct network access to the phones so it can send MWI updates via SIP Notify.

If Wake-up calls are only ringing once or twice. (Not to be confused with attempt count). Then there are a few settings within RingCentral that will need to be verified for the guest extensions.

Within the guest extension configuration under 'Screening, Greeting, & Hold Music' all of these must be unchecked:

1. User Greeting
2. Call Screening
3. Connecting Message
4. Hold Music

Example screenshot:

If a forwarded call has more than the DID or Extension information within the SIP Header, specifically the 'from' and 'to' fields, the DuVoice system will be unable to route the call to the correct mailbox.

In our test case, we were receiving the name of the guest within the room and the extension, rather than just the extension (or DID).

Here is an example of working SIP RNA integration:

To fix our issue, there was a setting within the DuVoice Call Queue inside RingCentral.

1. Call Handling & Members
2. Under 'Display Settings'
3. Call information displayed:
4. Box 1: Phone Number
5. Box 2: None

Example screenshot:

While this could be flexible and still work, these options worked best during testing.

• RoomID = Room Number.
• Mailbox = Guest's extension number.
• Extension = Guest's DID number.
• MWI0 = Guest's DID number (this is so IPPHONECFG can autofill the IP address to the DID for the MWI address).

Enabled extension search for called and caller ID.

1. Open DV2000 Manager
2. Click on 'telephony' drop down menu.
3. Click on 'call routing'
4. Click insert.
5. Set 'enabled' to checked, 'input source' to caller id, 'action to take' to extension search.
6. Click insert.
7. Set 'enabled' to checked, 'input source' to called id, 'action to take' to extension search.
8. Click 'apply' and 'save'.

Use RoomID to avoid requiring a translation table.

1. Open DV2000 Manager
2. Click on the 'features' drop down menu.
3. Click on 'hospitality'.
4. Click on the applicable PMS link.
5. Click on the 'PMS tab'.
6. Under the 'Room lookup method' field, select 'match room ID'.
7. Click 'ok'.