View source for Setting up AlphaCom integration

[[File:Alphacom integration 1.png|thumb|right|400px|AlphaCom integration]]

This article will explain how to setup and configure basic AlphaCom integration on a Exigo system.

Exigo and AlphaCom is integrated with each other using SIP.<br>
The basic use cases for this integration is to do public announcement form the intercom and include intercoms in alarm distribution from Exigo.

 {{Note}} '''Before you start configure it is important that all devices have been updated to the latest software/firmware. <br>          Use only software/firmware from the same Exigo package.'''

== Configuration Overview ==
Exigo Management Tool (EMT) is used for setting up the integration in Exigo.
[[File:Alphacom integration 2.JPG|thumb|left|500px|EMT]]
<br style="clear:both;" />

AlphaPro is used for setting up the integration in AlphaCom.
[[File:Alphacom integration 3.JPG|thumb|left|500px|AlphaPro]]
<br style="clear:both;" />
The Web interface is used for all devices.

From Exigo there is two types of actions defined:
* '''Action Calls''' - from AlphaCom to Exigo.
* '''AlphaCom features''' - from Exigo to AlphaCom.

Exigo will use numbers from '''98001''' and upwards to start activities in Exigo on incoming activities.
Outgoing from Exigo can define any number.
[[File:Alphacom integration 4.JPG|thumb|left|500px|Action Calls and AlphaCom features]]
<br style="clear:both;" />
What the different directory numbers will trigger in the AlphaCom system is based on the configuration of the AlphaCom.

== AlphaPro Configuration ==
Basic configuration on the AlphaCom contains two steps:
* Define and map IP addresses to the Exigo Node (the Exigo controller).
* Define and set up the group which Exigo should call.

=== Step 1. Define and map IP addresses to the Exigo Node ===
Select '''Create Exchange''' to create the Exigo SIP node in your AlphaCom system:
[[File:Alphacom integration 5.JPG|thumb|left|500px|AlphaPro - Create exchange]]
<br style="clear:both;" />

Set the IP adress for the '''Exigo PSC''' as the '''SIP Trunk Line''':
[[File:Alphacom integration 6.JPG|thumb|left|500px|AlphaPro - Set the Exigo PSC IP address as the SIP Trunk Line]]
<br style="clear:both;" />

Set up Net Routing:<br>
Go to '''Exchange & System''' -> '''Net Routing''':
[[File:Alphacom integration net routing 1.JPG|thumb|left|600px|AlphaPro - Setup the Net Routing]]
<br style="clear:both;" />
Select '''Insert''':<br>
Select the Exigo node:<br>
[[File:Alphacom integration net routing 2.JPG|thumb|left|400px|AlphaPro - Setup the Net Routing]]
<br style="clear:both;" />
Select ACDP Link: SIP Link (31) <br>
Also tick of Exigo Node <br>
[[File:Alphacom integration net routing 3.PNG|thumb|left|500px|AlphaPro - Setup the Net Routing]]
<br style="clear:both;" />
Press '''OK'''.

=== Step 2. Defining Directory Numbers === 
The next step is to add the directory numbers which are used in Exigo. These numbers are from '''98001''' to '''98099'''.<br>
Select Directory and Features:
[[File:Alphacom integration 7.JPG|thumb|left|500px|AlphaPro - Directory and Features]]
<br style="clear:both;" />
Here you need to add the number of directory numbers/'''Action Calls''' you need.<br>
Add a directory number '''98001''' with '''feature number 9 (Call a User)'''.<br>
[[File:Alphacom integration 8.JPG|thumb|left|500px|AlphaPro - Directory and Features]]
<br style="clear:both;" />
This will give you a number that are automatically in All Call 84, and can also be added to groups.<br>
Give the '''Directory Number''' a descriptive text in '''Display Text'''.<br>  
The '''User''' will look like this:
[[File:Alphacom integration 9.JPG|thumb|left|500px|AlphaPro - User]]
<br style="clear:both;" />
Check the '''SIP Station''' box.<br>
The '''Related to Trunk''' must be set to the correct Exigo SIP Trunk.

== EMT Configuration ==
There is 3 main configurations that needs to be done in EMT: 
* The AlphaCom node needs to be added. 
* '''Actions Calls''' and 
* '''AlphaCom features''' also needs to be configured.

=== Step 1. Add the AlphaCom node ===
First step is to add the AlphaCom node to the system.<br>
In Components view expand the '''External Devices'''.<br>
Drag the AlphaCom to the '''System''' -> '''Integration''':
[[File:Alphacom integration 10.JPG|thumb|left|500px|EMT - Add the AlphaCom node]]
<br style="clear:both;" />
Type in the '''IP address''' of the AlphaCom.

=== Step 2. Action Calls ===
For the AlphaCom to trigger features in the Exigo system one or more '''Action Calls''' needs to be added.<br>
In Components view expand '''External Connections'''.<br>
Drag '''Action Call''' to '''System''' -> '''Integration''' -> '''Action Calls''':
[[File:Alphacom integration 11.JPG|thumb|left|500px|EMT - Add Action Call]]
<br style="clear:both;" />

Then you can add input action to the '''Action Call'''. We will use '''Live Speech''' in this example.<br>
In Components view expand '''Input action'''.<br>
Drag '''Live Speech''' to '''System''' -> '''Integration''' -> '''Action Calls''' -> '''980xx''' -> '''On Connect'''
[[File:Alphacom integration 12.JPG|thumb|left|500px|EMT - Add Live Speech]]
<br style="clear:both;" />
In the pop up select:
* '''Activation''': Start.
* '''Destination''': The zones you want the Live Speech.
* '''Priority''': Default priority is 50.
* '''Chime''': Select the desired chime.
Press '''Done'''.<br>
To make the '''Live Speech''' stop you also need to program '''Live Speech''' on disconnect.<br>
This needs to have '''Activation''': Stop.

=== Step 3. AlphaCom Feature ===
Adding an '''AlphaCom Feature''' allows Exigo to trigger activities in the AlphaCom.<br>
In Components view expand '''External Connections'''.<br>
Drag '''Action Call''' to '''System''' -> '''Integration''':
[[File:Alphacom integration 13.JPG|thumb|left|500px|EMT - Add AlphaCom Feature]]
<br style="clear:both;" />
Each '''AlphaCom Feature''' relates to one feature number, typically a group number such as 85, 86 and so on.<br>
In this example we will use the group number 85 to trigger a group call in AlphaCom.<br>

Each '''AlphaCom Feature''' can  be assigned to different zones in the system.<br>
Best practice is to have a dedicated zone for the AlphaCom.<br>
Add a new zone to the system and give it an descriptive name (for example AlphaCom).<br>
Drag '''AlphaCom Feature''' to the new zone:
[[File:Alphacom integration 14.JPG|thumb|left|500px|EMT - Add AlphaCom Feature to the Zone]]
<br style="clear:both;" /> 

 {{Note}} '''Changes to SIP configuration require a reboot of the Exigo System Controller.'''

The group call from Exigo need to be adjusted on the AlphaCom.<br>
In this example we have used group 85.
[[File:Alphacom integration 15.JPG|thumb|left|500px|AlphaPro - Configure group 85]]
<br style="clear:both;" />
Exigo does not have an M key, and the group should therefore be set to '''Automatic M-key'''.<br>
Best practice is to let the Exigo system control the gong. The AlphaCom group should therefore have '''No Gong''' set.<br>
Be sure to include the members that you want to be part of the group.<br>
The Exigo - AlphaCom integration should now work.

== Group Calls from AlphaCom to Exigo ==
It may be useful to use Group Call to call from AlphaCom to Exigo. <br>
In order to make this work SIP Stations must be allowed in Group Calls. 
[[File:Alphacom integration group call 1.PNG|thumb|left|500px|Allow SIP Stations in Group Calls]]
<br style="clear:both;" />
In '''Exchange & System''' -> '''System''' -> '''VoIP''' <br>
Tick of '''Allow SIP Stations in Group Calls and as default speakers in SX Conference''' <br>

In the Group Call to Exigo the Automatic M-key must be ticked of. <br>
[[File:Alphacom integration group call 2.PNG|thumb|left|500px|Automatic M-key]]
<br style="clear:both;" />
Automatic M-key from all stations (or alternative Automatic M-key only from SIP calls).

== Exigo - AlphaCom Priorities ==
Exigo has 100 priorities while AlphaCom and SIP has 4.<br>
Outgoing activities from Exigo will be translated based on a priority mapping:
[[File:Alphacom integration 16.JPG|thumb|left|500px|EMT - Priority Mapping]]
<br style="clear:both;" />

== Control output: Audio activity ==
[[External Audio Sources | '''External Audio Sources''']] is used to make a control output trigger on an specified external audio source.<br> 
External audio sources can be a station in an AlphaCom system or a station in a SIP system which is integrated into Exigo.<br>
An [[External_Audio_Sources|'''external audio source''']] must be defined in the Exigo system. This will be handled as any other source and can then be used to trigger control outputs depending on the [[Audio_Activity|'''audio activity function''']].

== Availability ==
This function is available from Exigo 1.3 and newer.


[[Category:Getting started]]
[[Category:Integration]]