Getting A List of Active Users in Unity Intercom

At my church, we use Unity Intercom to expand our wired intercom system. It is very useful to have users who can be mobile and still stay in communication.

We wanted to have the ability for our directors to see who is currently logged into Unity without having to log into the server or be logged into a Unity client on a device.

After doing some digging and consulting the forums, I found out that if you go to this address:

http://unityserverIPaddr:20101/userconfig

The Unity server will return a JSON dataset of the server information including the list of users.

"users":[{"username":"josephadams", "title":"Joseph Adams", "allowedrcv":"63", "online":"0", "notify":"yes", "locksettings":"no", "lockchannels":"no", "groups":[{"groupNumber":"0", "transmit":"63", "receive":"63"}]},{"username":"technician", "title":"FG Tech User", "allowedrcv":"63", "online":"0", "notify":"yes", "locksettings":"no", "lockchannels":"no", "groups":[{"groupNumber":"0", "transmit":"9", "receive":"63"}]}]

Once you’ve parsed that JSON into objects, you just have to check if the “online” property is 0 (false) or 1 (true) and you now know who is logged in!

I added this to our director’s dashboard so now they can easily see who is available.

Screen Shot 2018-06-12 at 9.10.05 AM

It’s great when we can extend software like this! I wish more software developers exposed REST API’s for their users. Great job, Unity!

2 thoughts on “Getting A List of Active Users in Unity Intercom

  1. I came across your Unity “Active users” dashboard on the Unity Forum. I understand how to retrieve the JSON results, but I do not have the skills to develop an app that can process and display them. All we really need is a list of active users – if there is any ability to show what channels they are listening to (including Program channels) that would be extremely helpful. Anyway you can point me in the right direction?
    Thanks,
    -Mike

    Like

    1. Hey Mike! The current API (that I am aware of, as it’s an undocumented feature) only lists the general information about the channels, groups, users, and program feeds available in the system. You can tell which groups a user is a part of, which in turn you can determine the channels in that group, but the API doesn’t show any active data about the channels a user is currently listening to. It only updates with the online status of a user.

      As far as just viewing a list of active users, you don’t really need to develop an app, you could just view them in a web page. Feel free to reach out to me via the contact form and we could talk about how to make this happen.

      Like

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s