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

  • 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 6.03.16+

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

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)

  • Set up one 10 digit extension as a SIP endpoint for DuVoice.
    • See below for DuVoice setup.

OR

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.
  • Note:
    • All mailboxes should be configured to use the subscriber's 10-digit number.
      • Extension Based Setup:

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.
  • Using DV2000 Manager:
    • Select: Site.
    • Select: Profiles.
      • Under Details:
        • Select: Metaswitch.

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.
  • Last modified: 2026/07/08 16:17
  • by jh