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





