Skip to main content

Welcome application – configuration and setup guide

This page explains how to set up the Matrix Booking Welcome app when you’re using a Matrix Booking supplied device or your own.

Contents

  1. Introduction

  2. Technical requirements

  3. Install the app

  4. Set up the kiosk user account

  5. Set up the app

  6. Troubleshooting

  7. Network requirements

  8. Device settings

Introduction

Matrix Welcome helps to streamline the reception process and provides an excellent experience for people visiting an office, whether they are external visitors or staff members. The app is integrated with the core Matrix Booking system, allowing visitors to easily enter their details, find their meeting host, accept the terms of visiting, check in, and later check out. The system automatically notifies the meeting host that their visitor has arrived.

The app can also be set up to be used by staff members visiting an office, whether it’s a staff member who regularly works at the office or a staff member visiting from another site. Matrix Welcome supports a wide range of tablet and kiosk devices in both portrait and landscape orientations.

Warning: Matrix Welcome isn’t designed to be run on narrower screens, such as phones.

Technical requirements

Matrix Welcome is an app for iPads and Android tablets. Devices must support:

  • Internet access

  • either:

    • an external keyboard

    • an on-screen software keyboard (provided by the OS).

Android tablets

  • Android tablets with a front-facing camera require Android 8 or higher

  • Android tablets without a front-facing camera require Android 6 or higher

  • we expect a 9” or 10” screen with a 16:9 or 16:10 aspect ratio noting that whilst the app will run on larger screens, it hasn’t been explicitly designed for larger sizes

iPads

  • iOS 11 or higher, including iPadOS 13.1 or higher

  • We expect an iPad with a screen size between 9 and 11 inches (iPad and iPad Air)

Scanning a QR code requires that the device has an internal front-facing camera, which is currently true for supported iPads but not necessarily true for Android tablets. Android tablets without an internal front-facing camera will prompt the user to enter their passcode manually rather than scan their QR code.

For the best user experience, choose a device that has a crisp, high-definition display and low-latency response to touch gestures. Whilst the app will run on iPad Mini and iPad Pro devices, it hasn’t been explicitly designed for those sizes.

Notes:

  • Rear and external cameras aren’t supported.

  • If you’re mounting them on walls or glass, you need to ensure the devices you choose are capable of being mounted.

If your devices have been set up by our team, you won’t need to complete the steps outlined in this guide. If you have your own devices or are in the process of getting them without having been set up, you’ll need to follow the steps outlined below to allow the devices to function correctly.

Install the app

Google accounts and Google Play

Within a corporate environment, it’s better to avoid adding a Google account to the device. This will prevent updates from being downloaded and installed automatically.

Many commercial devices are supplied with a “locked-down” version of the Android OS that prevents the use of Google accounts, Google Play and mobile services. On such devices, the Welcome app must be loaded directly onto the device. This is the same as the Matrix Booking standard supplied devices.

Android tablets – Google Play

The app can be installed on Android devices either:

  • via the Google Play Store

  • by using the device’s web browser app to download the latest version of the app.

This is distributed as an .apk file:

https://media.matrixbooking.com/software/welcome/matrix-welcome-latest.apk

Open the downloaded file to install the Welcome app on your device. You may be required to “Allow files of this type to be installed.”

Note: the browser on some Android devices is called “Lightning”.

iPads – Apple App Store

The Welcome app is installed on iPad devices via the Apple App Store.

Set up the kiosk user account

Login with a kiosk user

When opening the app for the first time, a login screen will be shown. Logging in needs to be done only once and is the first step to setting up the Welcome app. It determines the Matrix account that you’ll connect to.

Create a kiosk user

The Welcome app must be set up using a special kiosk user, rather than using your own credentials. This ensures that actions are associated with the kiosk user, rather than your own. For more information, see our Create a user account page.

To create a kiosk user, in the Matrix Booking web app:

  1. Select Admin in the top bar.

  2. Select Users under the Security & Integrations section in the side menu.

  3. Select New User.

  4. Enter an arbitrary email address (for example, welcome.kiosk@your-company.com).

  5. Enter an arbitrary first and last name (for example, Welcome Kiosk).

  6. Enter a password. Make note of this as you’ll need this password to log in to the app.

  7. Select System/API as the type of user.

  8. Select Save.

Assign Location Manager access

Once you have created the kiosk user, you must assign Location Manager access to the kiosk user for (at least) the office location that you’re setting up the Welcome app for. This will give the kiosk user permission to check visitors in and out of the location. To do this in the Matrix Booking web app:

  1. Select Admin in the top bar.

  2. Select Location Managers under the Location Settings section in the side menu.

  3. Begin to enter the location name in the Location text box (for example, Wellington House).

  4. Select the chosen location from the drop-down list.

  5. Alternatively, begin to enter “All of …” to assign Location Manager access to the kiosk user for all locations.

  6. Begin to enter the email address of the kiosk user in the Who text box (for example, Welcome Kiosk).

  7. Select it from the drop-down list.

  8. Select Add.

If you’re setting up the Welcome app on multiple devices, you can choose to use the same kiosk user for all devices.

Warning: there’s a trade-off between the convenience of setting up a single kiosk user and the risk of all Welcome kiosks becoming unusable if someone:

  • accidentally deactivates the kiosk user account

  • locks the kiosk user account

  • changes its password

Other visitor management settings

The following steps focus on setting up the Welcome app only. Other visitor management settings, such as defining receptions, choosing whether passcodes are sent and signing declarations, must have already been configured using the Admin screen within the Matrix Booking web app. For more information, see our Administrator’s Guide.

Set up the app

The Welcome app can be set up in a variety of ways, depending on whether you want to allow:

  • only external visitors to check in and out

  • only staff members to check in and out

  • or both

You can also choose whether you want to allow people to check in and out by entering their details manually, by scanning or entering a passcode, or both. These choices are for your organisation to decide.

Note: once the app is set up, it will automatically show the home screen. It will bypass the set up screens as the settings have been saved.

Launch the app

Once you have installed the Welcome app on your device and created a kiosk user, you can:

  1. Launch the app. This will automatically display the login screen.

  2. Enter the the kiosk user’s email address into the Email text box.

  3. Enter the kiosk user’s password into Password text box.

Warning: the app won’t let you use your own personal login credentials.

Select a reception

After logging in, the Select a reception screen will appear:

  1. Find the chosen building with the reception that the device will be placed in (for example, Wellington House).

  2. Select the chosen building. The selected building will appear highlighted with a tick on the right-hand side.

  3. Select NEXT.

    An image of the 'Select a reception' setup screen.

Notes:

  • The building or reception can be the same or different for each device.

  • If you don’t see any buildings or reception locations listed, your kiosk user probably needs to be given Location Manager access.

Choose who should be able to check in and out

After choosing your building and reception, the Who should be able to check in and out? screen will appear. To select the correct options for visitors or staff:

  1. The Allow external visitors to check in and out toggle button will be turned on by default.

  2. Select either:

    1. By entering their details manually.

    2. By scanning or manually entering a passcode.

    3. Both.

  3. Your selected option will be highlighted and a tick will appear next to it.

  4. The Allow staff members to check in and out toggle button will be turned off by default.

  5. Select the toggle button if you want staff members to check in and out.

  6. Select either:

    1. By selecting their name from a list.

    2. By scanning or manually entering a passcode.

    3. Both.

  7. Your selected option will be highlighted and a tick will appear next to it.

  8. Select NEXT.

    An image of the 'Who should be able to check in and out' setup screen.

The pass QR code scanning option is always available by default unless your device doesn’t have a front-facing camera. The list of possible hosts or staff members is sourced from the Matrix Booking internal directory.

Warning: if the device doesn’t have a front-facing camera, the option to check in By scanning or manually entering a passcode will automatically change to By manually entering a passcode.

Select a layout for the home screen

After choosing your check-in and checkout options, the Select a layout for the home screen screen will appear. The different layouts you can have are your:

  • Company logo followed by your company (or reception) name.

  • Company (or reception) name followed by your company logo.

  • Company logo prefixed with “Welcome to”.

  • Company logo only.

  • Company (or reception) name only.

To select a home screen layout:

  1. Swipe left or right to your chosen home screen.

    An image of the 'Select a layout for the home screen' setup screen.

  2. Select Options…

  3. Select the prefix that makes sense grammatically:

    1. Welcome to.

    2. Welcome to the.

  4. Select either your:

    1. [Organisation name] (for example, Armatree Industries).

    2. [Building or reception name] (for example, Wellington House).

    An image of the home screen options.

  5. Select NEXT.

Notes:

  • The app’s functionality is the same regardless of which layout you choose.

  • You can amend your choices by changing the setting.

Other check-in options

After selecting your home screen layout, the Other check-in options screen will appear. If you want visitors or staff to enter their vehicle registration (licence plate number):

  1. Select the Ask for a vehicle registration? toggle button.

    1. Three options below the button will appear:

      1. Only ask external visitors.

      2. Ask both external visitors and staff members.

      3. Only ask staff members.

  2. Select the correct option for your organisation.

    An image of the 'Other check in options' setup screen.

  3. Select DONE.

  4. The Welcome app’s home screen will be displayed.

Tip: you can amend your choices by changing the setting.

Permission to use the camera

If your device has a front-facing camera and you have chosen a setup that allows a person to scan their pass QR code, you’ll need to give permission for the app to use the camera after you have completed the app setup steps.

To give the app permission to use the camera:

  1. Select the Scan your pass QR code button

  2. Select Allow when prompted (the wording may be different between iPads and Android tablets).

Change the settings

Once you have set up the Welcome app, the home screen automatically displays. If you restart the app, it will automatically bypass the setup screens and use the choices that you made previously. To change any of those choices:

  1. On the home screen, tap in quick succession:

    1. The top-left corner.

    2. The top-right corner.

    3. The bottom-right corner.

    4. The bottom-left corner

    5. The bottom-right corner again.

  2. You must complete this tapping sequence within 8 seconds.

    1. You’ll see a brief splash when you tap each corner.

  3. A pop-up will ask you to confirm that you want to reconfigure the app.

  4. Select RECONFIGURE. You’ll be taken to the first setup screen where you can complete the setup steps again.

Tip: if you want to reconfigure the app using a different kiosk user, tap the logout button that appears in the top-right corner of the setup screens.

Check the version of the Welcome app

To check what version of the Welcome app you have installed, long press on the “Powered by Matrix Booking” logo at the top of the home screen. The app version will appear briefly at the bottom of the screen.

Troubleshooting

For more information, see our troubleshooting article.

Network requirements

Network connectivity

The app opens outbound HTTPS connections to Matrix Booking servers at the following server names:

Server name

Protocol

Port

Notes

app.matrixbooking.com

HTTPS

443

cdn.matrixbooking.com

HTTPS

443

Organisation logo.

*.datadoghq.eu

HTTPS

443

  • Matrix Welcome app only.

  • used to track application usage and capture crash reports for support and product improvement purposes.

  • no personal data relating to visitors and staff members is logged.

In addition to these server names, we use Datadog’s EU-based service to track application usage and capture crash reports for support and product improvement purposes. No personal data relating to visitors and staff members is logged.

We recommend that you ensure that your device has network access to keep its time synchronised with either Apple or Google’s network time protocol (NTP) servers.

Other server names

Protocol

Port

Notes

2.android.pool.ntp.org

UDP

123

time.apple.com

UDP

123

The follow server names are only for devices managed by Matrix Booking via Hexnode:

Other server names

Protocol

Port

Notes

remoteview.hexnodemdm.com

HTTPS

443

portalname.hexnodemdm.com

HTTPS

443

global.stun.twilio.com

TCP and UDP

3478

TCP

5349

global.turn.twilio.com

TCP and UDP

3478

TCP

5349

Device settings

Time and date settings

If you have your own device, make sure that the default time zone is correct as it may be the device manufacturer’s time zone. Devices supplied by us will be set up with the correct time zone setting.

Warning: your device may have a different time server. Make sure this is available through your firewall to ensure your devices can keep the correct time.

Security settings

There are a number of options to prevent users from accidentally exiting the app:

  • Install the Matrix Booking MDM or kiosk software – contact your Account Manager for this.

  • Install your organisation’s MDM or kiosk software.

  • Use the Android native personal identification number (PIN) or password mechanism.

We use and have information on the native kiosk mode for iOS devices.

Notes:

  • You don’t have to follow these options, but your devices may not be secure.

  • Check your organisation’s IT security policy to see if one of the above is required.

If you have your own MDM kiosk solution or you have purchased the Matrix Booking MDM or kiosk software, this must be installed prior to installing the app. You won’t need to set the Android or iOS native PIN or password when using MDM or kiosk mode as this automatically restricts access.

To prevent navigation away from the Welcome app:

  1. Close all other apps:

    1. For iPads:

      1. Go to the Home Screen

      2. Swipe up from the bottom of the screen.

      3. Pause in the middle of the screen.

      4. Swipe right or left to find the app that you want to close.

      5. Swipe up on the app’s preview to close the app.

    2. For Android tablets:

      1. Select the square icon at the bottom of the device.

      2. Select the X button on each apps.

  2. Select Settings (of the device, not the app).

  3. Go to the Security section (may be called different names depending on the OS).

  4. Go to the Screen locking sub-section (may be called different names depending on the OS (for example, Guided Access in iOS)).

  5. Set a password or PIN.

  6. Go to Screen pinning option (may be called different names depending on the OS).

  7. Select the Screen pinning tick box or slider.

  8. You’ll notice a pin button in the bottom-right of the Welcome app.

  9. Select the pin button. A pop-up box will appear asking you to confirm this.

  10. Select Confirm.

Notes:

  • For more information, see our Guided Access for iOS devices page.

  • If you’re using an MDM solution or using the Matrix Booking HaaS product, don’t set a PIN as this isn’t needed and will interfere with remote support and automatic recovery.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.