View Source

Integration of 2N intercom Helios IP with Wildix

<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = 'https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.11';
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>

<span class="page-title-pdf">Integration of 2N intercom Helios IP with Wildix</span>

<div class="fb-like" data-href="https://confluence.wildix.com/x/qADwAQ" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>

 <div class="lang-box-pdf">
	<div>
		<div class="google-lang">
			<div id="google_translate_element">
			</div>
			<script type="text/javascript">
					function googleTranslateElementInit() {
						new google.translate.TranslateElement({pageLanguage: 'en', includedLanguages: 'de,es,fr,it,nl', autoDisplay: false}, 'google_translate_element');
						}
			</script>
			<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
		</div>
		
		<div class="pdf-button">
			<a href="https://confluence.wildix.com/spaces/flyingpdf/pdfpageexport.action?pageId=32506024" alt="Convert to .pdf" title="Convert to .pdf"><img src="https://confluence.wildix.com/download/attachments/14549012/pdf-button-download-wildix-documentation.png"></a>
		</div>
	</div>
</div>

This document explains how to set up the integration of 2N intercom Helios IP with Wildix IP PBX.

Updated: November 2021

Permalink: https://confluence.wildix.com/x/qADwAQ

Step 1: WMS Configuration

1. Add a new user (intercom user)

Go to WMS -> Users and click on + to add a new user:
Fill in the fields:
- Full name: name of the user
- Extension: extension number used by the intercom
- Dialplan: select the Dialplan procedure used by the intercom* (“users” by default)
- License type: select Basic

Documentation > Integration of 2N intercom Helios IP with Wildix > WMS-create-user-2N Helios IP Base.png

2. Create a Dialplan procedure to manage calls from the intercom

Go to WMS -> Dialplan -> Dialplan rules and add a new procedure, example:

Documentation > Integration of 2N intercom Helios IP with Wildix > WMS- create 2N Helios Dialplan.png

Where:

500: is the phone number called from the intercom
Call group (support): is the call group that receives calls from the intercom (it can be an extension, several extensions, or several call groups…)
Note: you can also add "Dial the phone" application instead of "Call group" and set a specified extension.

Go to WMS -> Users, select the intercom extension and select the newly created Dialplan procedure to be used for outgoing calls

Documentation > Integration of 2N intercom Helios IP with Wildix > WMS-assign Doorphone Dialplan.png

Note: In case you don’t want to create a new procedure, you can add Number and Application to the Dialplan procedure used by the intercom (“users” for example).

Step 2. Intercom configuration

1. Connect to the web interface

Recommended browsers: the latest version of Chrome, Firefox or IE 9+.

To be able to connect, you have to know the IP address released to the intercom by the DHCP server used in your network (router or PBX).

First time access credentials: admin : 2n.

Note that upon your first login you are advised to change the default password.

Documentation > Integration of 2N intercom Helios IP with Wildix > Screen Shot 2018-12-24 at 17.07.29.png

2. Check for updates

Go to System -> Maintenance
Click Check Now (Check Firmware Online) to check if there is a new firmware version available and to update the intercom:

Documentation > Integration of 2N intercom Helios IP with Wildix > Screen Shot 2018-12-24 at 17.08.15.png

Note: Update process takes around 30 seconds. During the update procedure the intercom is restarted.

3. SIP Server Setting

Go to Services -> Phone -> SIP 1
Fill out the fields as described below:

Documentation > Integration of 2N intercom Helios IP with Wildix > word-image-120.png

Important: use the SIP password of intercom extension, not the WEB password!

How to generate the SIP Password:

Go to WMS -> Users and select the intercom extension (409 in our example)
Click Set passwords
Click on Generate near SIP/VoIP, then click Ok (copy this password from WMS and paste it into the field SIP/VoIP Password)

Documentation > Integration of 2N intercom Helios IP with Wildix > 2N-generate-SIP-pass.png

Go to WMS -> Users

Check that the intercom is successfully registered to the system:

Documentation > Integration of 2N intercom Helios IP with Wildix > 2N registration.png

Note: status of the user is green which means that the intercom is successfully registered; focus the mouse on the status to see device’s name, IP address and the transport method.

Go back to the intercom web interface, Services -> Phone -> Audio:

Enable the option SIP INFO (RFC-2976) in DTMF Receiving section and click Save:

Documentation > Integration of 2N intercom Helios IP with Wildix > Screen Shot 2018-12-24 at 17.11.24.png

4. Quick Dial Button Setting

The intercom is equipped with quick dial buttons. Pressing a quick dial button places a call to the specified phone number.

Go to Directory -> Users -> Position 1 (position 1 corresponds to quick dial button 1)
Fill the fields Name and Phone Number and click Save:

Documentation > Integration of 2N intercom Helios IP with Wildix > Screen Shot 2018-12-24 at 17.11.55.png

5. Electric Lock Switching Settings

An electric lock can be attached to the intercom and controlled by a code dialed from Wildix IP phones.

Go to Hardware -> Switches -> Switch 1
Enter the code, for example “1234” under Switch Codes section and click Save:

Documentation > Integration of 2N intercom Helios IP with Wildix > word-image-122.png

Make sure the box “Legacy Switch Code” is activated in Advanced Settings section. When this box is checked, the first code listed above does not require confirmation by pressing “*” from the phone. If the box is not check, it might be necessary to press “*” from the phone to confirm the door opening.

Documentation > Integration of 2N intercom Helios IP with Wildix > 2N-Legacy Switch Code.png

6. JPEG Streaming Settings (required only for W-AIR Handsets)

Configure the compression level of jpeg streaming to download images from the intercom.

Go to Services > Streaming > JPEG > set JPEG Compression Level to 60:

Documentation > Integration of 2N intercom Helios IP with Wildix > 2N-W-AIR-configuration.png

Step 3. Door open function from Wildix IP phones/ Collaboration

Go to WMS > Dialplan, select the procedure used for outgoing calls by the intercom extension (“doorphone” in our example).

You can open the door from any Wildix device, including WP, W-AIR, Web phone by answering a call and entering a code specified in Electric Lock Switching Settings of the intercom, in the format: *[code]#, in our example: 1234.

Unlock button for WP600AXX / Vision/ SuperVision/ Collaboration

You can add an unlock button on WP600AXX/ Vision/ SuperVision/ Collaboration, allowing you to open the door from the call management window.

Go to WMS -> Dialplan and add Custom Application to the Dialplan procedure used by the intercom SIPAddHeader(Unlock-Button:), for example:

SIPAddHeader(Unlock-Button:*1234#), where “1234” is DTMF.

Here is what Unlock button looks like on Vision and in Collaboration

Documentation > Integration of 2N intercom Helios IP with Wildix > 2N-video-preview.png

Video streaming before answer on WP600AXX / Vision/ SuperVision/ Collaboration / Android App

You can display an incoming video stream before answer on WP600AXX/ Vision/ SuperVision/ Collaboration/ Android mobile application:

Go to Services > HTTP API (2N® Helios IP web interface)
Enable Camera API and choose Unsecure (TCP) Connection type and Basic authentication, click Save:

Documentation > Integration of 2N intercom Helios IP with Wildix > Screen Shot 2018-12-24 at 17.13.42.png

Go forward to the next tab Account 1 and check the box “Account Enabled”
Fill in User settings: User name and password and click Save

Documentation > Integration of 2N intercom Helios IP with Wildix > Screen Shot 2018-12-24 at 17.14.03.png

Go to WMS -> Dialplan and add Custom application to the Dialplan procedure used by the intercom SIPAddHeader(Camera:), for example:

SIPAddHeader(Camera:http://409:admin@10.100.4.133/api/camera/snapshot?width=1280&height=960)

Where:

409:admin – User name and password for access to the intercom, set up in Services > HTTP API > Account 1

10.100.4.133 – IP address of the intercom

Note in case of a Cloud PBX: If the callee's device is on the same local network as the intercom, use the intercom's private IP address, otherwise replace it with the intercom’s public IP address.

Also, redirecting the port 80 towards the intercom will be needed if public IP address is used.

/api/camera/snapshot – function which allows downloading images from an internal or external IP camera connected to the intercom
width=1280&height=960 – video resolution

Dialplan example with Unlock button and Video streaming before answer

Documentation > Integration of 2N intercom Helios IP with Wildix > Screen Shot 2018-12-24 at 17.14.26.png

Where:

“500” – is the number specified in the quick dial button menu of the intercom (the number called by the intercom)
“Custom application” – SIPAddHeader(Unlock-Button:*1234#) – adds unlock button to call dialog
“Custom application” – SIPAddHeader(Camera:http://409:admin@10.100.4.133/api/camera/snapshot?width=1280&height=960) – enables video preview before answer

NOTE: use “http” connection mode, not “https”!

“Dial the phone” – 115 – is the call destination for answering calls from the doorphone; you can specify your own destination (an extension, several extensions, a call group…)

JPEG streaming on W-AIR Handsets

Supported handsets: W-AIR LifeSaver, W-AIR Office and W-AIR Med.

Before proceeding, make sure you set the necessary compression level in JPEG Streaming Settings
Modify the Dialplan procedure used by the intercom by adding the Custom application:

SIPAddHeader(Call-Info: icon="<http://10.100.4.133/api/camera/snapshot?width=160&height=120&source=internal&pic=cam.jpg>")

Where:

10.100.4.133 – IP address of the intercom

Note in case of a Cloud PBX: If the callee's device is on the same local network as the intercom, use the intercom's private IP address, otherwise replace it with the intercom’s public IP address.

Also, redirecting the port 80 towards the intercom will be needed if public IP address is used.

/api/camera/snapshot – function which allows downloading images from an internal or external IP camera connected to the intercom
width=160&height=120 – video resolution
source=internal – parameter defining that the video source is from internal camera

Starting from W-AIR firmware v 0520b1 (released in WMS 5.02), it is also possible to set Refresh soft button that can update the jpeg image preview upon receiving a call from the doorphone.

For this purpose, set Custom applications:

Custom application -> SIPAddHeader(Alert-Info: info=doorbell:*120) - adds Refresh button
Custom application -> SIPAddHeader(Call-Info: icon="<http://10.100.4.133/api/camera/snapshot?width=160&height=120&source=internal&pic=cam.jpg>")

The configuration can also be set for 2N Helios IP Verso/ Solo/ Vario/ Force/ Video Kit.

Dialplan example:

Documentation > Integration of 2N intercom Helios IP with Wildix > 2N Dialplan example.png

Troubleshooting

No video in case of external call to intercom 2N

Problem: no video for calls made from device whose IP is not in the same network with the intercom

Solution: disable DirectRTP via Dialplan for such calls (Dialplan application "Set" - "DirectRTP" - "no")

<div class="fb-like" data-href="https://confluence.wildix.com/x/qADwAQ" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>

<div class="ask-question">
		<div class="text-before-buttons">
			<span style="font-size: 24px; text-align: center;">Not finding the help you need?</span><br>
Join the Facebook group to ask a question!
		</div>
<div class="fb-buttons">
<span style="align: center;"><a href="https://www.facebook.com/groups/wildixtechwizards" target="_blank"><img src="https://manuals.wildix.com/wp-content/uploads/2017/03/facebook_tech-wizards.png" alt="facebook_tech-wizards" width="282" height="80" align="center"/></a></span></div>
	</div>
</div>