Channeling API - add ability to get list of rooms and users

[PeterEdens]

Currently it is possible only to get a list of users in the current room, we would like to be able to show the available rooms and also the users who are in those rooms. If this can be added to the Channeling API then we can add this capability to our app. So when the Channeling API receives an empty 'Room' document it sends back a document containing a list of all room names. The Users API can be expanded to accept a roomName parameter in the document to return the list of users for that room.

[fancycode]

It would be possible to implement an API for that, but this is a major privacy issue: any user would be able to see who also is online / in the same room with somebody else. Also people would be able to join the rooms they find out through this API and can see the room chat or automatically join calls in conference rooms.

I strongly advise to not provide such an API.

[PeterEdens]

Using a PIN on a room would prevent people from joining a room, or a new attribute could be created to allow rooms to be marked as private or public. Currently a user can enter rooms by typing the name so they can enter any room or conference and see the room chat by guessing the name, a PIN is still required to protect privacy.

An example for use of this API would be if a business has several rooms and they want to see when a customer has joined the room before they enter the room. Another use case is to be able to see who is online or in the same room with somebody else, so if for example the marketing manager is meeting with the sales manager the general manager can see that they are online and join the room.

To get someone to join a room external tools must be used to send a link to the room or a message to ask them to join the room but if a list of online users is available through the room list then a message could be sent directly to the user to ask them to join the room.

This API could also be enabled/disabled through a setting in the config to protect privacy.