Polycom

SIP Notify

All these methods require the Message Waiting notification to be configured as SIP or SIP+PMS.

Notifications

From Mailbox Administration→Templates→Notifications.

Set both the MWI On and MWI Off template to use SIP or SIP + PMS if you prefer.

Often if the PBX doesn't supply forwarding of message waiting to a phone or is blocked because it has it's own voicemail the DuVoice can send a SIP notify directly to the phone or gateway.

Care should be taken to ensure the PBX never sends a SIP Notify to the extension otherwise the light may not be in the correct state.

  • Phone is configured for a static IP address. This can done on the phone or within the DHCP server which is preferred.
  • Phone must support anonymous SIP notify.
  • DuVoice must be able to send network packets directly to the phone. Ensure their are no proxy servers or network settings which could prevent this.
  • DuVoice must be licensed for SIP.

Edit a mailbox, choose Address List, and configure one or more of the MWI addresses for the SIP address you wish to send the notification.

In most hosted SIP PBX applications with DuVoice DV2000 the built in When using a SIP telephones in the guest room, the telephone musy support recieving a SIP notify for the message light from the DuVoice DV2000 IP address which is NOT the same IP address as the hosted PBX. The may also be refered to as an “Anonymous” SIP notify. Various manufacturers deal with this in a few different ways. Some allow and IP address to be entered for the message waiting server, some may have a securty checkbox that allows SIP messages from an IP address other than the registered PBX and some have the abilty to subscribe to a different IP just for message waiting lights. (See Subscribe below).

NOTE: Some telephones support sending the IP address to the DV2000 so static IPs are not required: https://support.duvoice.com/vs8/vsconfig/system/service/ipphonecfg

Polycom phones allow third party SIP notify but the SIP Port defined in the SIP section of the phone web admin. Polycom Edge E100 Example: 12818452518@192.168.11.42:5135 (where The Polycom Edge E100 local sip port is set in the Polycom web admin under SIP settings as 5135)

IPPHONECFG

This optional server will listen for events posted by SIP telephones and/or perform a ARP query to automatically configure an MWI address for a mailbox.

  • DV2000 8.0.46 or above.
  • Telephones can be configured for DHCP.
  • Phones can configure themselves.
  • Multiple phones per-mailbox.
  • Individual phone overrides.
  • Change will retain original extension number.
  • Change will retain original port number.
  • ARP query to match MAC address to mailbox or MWI address.
  • Any and all IP phones on the same subnet as the DV2000.
  • Poly / Polycom
  • Yealink
  • Bittel
  • vTech

Because many SIP PBXs do not support message waiting (MWI) from 3rd parties the DV2000 can be configured to send the phone a SIP Notify packet to set/clear the MWI light. However this requires each phone to have a fixed IP address and be manually configured within Manager.

In order to automatically configure telephones this server can listen for changes from the telephone as well as perform an ARP request to match MAC addresses to mailboxes.

Creates a list of all possible IP addresses on all network adapters in the system. Then it queries each one asking for the devices MAC address. If the device responds with a MAC address, we search the mailbox list for it and configure the MWI address if we find one.

If we cannot find the MAC address assigned to a mailbox then we search all MWI addresses description for a matching MAC address. If we find a match then we configure that exact MWI address. Using this method allows them to assign a MAC address per MWI address for when multiple telephones exist in a room.

Using this method allows telephones to use DHCP and automatically configure the MWI address on the DV2000 based. However if telephones are configured to use a random SIP port this server cannot be used because none of the telephones support sending their port number.

The server will automatically check if there is an existing extension and port number as part of the address and not change these. This allows the administrator to pre-configure all mailboxes and only the IP address will be modified.

Here are some examples of how the MWI address is modified by the server when determine the extension is 3101 and the phones IP address is 192.168.100.67.

Examples

Extension IP Address Existing MWI Becomes
3101 192.168.100.67 Empty 3101@192.168.100.67
3101 192.168.100.67 3101 3101@192.168.100.67
3101 192.168.100.67 3101@192.168.100.55 3101@192.168.100.67
3101 192.168.100.67 12055551212 12055551212@192.168.100.67
3101 192.168.100.67 3101:5070 3101@192.168.100.67:5070
3101 192.168.100.67 3101@192.168.100.55:5070 3101@192.168.100.67:5070
3101 192.168.100.67 12055551212@192.168.100.55:5070 12055551212@192.168.100.67:5070

Server Setup

This server is always disabled by default and must be manually configured. This server is never added to the list of servers on updates or upgrades and can be added manually.

  1. Edit the server by double clicking on the it.
  2. Edit the port number. This is typically always set to the default.
  3. Add any optional arguments.

All fields are optional.

Argument Description
-i IP addresses of the system to bind on. Default is any IP address of the computer.
-p Port number to listen for events on. Default is 9090. To disable the HTTP interface and only use ARP set value to 0.
-mwi MWI address to modify. Can be anything in the range 0-30. Default is 0.
-anycall By default the system will not automatically configure the MWI unless the called or calling party is the DV2000. This setting tells it to accept changes whenever a call is made or received. This only works for Polycom phones and when the Incoming or Outgoing Call event is checked.
-port This will add the port number to the SIP address.
-arp Number of minutes to perform query. Minimum value supported is 10 minutes.

Example

  1. i 192.168.100.10 -p 9090 -mwi 2 -anycall -port 5070

Note when using a firewall you will need to add an exception for the port.

Polycom

These events are configured via the phones administration interface.

The DV2000 supports most of the events. While these packets to the DV2000 are very small and will not prevent a phone from taking or receiving calls a typical configuration would be to only check Line Registration. Using the outgoing or incoming call events the phones MAC address will automatically be configured. This does require that the telephone extension match either the mailbox or extension number.

Type Description
Line RegistrationWhenever the phone registers with a PBX, an event is sent.
Incoming CallAny outgoing call, the phone will post an event.
Outgoing CallAny outgoing call, the phone will post an event.
OnhookAnytime phone goes onhook, the phone will post an event.
OffhookAnytime phone goes offhook, the phone will post an event.

Using one of these events requires the telephones MAC address must be configured in the mailbox using Manager located under Advanced. The server will then find the first mailbox with the MAC address contained in the event and change that mailbox.

When using Incoming or Outgoing call, the DV2000 will attempt to match the called or calling number with either the mailbox number or the extension of the mailbox.

?direct

Set Notification URL to the IP/DNS name of the DV2000 followed by the port and “/polycom”.

Example:

http://192.168.1.1:9090/ipcfg/polycom

The server will accept three additional parameters in the URL allowing individual telephones to control their own settings.

Add /<mailbox> to the URL. The following will force the server to update mailbox 3101 regardless of the extension number it detects from the event.

Example:

http://192.168.1.1:9090/ipcfg/polycom/3101

To force an MWI address add /<mailbox>/<number> to the URL. You must specify the mailbox number for this option. In this example it will update the MWI address 4 in mailbox 3101.

Example:

http://192.168.1.1:9090/ipcfg/polycom/3101/4  

To force the address to have a custom port number add /<mailbox>/<number>/<port> to the URL. This will force the port number to always be set.

Example:

http://192.168.1.1:9090/ipcfg/polycom/3101/4/5070

Other

These phones perform a HTTP GET request for a specific action and all require the same URL parameters.

Required

Parameter Description
ipIP address of the phone. Phone will automatically set this when set to $ip.
macMAC address of the phone. Phone will automatically set this when set to $mac.
extExtension number of the phone. Set this to either the extension or mailbox you want changed for this phone.

Optional

portPort number to add to MWI address. Only needed when phone is not configured to use port 5060.
mwiMWI address to use in the range 0-30. Default is 0.

Tips

For the quickest setup configure telephones to send Incoming Call event. Then call the phone from the DV2000 using either a Message Delivery, Transfer or wakeup call. Performing these actions on a guest room which is occupied however isn't suggested.

For those situations where there are multiple phones in a room the Notification URL can be modified on the additional phones to update a common mailbox using the additional /<mailbox> shown above.

Another option is to set the even type to Outgoing and then each time a maid or anybody calls the DV2000 it will automatically be configured.

  • Last modified: 2025/01/30 19:31
  • by jh