Metaswitch
- The DV2000 provides Metaswitch a suite of hospitality features including an interface to the hotel PMS system:
- Guest information
- Guest voice messaging
- Wake-up call
- Housekeeping room status reporting.
The guest messaging, wake-up calls, and housekeeping features utilize a SIP connection to Metaswitch and the PMS interface uses the MetaSphere EAS (CommPortal).
Requirements
PBX
- Metaswitch 9.0 or above.
- One Metaswitch SIP Extension per 150 rooms
- MetaSphere EAS (CommPortal)
- A Metaswitch Level 3 SIP Trunk to DuVoice if using SIP trunking instead of SIP extensions.
DuVoice
- DuVoice 6.03.16+
MWI
For MWI Configuration, please refer to this page here.
- If 250 or fewer phones using the DV2000 system you will need to set the SIP subscriptions to the DV2000 IP on each phone.
- If 251 or more SIP phones using the DV2000 system you will need each and every phone set with a static IP in order for MWI to work.
- All phones must support and be set to:
Allow anonymous notifications.
Features
- Subscriber name change.
- Call Bar enable/disable based on state of room using hospitality groups.
- DND enable/disable.
- Support for multiple business groups.
- Message light controls
- Room status /maid code live update
- Guest and staff personal voicemail
- Wake-up call scheduling and alerting
Telephony Integration
Metaswitch Configuration
DuVoice DV2000 offers either SIP extensions or SIP Trunks connection methods for wake-up calls, housekeeping updates, messaging, and other voice path features. Both methods are listed below.
Metaswitch SIP Extension (Preferred)
Metaswitch SIP Trunk (Not Preferred)
SIP Line/Trunk Provide one SIP trunk per every DV2000 SIP Port
- subscriber programming section / Configuration tab
- Business Group Administrations – Account type = must be set to Administrator for name change controls.
- Phone Number = DV2000 username for port registration
- subscriber programming section / Connection tab
- SIP Password (CFS) – set the password for DV2000 port registration
- SIP domain name (CFS) – this is used for SDV SIP registration.
- IF No SIP End Point Pack for DuVoice SIP ports is available you can use SIP trunking instead of SIP extension/endpoints.
DuVoice Configuration
- Note:
- All mailboxes should be configured to use the subscriber's 10-digit number.
- Extension Based Setup:
- PBX address could be IP or FQDN.
Hospitality Integration
Metaswitch Configuration
There are three different MetaSphere API interfaces that are available for hospitality guest phone call controls and name changes from the DV2000 server.
- Network-Wide Web Services API
- Preferred
- MetaSphere EAS API
- Not Preferred
- MetaView Web Services
- Least Preferred
Network-Wide Web Services API (Preferred)
- This interface is the suggested method of integration.
- This interface must be used for any Clustered CFS deployments which can be an advantage for many hosted solutions.
- It also doesn't require any specific steps to enable the Network-Wide Web Services API.
- It is Automatically available on any MetaView Server or MetaSphere EAS server that is running MetaView Web.
- Requirements:
- User account can be any MetaView Web user with the option “Can use Network-Wide Services API” enabled.
- Create a username and password.
MetaSphere EAS API (Not Preferred)
AKA CommPortal JSON API.
- The CommPortal JSON API is available to use if the Network-Wide API is not available or wanted.
- This API provides the DuVoice with all features using a username and password.
- Requirements:
- User account making changes must be an EAS Administrator for the Business Group.
- For hospitality phone controls.
MetaView Web Services (Least Preferred)
- Not commonly used
- This API is the original API supported by DuVoice
- Requirements:
- MetaView Web Services enabled.
- Issues:
- This is a “trusted” API and there is no security or authentication.
- If you enable this interface, make sure you restrict access to it.
- For example by using a firewall to restrict access to the TCP port it uses 8080.
DuVoice Configuration
PBX Link
Network-Wide Web Services API (Preferred)
| Option | Setting | Notes |
|---|---|---|
| Interface | Network-Wide Web Services | |
| Network | ||
| PBX URL | <PBX-URL> | Full URL of PBX. Example: http://web-server:8087/mvweb/services/ShService or https://web-server:8445/mvweb/services/ShService. |
| Web Services | ||
| Switch Name | <Switch-Name> | Name of Switch, case-sensitive. |
| Business Group | <Business Group> | Name of Business Group, case-sensitive. |
| Account | ||
| Username | <Username> | MetaView Web user with option Can use Network-Wide Web Services API enabled. |
| Password | <Password> | Password, case-sensitive. |
CommPortal (Not Preferred)
DuVoice PBX-LINK (CommPortal) for Metaswitch integration can be found here.
| Option | Setting | Notes |
|---|---|---|
| Interface | MetaSphere EAS (CommPortal) | |
| Network | ||
| PBX URL | <PBX-URL> | Full URL of PBX. Example: http://web-server:8087/mvweb/services/ShService or https://web-server:8445/mvweb/services/ShService. |
| Web Services | ||
| Switch Name | <Switch-Name> | Name of Switch, case-sensitive. |
| Business Group | <Business Group> | Name of Business Group, case-sensitive. |
| Account | ||
| Username | <Username> | MetaView Web user with option Can use Network-Wide Web Services API enabled. For CommPortal this is a subscriber phone number and must be a Business Group Administrator. |
| Password | <Password> | Password, case-sensitive. |
MetaView Web Services (Least Preferred)
| Option | Setting | Notes |
|---|---|---|
| Interface | MetaView Web Services | |
| Network | ||
| PBX URL | <PBX-URL> | Full URL of PBX. Example: http://web-server:8087/mvweb/services/ShService or https://web-server:8445/mvweb/services/ShService. |
| Web Services | ||
| Switch Name | <Switch-Name> | Name of Switch, case-sensitive. |
| Business Group | <Business Group> | Name of Business Group, case-sensitive. |
| Account | ||
| Username | <Username> | MetaView Web user with option Can use Network-Wide Web Services API enabled. |
| Password | <Password> | Password, case-sensitive. |





