Table of Contents

Zoom

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.

Features

Requirements

Network Considerations

Hospitality Integration

Zoom Configuration

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.

Requirements

A Zoom application with the correct scopes assigned is required.

PAI

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.

Scopes

The following scopes are required by the DV2000.

Required
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.
Optional

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.

DuVoice Configuration

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.

Profile Configuration

Network

FieldDescription
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.

Options

FieldDescription
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.
Department Options
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.

Scheduling

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: 480.

Other

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.

Telephony Integration

Zoom Configuration

Setting up SIP Integration for DuVoice

Creating the User Extensions for the DV2000 ports

Users are created within the 'ADMIN' > 'user management' > 'users' section.

Assigning DV2000 User to Device

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.

  1. Click 'Add' button.
  2. Under 'Display Name' field add: DV2000
  3. Under 'MAC Address' add the MAC address of the DuVoice server.
  4. Under 'Device Type' drop down select the 'Other' option.
  5. Click the 'Assign' button.
  6. Select the first DV2000 user.
  7. Click the 'Add' button.
  8. Repeat previous two steps until all DV2000 users are assigned to this device.
  9. Click the 'Save' button.
  10. Keep this screen open for the next step.

Acquiring SIP Credentials

The DV2000 SIP ports require credentials from the provisioning page.

  1. On the assigned DV2000 device page, click on the 'Actions' button.
  2. Then click the 'Provision' option.
  3. Check the box that says 'By using this device without manually enabling these features, you accept all risks associated with it.'
  4. Copy all of the details listed under the 'SIP Account'.
    1. This will be used to configure the DuVoice SIP integration.

Setting Up Guest Extensions

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:

DV2000 Configuration

Telephony Configuration

Local Settings

SettingDescription
PortPort number system should listen for SIP communication on. Default is 5060
Transport ProtocolSIP typically communicates via UDP which is the default. If the PBX is configured for TCP only then choose TCP.

PBX Settings

SettingDescription
AddressIP address or DNS name of your Zoom PBX.
PortPort number PBX listens on for SIP communication on. Default is 5060
Expiration TimeEnter 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.
RealmLeave blank.
DomainLeave blank.
Register accounts usingLeave set to PBX Address.

Proxy server

These settings are optional and typically only used when connecting to a PBX which exists on the internet rather than locally.

SettingDescription
AddressEnter the address of the Zoom proxy server.
PortPort number proxy server uses for SIP communication on. Default is 5091

Security

TLS Cert FilePath 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.
TLS Cert File Source

According to this Zoom article here. The required TLS cert file can be downloaded here.