The DuVoice DV2000 provides hospitaility features to ZoomPhone hosted VOIP service.
The features include a link to the property management system (PMS) to push the guest names into the ZoomPhone guest room extension profile, allow housekeeping to use the guest room telephone to report room clean/dirt status to the PMS, guest wakeup calls and guest voice mail.
The DV2000 connects to the ZoomPhone system using a combination of standard SIP extensions and through a ZoomPhone 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.
* First or last name of checked in rooms should have ${mailbox} added. This is set under the Tenant | Name Translations.Users are created within the 'ADMIN' > 'user management' > 'users' section.
During this step, we'll create a DV2000 Device within Zoom, and then add all the DV2000 users to the device.
Assigning is done within the 'ADMIN' > 'Phone System Management' > 'Phones & Devices' section.
The DV2000 SIP ports require credentials from the provisioning page.
Only a basic ZoomPhone extension licence is required.
This licence just needs to be able to make local/long distance and 911 calls.
It also needs to have the calling handling option to forward on busy or reing no answer to the DV2000 extension (or group).
Forward the guest room extension to the DV2000 extension or group number:
The Zoom application will be available in the Marketplace soon.
Before then, a custom app can built for each application.
The 'Marketplace' can be accessed within 'ADMIN' > 'Advanced' > 'App Marketplace' section.
On the first page, it should be labeled 'App Credentials'.
Copy the information within all three sections:
These will be used for the PBX link configuration on the DuVoice server.
Click on the 'Continue' button.
Add the following details to this tab.
Basic information
Developer Contact Information
Click on the 'Continue' button.
Click on the 'Continue' button.
There are several specific features that are required for the DuVoice PBX link to function.
user:read:user:adminuser:read:list_users:adminuser:update:user:adminphone:read:list_devices:admin phone:read:device:adminphone:read:list_users:adminuser:update:presence_status:admin phone:read:list_voicemails:adminphone:delete:voicemail:adminClick the 'Continue' button.
Click on the 'Activate your app' button.
| Setting | Description |
|---|---|
| Port | Port number system should listen for SIP communication on. Default is 5060 |
| Transport Protocol | SIP typically communicates via UDP which is the default. If the PBX is configured for TCP only then choose TCP. |
| Setting | Description |
|---|---|
| Address | IP address or DNS name of your Zoom PBX. |
| Port | Port number PBX listens on for SIP communication on. Default is 5060 |
| Expiration Time | Enter the time, in seconds, the channel will wait between registrations with the PBX. SIP endpoints (channels) are required to maintain registration with the PBX in order to have calls routed to them. Adjust this setting to be less than the maximum for your PBX. For example, the older Avaya IP Office system default to 180 seconds, while other PBX systems have an expiration time of 3600 seconds. The default value is 3600 seconds. |
| Realm | Leave blank. |
| Domain | Leave blank. |
| Register accounts using | Leave set to PBX Address. |
These settings are optional and typically only used when connecting to a PBX which exists on the internet rather than locally.
| Setting | Description |
|---|---|
| Address | Enter the address of the Zoom proxy server. |
| Port | Port number proxy server uses for SIP communication on. Default is 5091 |
| TLS Cert File | Path to the TLS certificate file to use. Leave blank unless using TLS. Use the DigiCertGlobalRootG2.crt.pem certificate. Placing this file in C:\VS\DATABASE will ensure it gets backed up. |
This PBXLink uses the Zoom API for Account User or Common Area settings in order to update them with first name, last name, and other extension changes.
Zoom enforces strict rate limits in order to provide better service among it's clients. Due to these rate limits changes are limited based on your account level. All changes use the medium rate limit.
A Zoom application with the correct scopes assigned is required.
To enable P-Asserted-Identity (PAI) for forwarded calls go to: Number Management | BYOC Configuration. Enable Include original calling number within the P-Asserted-Identity (PAI) header for forwarded calls.
Note: These configurations may not be show for some Zoom accounts.
The following scopes are required by the DV2000.
| Scope | Reason |
|---|---|
| user:read:user:admin | Read user. |
| user:read:list_users:admin | List users. |
| user:update:user:admin | Update user. |
| phone:read:list_devices:admin | List devices. |
| phone:read:device:admin | Read device. |
| phone:read:list_users:admin | List phone users. |
Features will be disable if not found at startup.
| Scope | Reason |
|---|---|
| phone:update:device:admin | Update device for caller id. |
| user:update:presence_status:admin | Update presence status like dnd. |
| phone:read:list_voicemails:admin | List voicemail. |
| phone:delete:voicemail:admin | Delete voicemail. |
| phone:read:common_area:admin | Common Area access. |
| phone:update:common_area:admin | Common Area access. |
Names must contain the extension number. This is done via Name Translations. The suggested setting is to change Full name to the following:
${vip} ${first} ${last} ${extension}
The device used by the DV2000 must also have it's name changed to include it's extension in order to answer correctly. Do no enter any other numbers in the name field other than the extension as well.
| Field | Description |
|---|---|
| URL | Enter the Zoom URL. Zoom will automatically respond with a region specific URL for making changes. |
| AccountID | Enter the account id of the Zoom application. |
| ClientID | Enter the client id for the Zoom application. |
| ClientSecret | Enter the client secret for the Zoom application. |
| Field | Description |
|---|---|
| Set Department | Optionally set the department field of the user account. |
| Message management | Check this box when using Zoom for guest messaging. When checked the system will automatically delete all messages for a user or common area. |
| Disabled | Field will not be set. |
|---|---|
| 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. |
| Tenant name | Name of the tenant the extension is associated with. |
| Site name | Name of the site. |
| 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: 480. |
| 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. |