This is a working demo of how the Webex devices can be used for visitor registration in lobbies and receptions. The kiosk let's a user walk up and register themselves. A Webex message is then sent to the host.
It is meant as a demo to illustrate how the user experience will be like, but it can easily be extended or used as a basis for your own visitor registration if you want. Just fork the Git repository and go wild with it.
- Recommended usage is kiosk mode, where the rest of the RoomUI is hidden, for a focused user experience
- Allows user to search the Webex org to tell which host they are visiting
- Photo booth with camera access, so host can see who is visiting
- The kiosk sends a message with name as well as photo of the visitor
If you want to use a visitor kiosk in a real-life situation, you typically also need:
- To save the registration from the kiosk to your company's offical registration system
- To print a badge for your visitor
The kiosk can easily be extended to do this. Since every company typically has their own system for this, you will need to make this particular glue code yourself.
The typical device to use for a kiosk is a device with touch screen such as:
- Cisco Desk Pro or Desk
- Cisco Desk Mini
- Admin access to the device, either local admin access or through Control Hub
It's also possible to use a Cisco Board, but it might be a bit too large for the use case.
To allow the kiosk to search your organisation for hosts, you need a bot in that organisation. This is very simple, a bot is just a generic and can be created on developer.webex.com in a few minutes:
- Go to developer.webex.com
- Log in
- Tap your own profile in the top right corner, select My Webex Apps
- Create new app > Create a Bot
- Fill in the bot details as you wish, for example
- Bot name: Visitor Bot
- Bot username: visitorbot
- Find an icon you like
- Save
- Copy the bot access token. You will use this in the kiosk to search for hosts.
That's it. Keep the bot access token somewhere safe. If you loose it, you can just go to developer.webex.com again and re-generate a token.
There are three ways you can provide a kiosk on your Cisco device:
- In kiosk mode
- As digital signage
- As a web app
In all cases, you must provide the URL to the web view. Include the bot token so you can search for hosts and send messages like so:
https://cisco-ce.github.io/roomos-samples/visitor-kiosk/?token=YOURTOKEN
Replace YOURTOKEN with the token you created above.
To set the registration app in kiosk mode, set the following:
xConfiguration UserInterface Kiosk URL: https://cisco-ce.github.io/roomos-samples/visitor-kiosk/?token=YOURTOKEN
xConfiguration UserInterface Kiosk Mode: On
For more details and setup tips on kiosk mode, see Webex Help Center: Kiosk mode.
Remember: You can tap three times with three finger to bring up the device's settings menu.
In kiosk mode, the user will only be able to use the device for the the visitor registration, not for other use cases. If you still want the phone book, home screen, other web apps etc, you can use signage mode instead. Then the visitor registration will be the default screen, but users can still close it and go to the normal device home screen.
xConfiguration Standby Signage Mode: On
xConfiguration Standby Signage https://cisco-ce.github.io/roomos-samples/visitor-kiosk/?token=YOURTOKEN
xConfiguration Standby Signage Audio: On
xConfiguration Standby Signage InteractionMode: Interactive
xConfiguration Standby Delay: 120
It is then recommended to also add a UI extensions button to set the system back in halfwake, so user's dont need to wait (typically 2 minutes) for the system to go back to the signage state.
By default, users need to give the web app access to the kiosk each time it takes a picture. To automatically grant access to this particular web app, you can set the following xAPI:
xcommand WebEngine MediaAccess Add Device: Camera Device: Microphone Hostname: cisco-ce.github.io