2N HTTP API

Avatar
Ricardo Pinto
  • updated

Hello,


I was asked a challenge, about a 2N Doorbell installed recently.


I'm using both relay and output on the 2N unit, so I don't have any outputs available to do the following:


The client is asking if it's possible to ring an outside bell on the garden, when the 2N doorbell is ringing.


According to the 2N HTTP API, section 5.71 api call status, it looks like it's possible.


My goal would be to intercept the "ringing" state and therefore turn an KNX output with a bell for some seconds, or pulse the output to simulate bell ring.


I could constantely pool /api/call/status, but has someone a better ideia?


Right now I'm testing with a Http node, pooling the "result.sessions[0].calls[0].state" or "result.sessions[0].state" tokens, and I can get the string "ringing" as result. The problem is that after the call hang up the string remains. I was expecting the string to be empty after the call hang up, and according to the Json response is in fact empty.


Idle mode:


{

        "success": true,

        "result": {

               "sessions": []

         }

}


Ringing:


{

        "success": true,

        "result": {

              "sessions": [

                    {

                           "session": 45,

                           "direction": "outgoing",

                           "state": "ringing",

                           "calls": [

                               {

                                       "id": 89,

                                       "state": "ringing",

                                       "peer": "sip:MY_ID1@192.168.1.12"

                               }

                           ]

                    }

              ]

        }

}


Has anyone used the 2N API for this case or similar that can help out?


Best regards

Replies 10
Avatar
0
Tanel Matsi

Few weeks ago I saw a video about integration of bOS and 2n new version, but I am not able to find it any more. Can someone help my finding the video tutorial.

Avatar
0
Ricardo Pinto
Quote from Jürgen Jürgenson

I still don't own any iOS devices, so I haven’t had a chance to test it further. It was a long time ago when I added it. I believe it only opens the App Store link for My2N. Interestingly, even though the app name in the link is quite old, it still works...


I'm struggling to find the iOS app links for several apps, and they are not public.

And sending e-mail do the app developer turns out to be a dead end.

I know that this can be circumvented with iOS Shorcuts, but it needs client intervention.

Thanks

Avatar
0
Jürgen Jürgenson
Quote from Ricardo Pinto

Btw Jürgen,

I've been struggling a lot with some url links regarding iOS. Android is pretty straightforward to get the Android Program Name, as for iOS it depends on the programmer, as the launch url is more difficult to find.

I've noticed that in this 2N example you're using itms://apps.apple.com/us/app/2n-mobile-video/id1188403431

As I am not an iOS user, what does it happen? It opens the app right away, or just opens the iTunes link for the app so you can download or execute?

Thanks

I still don't own any iOS devices, so I haven’t had a chance to test it further. It was a long time ago when I added it. I believe it only opens the App Store link for My2N. Interestingly, even though the app name in the link is quite old, it still works...

Avatar
0
Ricardo Pinto
Quote from Ricardo Pinto


Humm that would be awesome! :D

Btw Jürgen,

I've been struggling a lot with some url links regarding iOS. Android is pretty straightforward to get the Android Program Name, as for iOS it depends on the programmer, as the launch url is more difficult to find.

I've noticed that in this 2N example you're using itms://apps.apple.com/us/app/2n-mobile-video/id1188403431

As I am not an iOS user, what does it happen? It opens the app right away, or just opens the iTunes link for the app so you can download or execute?

Thanks

Avatar
0
Ricardo Pinto
Quote from Jürgen Jürgenson

You can add a "Start Program" shortcut on the bOS main page to open the My2N app. I think they are working on webRTC/SIP again so hopefully soon  2N-Control.bos


Humm that would be awesome! :D

Avatar
0
Jürgen Jürgenson
Quote from Bluint Lda

Good morning

Do you have a 2N installed and working in confortclick? I don´t see that brand in the config but i would like to install one in one of my clients.

You can add a "Start Program" shortcut on the bOS main page to open the My2N app. I think they are working on webRTC/SIP again so hopefully soon  2N-Control.bos

Avatar
0
Bluint Lda

Thank you for your feedback

Avatar
0
Ricardo Pinto

Hello.

bOS app is not compatible with audio. So, you can implement image viewing of the doorbell, relays control, probably even get some sort of notifications if you work with 2N Automation (like I did on my example above, despite not being about notifications but 2N communicating with bOS), but not the audio, so you won't be able to talk to the person on the doorbell.

Best regards

Avatar
0
Bluint Lda

Good morning

Do you have a 2N installed and working in confortclick? I don´t see that brand in the config but i would like to install one in one of my clients.

Avatar
1
Ricardo Pinto

Hey!!! I think I got the solution.

2N now as an incredible webpage inside the unit, called "Automation".

I was able to fire up events from ringing and terminated, via RPC to bOS. Hohoooo!

Image 5143

If anyone needs something like this... here's the information.

I think you may need to have the HTTP API license. In my case the unit came with the full license.

I just had to create two different states, otherwise the boolean would stay as true. As soon as the call is terminated, the boolean is set to false. Now I'm going to play with it!

Best regards


Customer support portal powered by UserEcho