Howto:Group Voicemail: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
No edit summary
Line 18: Line 18:


===Installation===
===Installation===
Two PBX phone endpoints ''Atlantis'', ''Endeavour'' share a voicebox ''vm-group'' with number ''803''. The voicebox's directory on the mass-storage will be named ''vm-group''.
Users redirect their calls to the voicemail object via call forwarding. The number of the VM object is appended as the destination number for the call forwarding and for the MWI button, e.g. if the VM object has the number 803, then the call forwarding and the MWI button use 803803 as the destination.
The phones may redirect towards the voicebox by means of a CFU 803803. The phones access the voicebox by the Message Center Account number 803803.
In the URL of the vm.xml script, use the $m variable to configure the recipients of the MWI notification.
The voicebox's directory on the mass-storage will be named like the ''Name'' of the Voicemail-Object.


If Viking calls e.g. Endeavour, it's going to be redirected into ''vm-group'' and may leave a voicemail. On call-end the participants Atlantis, Endeavour are going to receive an MWI-Activate.
===Configuration Example===
 
*Assume following objects exist in your PBX:
===Configuration===
**'''User''' ''101(Number):endeavour(Name):Endeavour(LongName)''
*Add following objects
**'''User''' ''102(Number):atlantis(Name):Atlantis(LongName)''
**'''User''' ''101:Endeavour''
**'''Voicemail''' ''803(Number):vm-group(Name):Vm-group(LongName)''
**'''User''' ''102:Atlantis''
**'''User''' ''301:Viking''
**'''Voicemail''' ''803:vm-group''
***'''Script URL''' <code type="text">
***'''Script URL''' <code type="text">
http://127.0.0.1/drive/CF0/vm/vm.xml?$_m=101,102
http://127.0.0.1/drive/CF0/vm/vm.xml?$_m=101,102
Line 39: Line 37:
***'''Number''' ''803803''
***'''Number''' ''803803''
***'''Append Own Number'''  inactive/not checked
***'''Append Own Number'''  inactive/not checked
***'''Name''' ''vm-group'' (needed if multiple MWI-keys are configured on the phone)
***'''Name''' ''vm-group'' - needed if multiple MWI-keys (e.g. own Voicemail and Group Voicemail) are configured on the phone.
*Configure source email address and mail server
*Configure source email address and mail server
**Edit the settings underneath '''PBX/Config/Authentication/Email Verification''' accordingly. Those are the settings being considered by the sub-script email.xml.
**Edit the settings underneath '''PBX/Config/Authentication/Email Verification''' accordingly. Those are the settings being considered by the sub-script email.xml.

Revision as of 16:43, 14 February 2022

Applies To

This information applies to

  • IPXXX, V13r2

PBX-Build 135779 and later. VM-Build 135xxx

More Information

A comma-separated list of MWI destinations/recipients can be configured by means of a variable $_m within the script URL's query string. This article outlines a configuration scheme for group voicemail functionality.

Problem Details

A group voicemail acts as single point of storage and multiple point of access for several PBX endpoints. MWI-updates are expected to be delivered to all group members.

System Requirements

A standard voicemail script vm.xml is expected to be installed underneath /drive/CF0/vm/vm.xml.

A PBX-VoicemailUser13 license is required for each group voicemail.

Installation

Users redirect their calls to the voicemail object via call forwarding. The number of the VM object is appended as the destination number for the call forwarding and for the MWI button, e.g. if the VM object has the number 803, then the call forwarding and the MWI button use 803803 as the destination. In the URL of the vm.xml script, use the $m variable to configure the recipients of the MWI notification. The voicebox's directory on the mass-storage will be named like the Name of the Voicemail-Object.

Configuration Example

  • Assume following objects exist in your PBX:
    • User 101(Number):endeavour(Name):Endeavour(LongName)
    • User 102(Number):atlantis(Name):Atlantis(LongName)
    • Voicemail 803(Number):vm-group(Name):Vm-group(LongName)
      • Script URL

http://127.0.0.1/drive/CF0/vm/vm.xml?$_m=101,102

      • E-Mail if desired configure a destination email address serving as a group email address
        • Note: The email is sent only once to the destination configured as PBX/Objects/"vm-group"/General/E-Mail. It is up to an admin of the receiving mail server for how to distribute the email towards all potential group members.
  • Configure Function-Keys at phones Endeavour, Atlantis
    • Type Message Waiting
    • Message Center Account
      • Number 803803
      • Append Own Number inactive/not checked
      • Name vm-group - needed if multiple MWI-keys (e.g. own Voicemail and Group Voicemail) are configured on the phone.
  • Configure source email address and mail server
    • Edit the settings underneath PBX/Config/Authentication/Email Verification accordingly. Those are the settings being considered by the sub-script email.xml.

Configuration App Platform

If using app platform the configuration can done by PBX Manager. There is a new button "add Voicemail group app". This configures the new variable "$_m" and a second one for the app "$_group" which is the name of the VM Object. It is only necessary for the voicemail app.

The voicemail app works with sip names[1][2] so that it is mandatory to configure the Message Waiting Keys and the $_m with names instead of numbers.

Script URL http://127.0.0.1/drive/CF0/vm/vm.xml?$_m=endeavour,atlantis&$_group=vm_group&$app=on

The group voicemail app can be activated for every user by checkmark the group voicemail object in the tab "PBX/User/Apps"

Known Problems

Related

  1. sip name: the dialable name, within a user's PBX-UI the edit field name
  2. A comma within a sip name must be URL-escaped within the comma-separated list $_m.. E.g. Doe, John => Doe%2C John