Howto:PresenceHeartbeat - MediaRunway - Partner App

Product Name

MediaRunway Presence Heartbeat

Vendor

MediaRunway is an ITC enterprise that provides its customers with contemporary IT services in all areas - Your business, our solution.

MediaRunway - About us

Description

Presence Heartbeat could change the presence state depending on the MS Windows login state. So the app could automatically change the presence color and the presence text with a preset when the Windows screen lock is activated and unlocked again, as well as when Windows logs on and logs off/ shutdown. This works on the local Windows PC as well as in a Windows Terminal session. But also other triggers are possible, for example from Systems like macOS.

MediaRunway - About this application

Functions

The Presence Heartbeat App has three parts and needs an external trigger:

1. App service, which listen on a specific URL for HTTPS POST input

2. Admin app where you could configure how to react to a specific for example Windows State (Login/Logoff). In the Admin App you could also do the licensing

3. User app, where a user could manually click on a button to set his/her presence state to the configured one in the admin app. If the user didn´t need the app, you could decide to don´t deliver this app to the users

Because the myApps client has no knowledge of the actual MS Windows state of a user, an external trigger is needed. Here are two examples to do a trigger.

1. With curl you could do a group policy in the MS Windows Active Directory which send the specific curl command to the listening app service url (1) for Login / Shutdown

2. To react to the MS Windows lock screen states you can get a mini .exe file from MediaRunway

How to configure these two examples is explained in the "Configuration" section of this wiki article.

Licensing

Licensing: One license per user with any number of devices for one instance of the app. No floating licensing, only the users who got a configured license have access. For licensing and test licensing please contact myApps-sales@mediarunway.com.

• Example: "Hello MediaRunway, we would like to purchase the Presence Heartbeat app. Here is our authentication key 1113335557, we have only one app instance. A one year license for 10 users would fullfill our needs. Please send us the license key as fast as possible. Best reagards"

Enter license key and activate user license: Simply enter the license key that you received from us and press "Confirm". After that, you should see the valid date of your license and the number of available user licenses. Next to the desired user name, activate or deactivate the user's license.

Prerequisites

The webserver of the innovaphone myApps app platform must be reachable from the clients. That should be ready with the normal installation procedure of an innovaphone V13 system. But two things we want to highlight:

1. we recommend that the app platform is reachable by DNS, then only ip

2. we recommend that the app platform is reachable from WAN by https through reverse proxy with a certificate which could correct trusted by the windows client (the sender of the trigger) (so please do not use a self signed certificate which is not known by the client)

If the trigger should be done by curl, that curl works on the system (for example the windows client or windows terminalserver) which should do the trigger. The newer versions of Windows have curl build in, but on older versions you have to install curl.

Versions

Compatible innovaphone firmware versions

• MediaRunway PresenceHeartbeat 1.0 (132xxx sr18, 133xxx final)
  • innovaphone V13r2
  • innovaphone V13r3

Application versions used for interop testing

• MediaRunway PresenceHeartbeat 1.0 (132xxx sr18, 133xxx final)
  • innovaphone IPVA V13r2sr18
  • innovaphone IPVA V13r3final

Configuration

Here you could see the functions of the admin app, which shows you the url and the api key, and what you could configure in the admin app:

For security reasons, we recommend to refresh the api key regularly with the button at the end of the api key line. NOTE that if you refresh the api key in the admin app, that the api key must then also be exchanged in the configured triggers on the client side!

If an IP address is displayed in the URL instead of DNS, the innovahone system is not fully configured for DNS.

Why you could decide to not override specific presence states? Because if a user has set her/his presence state for example to "away" with the presence text "holiday", then you maybe don´t want to override this setting from the user if he shutdown his computer. But if the user has set "dnd" with text "online meeting", then you want to override the presence state of this user if he shutdown the computer.

For licensing please read the topic "Licensing" in this wiki article. If you have got a license and activate it here in the admin app, you can search for users and license the user with the switch at the end of the showed user list entry. If the switch is green, then the user is licensed. For licensing you didn´t need to click on a save button or something else. Each switch change do directly the licensing of a user.

Here you could see the functions of the user app, with the buttons to set manually the configured presence states in the admin app:

Installation

After installing the App, adding the App instance and the App Object for the users, one can start using "PresenceHeartbeat". The steps of the installation process are the same as described in this article "Callback - Install App from App Store" only with different names.

PBX manager settings

Checkmark your users config while adding the object.

Contact

MediaRunway GmbH & Co. KG

Venloer Str. 8

D-41569 Rommerskirchen

Tel: +49 2183 80628-0

Mail: myApps-sales@mediarunway.com

Support: myApps-support@mediarunway.com

Website: MediaRunway.com

For any questions please refer to our contact page.