AMAG Symmetry - Zenitel Connect integration

Introduction

The following article explains, step by step, how to set up an integration between Zenitel Connect and AMAG Symmetry 11.

It is assumed that you have installed AMAG Symmetry 11 with valid licenses and Zenitel Connect with a valid license, see below.

Capabilities

• When a call request is made, video surveillance cameras can be moved to the caller’s location and automatically displayed to the Symmetry system operator.
• Incoming intercom calls can be displayed on a graphical map along with all other integrated system elements to allow a unified visual interface for control.
• Intercom stations can be linked through Symmetry to nearby security assets, allowing the system operator to release a door, open a barrier, or take other required actions—easily, even in large-scale systems.
• Incoming intercom calls can be treated as alarms in critical environments.

Compatibility

• Symmetry: 11
• Zenitel Connect: 1.10.0 or higher
• Zenitel devices: firmware 10.0 or higher

Licensing

Zenitel Connect:

• 1 Zenitel Link license is required per Zenitel Connect and AMAG Symmetry system.

Symmetry:

• INTERCOM-KIT – Intercom license for Symmetry. Only one per Symmetry system is required.
• VID-CAM – Video Integration License. One is needed for each Zenitel device camera added to Symmetry.

Configuring the Zenitel Connect Connection

1. Create a Zenitel Link User:

1. Open your browser and enter the IP Address of Zenitel Connect.
2. Navigate to the "System" section.
3. Select "Users".
4. Click on the plus icon, then set the username, role, and password for the Zenitel Link user.

Configuring Zenitel Link user

Configuring AMAG Symmetry

Open the Symmetry Client application and navigate to the Install tab. Select Intercom, then select Client. After the Client dialog opens, click New to add a new Client. In Symmetry, a Client represents an Operator or Reception – a main desk or position for handling calls.

The next step is to navigate to the Install tab, select Intercom, and choose Stations. Add the stations that have been discovered and paired in Zenitel Connect, using the same directory number.

Once you have defined the Client and Station, go back to the Client, navigate to Extended Properties, and click on Connect Pro Configuration. Now you can fill in the fields with the Zenitel Connect data and click the Connect button. After a successful connection, you can select the system Operator, which is the Client you created a few steps earlier. When the connection is established successfully, you can now operate Zenitel Connect devices within AMAG Symmetry.

Connection to Zenitel Connect

After configuration, when you run the Symmetry system, the only thing you need to do to connect is navigate to the Client dialog and the Extended Property tab. If you have a valid configuration, it will trigger an automatic connection to Connect, and you will see the Status as Connected.

Graphics (Map)

Intercom stations can be placed on a graphic, for example a floor plan, together with the other Symmetry devices.

1. Add the graphic: navigate to the Setup tab, select Graphics, then Add, and import the floor plan (Windows bitmap, Windows metafile, AutoCAD DXF or JPEG).

2. Place the stations: navigate to the Setup tab, select Graphics, then Setup, open the graphic and place the intercom stations on it.

3. Show the graphic: navigate to the Home tab, select Monitoring, then Graphics. The station icons show the state of the stations and their calls.

To open the graphic automatically when a station calls, select Auto Display Graphic On Call Request in Maintenance → User & Preferences → User Preferences. The graphic that contains the calling station is shown, provided the Intercom Control screen is not open. From the Intercom Control screen, select the call and click Graphic to show the station on the graphic.

Groups

Public Announcement and Play Message reach the stations through groups. A group is created twice: once in Zenitel Connect, where the audio is sent, and once in Symmetry, where the operator selects it.

1. Create the group in Zenitel Connect: open the Zenitel Connect web portal, navigate to Groups and click the plus icon. Set the Directory Number, Name and Priority, and add the member stations. If the group uses multicast, set the Multicast address of the group.

One group must contain all stations. Public Announcement always goes to that group.

2. Create the group in Symmetry: navigate to the Setup tab, select Device Groups, then Intercoms. Click New, name the group and add the same stations as in the Zenitel Connect group.

The Symmetry group and the Zenitel Connect group must have exactly the same stations. The integration finds the Zenitel Connect group by its members, not by its name.

-> Group Panel

The group functions are on the panel above the stations in the Intercom view. From left to right: the Group drop-down list, the Play Recording button and the Public Announcement button (megaphone).

-> Group

The drop-down list shows the intercom groups created in Symmetry. Select the group the message is meant for before clicking Play Recording; the stations of that group are the ones that hear it. Public Announcement does not use this selection.

-> Public Announcement

Click Public Announcement (megaphone) to open the line from the operator to all intercom stations; click it again to close it. The announcement always goes to the Zenitel Connect group that contains all stations, whatever group is selected in the drop-down list.

-> Play Message

Select the group in the drop-down list and click Play Recording. The Zenitel Play Messages window opens, titled with the selected group, and lists the audio messages stored in Zenitel Connect (Features → Audio Messages) with their directory number, length and number of repetitions. Select a message and click Play (or double-click it); the message is played on all stations of the group. Cancel closes the window without playing anything. Click Play Recording again to stop the message.

Call Handling

Navigate to the Home tab and select Intercom. Now you can operate with Intercoms. When a device has an Online status, you can receive and make calls. Once a call is established, the video from the calling Intercom will be displayed..

Active Call and Features

-> Active Call

-> Forward Call

-> Video Preview

-> Open Door

Troubleshooting

The integration writes its logs on every Symmetry server and client to:

%ProgramData%\Zenitel Connect Pro\
  Zenitel ConnectPro Integration Log\ZenitelConnectPro-v11-SymmetryClient.log
  Zenitel ConnectPro Integration Log\ZenitelConnectPro-v11-smsIntegrationServer.log
  Zenitel ConnectPro SDK\ZenitelConnectPro-v11-sdk-errors.log

The client log (ZenitelConnectPro-v11-SymmetryClient.log) is the one to read first: it holds the calls, the stations and the connection to Zenitel Connect. Passwords are never written to the logs.

The line wamp.error.not_authorized appears on every connection and does not affect the integration.