View source for Mobotix Hub - Zenitel Connect Integration

{{C}}
==Introduction==
The interface between Zenitel Connect Pro and MOBOTIX HUB VMS is through an integration module.
This integration requires a Zenitel desktop station to be associated with each MOBOTIX HUB Desk Client, as audio is routed through Zenitel Connect Pro.
<br>
This article assumes that the reader is:
*familiar with the setup and operation of the MOBOTIX HUB VMS
*that the MOBOTIX HUB VMS is operational, with all the system connected cameras configured
*that Zenitel Connect Pro is operational, with all the system connected intercom devices configured
<br>
Only points that are specific to this integration and to connected intercom stations and IP speakers are described.
<br>

==Licensing==

===MOBOTIX HUB===
The integration interface does not require a specific license from Mobotix.

However, note that Zenitel stations are typically registered as ONVIF devices in MOBOTIX HUB VMS, e.g. stream and record audio/video from stations. This requires separate station licenses from Mobotix.
For an overview of the ONVIF features supported in Zenitel devices, please read our article [[ONVIF Settings]]

===Zenitel Connect Pro===
Zenitel Connect Pro requires the following license from Zenitel:
*1002720900 – ZCL-API – ZC-Integration license

==Installation==
This section describes how to install the integration plugin.
It is assumed that the MOBOTIX HUB VMS is installed and running. It is also assumed that the MOBOTIX HUB VMS has been licensed appropriately.<br>

*When installing (or uninstalling) the plugin all MOBOTIX HUB Desk Client must be closed.
*The plugin needs to be installed on the same machine as the MOBOTIX HUB Desk Client.

#Download the MSI setup file.
#Run the setup file, and follow the instructions on the screen
#When prompted for the installation location, select the Mobotix/MIP installation folder (e.g. C:\Program Files\Mobotix\MIPPlugins).
#Click "Close" to complete the installation.<br>
<br style="clear:both;" />

== Configuration ==
===Basic plugin configuration===
#Open the MOBOTIX HUB VMS Desk Client.
#Open the "Settings" window by clicking the "Settings" Icon button in the toolbar.
#In the "Settings" window enter the IP address of your Zenitel intercom system in the "IP Address" field.
# The port used for connection is TCP port 8086 or 8087 and must be open in the Zenitel Connect Pro firewall.
# The credentials used in the plugin are set in the Zenitel Connect Pro web interface with the role of a Zenitel Link User (not the administrator). See [[Mobotix Hub - Zenitel Connect Pro Integration#User configuration|User configuration]] for more information.
#Click the "Connect" button and wait for the system to retrieve the list of available devices.
#Select the operator's device by choosing its directory number from the drop-down list.
<br>
[[File:ZenitelCallHandlerConfigurationGif_307_agnostic.gif|thumb|center|800px|Animation of the Zenitel Cal Handler configuration process]]
<br>

===Associating cameras with devices===
# Open the camera settings window.
# On the left side, there will be a list of devices registered with Zenitel Connect Pro. On the right side, there will be a list of cameras registered within the MOBOTIX HUB VMS system.
# Click on a device in the left list to select it.
# Click on an item in the right list to preview the video feed from that camera.
# To associate a camera with a selected device, click on the checkbox next to the camera's name.
# Repeat steps 3-5 to associate additional cameras with the selected device.
# Once satisfied with the configuration, close the camera settings window.
# Click "Save and Close" on the configuration window to save the changes.
<br>
[[File:ZenitelCallHandlerCameraConfiguration_307_agnostic.png|thumb|center|800px|Screenshot of the camera assosiation process]]
<br>

===User configuration===
Configuring a user with the Zenitel Link User role is crucial for seamless integration with the Zenitel Connect Pro system via the plugin. This specific role ensures that the user credentials are appropriately authenticated and authorized to establish a connection. Therefore, it is imperative to assign the role of "Zenitel Link User" to the user account, ensuring smooth and secure access to the communication system.
[[File:ZCP_LinkUser.png|thumb|center|800px|User configuration process]]
<br>

===Broadcasting groups configuration===
The broadcasting groups are set up through the Zenitel Connect Pro web interface. Users are required to establish groups and allocate devices to them within this interface. These configured groups will then be seamlessly integrated into the plugin, streamlining the broadcasting process.
[[File:ZCP_BroadcastMlstn.png|thumb|center|800px|Broadcasting group configuration process]]
<br>

===Prerecorded messages configuration===
Similarly, audio messages are uploaded within the web interface of Zenitel Connect Pro.  This seamless integration ensures that audio communication is efficiently handled alongside broadcasting groups, providing users with a comprehensive platform for managing all aspects of their communication needs.
[[File:ZCP_AudioMlstn.png|thumb|center|800px|Prerecorded message configuration window]]
<br>

==Using the Call Handler==
The Zenitel Call Handler (Zenitel Connect Pro) plugin can be used for two scenarios: initiating calls and handling incoming calls.
Note that SIP audio is routed through Zenitel Connect Pro, so audio calls and audio broadcasts are established on a Zenitel desktop station.
If the Operator uses a desktop station, the Call Handler transfers the call from the MOBOTIX HUB Desk Client to the desktop station where the operator gets audio through the station connected handset, speaker, or headset.


===Initiating Calls===
In MOBOTIX HUB Desk Client on the Zenitel Audio tab select a device you wish to call and click on the green "Answer/Call" button.<br>
A popup window will be displayed showing the active call, along with a video preview from an associated camera.
<br>
[[File:ZenitelCallHandlerOperation1_307_agnostic.png|thumb|center|800px|Popup window displaying the active call and associated camera]]
<br>

===Answering queued Calls===
# When an inbound call is received, a popup window will be displayed showing the queued call, along with a video preview from an associated camera.
# To answer the call, click the green "Answer/Call" button.
# If there is an active call, the Call Handler will automatically hang up the active call and answer the inbound call.
# If there are multiple queued calls, they will be displayed in order of priority. To answer a specific queued call, simply click on the green "Answer/Call" button.
<br>
[[File:ZenitelCallHandlerOperation2_307_agnostic.png|thumb|center|800px|Popup window displaying the active call and his associated camera with two queued calls]]
<br>

===Tracking calls meant for a different operator===
You can determine if a station is busy by checking the device list. 
If another operator has initiated a call, the current user will be informed about which operator and station are engaged.
Notably, there will be no popup window displayed in this scenario.
[[File:ZenitelCallHandlerOperation3_307_agnostic.png|thumb|center|800px|Two stations busy but the operator is not involved]]
<br>

===Using the Popup Window===
* The popup window displays the active call (if it was initiated by the operator) or a list of queued calls, along with a video preview from an associated camera.
* The popup window will display the camera feed from the first associated camera of the active call (if present) or if there are no active calls, the first queued device-associated camera will be displayed.
* To manually switch the camera video feed to any active or queued device, select the desired device from the dropdown list in the popup window.
* To hang up the active call, click the red "Hang-Up" button.
* To answer a queued call, click the green "Answer/Call" button.
* If there are multiple queued calls, they will be displayed in order of priority. To answer a specific queued call, select it from the dropdown list in the popup window.
<br>

===Broadcasting===
====Live announcements====
The user will be presented with a list of all available groups. <br>
From this list, the user can make a selection to interact with a particular group by simply clicking either of the two buttons: "Live Announcement" or "Prerecorded Message."
[[File:ZenitelCallHandlerBroadcastView_307_agnostic.png|thumb|center|800px|Broadcast tab view]]
<br>

Notably, if any group is currently engaged or busy, both buttons will be displayed in a distinctive red color to indicate the unavailability of the group. <br>
This visual cue helps users quickly identify the status of the chosen group.
[[File:ZenitelCallHandlerGroupBussy_307_agnostic.png|thumb|center|800px|Example of a busy group]]
<br>

When the user clicks on the "Live Announcement" button, a new window will appear, providing the user with essential information about the selected group
and the control to stop the Live Announcement Call.
[[File:ZenitelCallHandlerLiveAnnouncementWindow_307.png|thumb|center|800px|Live Announcement Window]]
<br>

====Broadcasting prerecorded messages====
{{note | Before using prerecorded messages, it's essential to upload WAV audio files to the Zenitel Connect Pro system.}}
When the user clicks on the "Prerecorded Message" button, a new window will appear, providing the user with vital information about the selected group and controls for broadcasting prerecorded messages to that group. 
[[File:ZenitelCallHandlerBroadcastMsgWindow_307.png|thumb|center|800px|Prerecorded message control Window]]
<br>
<br style="clear:both;" />

== How-To video ==
To learn more about this integration, please access the online training at Zenitel Academy via the link below (you must be part of Zenitel’s Learning Community Program. You can request to join the Learning community [https://www.zenitel.com/learning-community-program here]).
* [https://academy.zenitel.com/client/default.aspx?GUCAID=335429 How-to-video Zenitel Connect Pro - Mobotix Hub integration]




[[Category: Zenitel Connect]]
[[Category:Zenitel Connect Integrations]]
[[Category:3rd party integration]]