My2N/KONE integration

This guide will show the step-by-step configuration of the integration between My2N and KONE clouds from the side of My2N.

1)For that, you need to connect My2N with the KONE cloud with Postman

Go on your Command Prompt (cmd) and push the following command:

curl "https://my2n.com/middleware/api/my2n/auth" -H "content-type: application/json" --data-raw "{\"password\":\"xxxxxxxx\",\"username\":\"xxxxxxxxxxx\"}"

Instead of following "xxxxxxx", please write down your login password (1) for my2n and the login email address (2) used for it

You will get in the response, an Access Token you will have to copy (Ctrl C) (3):

Kone should have provided you with the building Ids (1) and the secret (2) used in command 2, you will have to find your CompanyId (3) and siteId (4)in the site's URL as below

You are ready for the next and last command :

curl -X "PUT" "https://my2n.com/middleware/api/partner/v1/companies/xxxx/sites/xxxx/elevator-integration/link" -H "Content-type: application/json" -H "x-api-key: xxxxxxxxx" --data-raw "{\"buildingIds\":[\"xxxxxxxxxx\"],\"secret\":\"xxxxxxxxxxx\"}"

Instead of the "xxxxxxxxx" in the x-api-key header paste the API key you got from the previous command (5) and the building ID and secret received from KONE.

Finally, you are logged in and ready to start the integration

2) Create an apartment on the My2N site. Go to the section apartments -> click on the option create apartment -> give it a corresponding floor, number and name it -> click on the option create apartment.

3) Go to the site settings -> elevator integration. By default, the integration is enabled. Here, choose the corresponding elevator core and destination. You can enable/disable Landing Call and Destination Call on this page as well. Click on the option save changes at the bottom right corner to make the changes. 

The Destination call and the Landing call can be configured separately for each user and intercom. For the specific user in the section site users -> access -> Elevator integration. 

For the specific intercom in the section devices -> access -> Elevator integration.

4) Activate the elevator integration on the intercom. Go to devices -> click on the intercom ->

add the intercom to the corresponding apartment -> go to the section access ->

Click on the option set integration -> choose the corresponding elevator core and destination. You may also set up the distance to elevator which changes the waiting period of the elevator. The period can be set up to 30 seconds long. For example, if the elevator is further from the entrance, you can configure the longest waiting period. Click on the option Save settings. 

When the icon under the integrations tab is blue, it means that the elevator integration is active on the intercom.

5) Create an access group. Go to the section access settings -> click on the option create access group -> name the group > click on the option create group.

6) Configure the created access group. Click on the created group.

Firstly, go to the devices section -> click on the option add device to group -> select the device -> click on the option add to group.

Secondly, go to the users section -> click on the option add users to group ->

 Select the user or create a new one-> click on the option add to group.

Lastly, go the apartments section -> click on the option add apartment to group ->

Select the apartment or create a new one -> click on the option add to group.

7) Add the user to the apartment as well. Go to the section apartments -> click on the correct apartment ->

Go to the section users -> click on the option add users -> select the user -> click on the option add users.

8) Add credentials to the user in the section site users. You may use a PIN code, RFID card/key fob, and My2N app access. 

After all these steps are completed, you have successfully configured the integration.