/
x-hoppers Quick Start Guide for the admin

x-hoppers Quick Start Guide for the admin

This guide is a Quick Start Guide that contains the basic information on how to set up an x-hoppers system and its basic functionalities in thirty minutes.

For the advanced scenarios please refer to other guides of the Admin Documentation section.

This Quick Start Guide is intended for system administrators with advanced knowledge on:

  • Wildix systems and WMS (W-FE certification)

  • Wildix W-AIR Systems

Created: August 2024

Updated: March 2025

Permalink: https://x-hoppers.atlassian.net/wiki/x/bQBlAg

Before starting to set up the system, put the x-hoppers headsets into the charger to start charging them. The headsets need at least 10 hours before they are fully charged.

Step 1. Basic x-hoppers admin setup

Access x-hoppers admin interface of your x-hoppers system:

  1. x-hoppers admin -> Users: Change the admin password on the system

  2. x-hoppers admin -> Users: Make sure you set up the admin email for notifications

  3. x-hoppers admin -> System -> Upgrade: Update the system to the latest stable version from rel70beta repository

  4. x-hoppers admin -> System -> NTP Server: Make sure the time and date of the PBX are correct and synced with the NTP Server

  5. x-hoppers admin -> PBX -> Language & Region: Make sure you set up the default language of the PBX correctly, as well as default tone zone, country code, time zone and the sound packages

For more detailed information, consult WMS Start Guide.

Step 2. Create users

  1. x-hoppers admin -> Users: Create users and assign them the correct x-hoppers licenses. Make sure you add email addresses

  2. x-hoppers admin -> Users -> Groups: Make sure ACL permissions are set up correctly

For more detailed information on setting up users, consult WMS Start Guide.

For details on the x-hoppers licenses, consult x-hoppers Admin Guide.

Step 3. Provision and update W-AIR bases

How to find the IP of the W-AIR base station? The easiest way is to use a W-AIR handset:

  1. Turn on the handset

  2. Press “Menu” key

  3. Type *47* (*ip*)

  1. Make sure the W-AIR Base station is provisioned

  2. (For Multi Cell Base Stations) x-hoppers admin -> Devices -> W-AIR Networks: Create a W-AIR Network, then go back to x-hoppers admin -> Devices and make sure to Configure / Sync the base station; reboot the base station

  3. Go to x-hoppers admin -> Devices and make sure the firmware of the base station is up to date

For remote provisioning of W-AIR base stations, consult Remote Provisioning Guide.

Step 4. Register and update headsets

Registration:

  1. Register the headsets one by one: press Push-to-Talk, Volume Up and Volume Down buttons at the same time and keep them pressed for at least 5 seconds

54a74157-c158-44fa-9ae3-bb1ec9410432.png
  1. When the headset is in registration mode, the LED indicator blinks with short blue flashes and a voice prompt announces “Registering

  2. The headset connects to the Base Station. When the headset is subscribed, the voice prompt announces “Headset subscribed”

  3. Proceed with other headsets. After the registration, all the headsets are listed in x-hoppers admin -> W-AIR devices tab. Now you also see their battery level

x-hoppers Admin Guide-Register headsets.jpg

Firmware update:

  • The headsets start updating the firmware automatically after they are registered to the base station and placed into the charger. Access the W-AIR base stations' web interface (“Extensions” tab) to check the progress

W-AIR-Headset-check-update.jpg

How to find the IP of the W-AIR base station? The easiest way is to use a W-AIR handset:

  1. Turn on the handset

  2. Press “Menu” key

  3. Type *47* (*ip*)

Assigning to users:

  • Navigate to x-hoppers admin -> Devices -> W-AIR Devices to assign the headsets to users

x-hoppers Admin Guide-Assign a headset.png

Step 5. Broadcast setup

  • Navigate to x-hoppers admin -> Broadcasts

  • Create a broadcast: specify its name, add members, enable transcription in order to record and send transcriptions of all in-store conversations to a group chat

x-hoppers Quick Start Guide-Broadcast.jpg

Step 6. Dialplan setup

  1. Navigate to Dialplan menu, Dialplan rules tab and modify the users Dialplan by adding the following two called numbers:

    • *Wairhotline*: this string is dialed automatically when the headset is taken off the charging station

    • *wair*: this string is dialed to bring the headset back to the broadcast, e.g. after ending a call, or after using AI Assistant (Voice bot)

Here’s an example of how to configure the Dialplan with these two called numbers:

  • *Wairhotline*

    • Set -> Language -> choose language

    • Broadcast -> select one of the previously created broadcasts, choose the sound to be played on joining the broadcast or create it dynamically using TTS, for example Welcome to x-hoppers, joining the broadcast

x-hoppers Quick Start Guide-Broadcast Dialplan.png

*wair*

  • Set -> Language -> choose language

  • Voice Bot application -> choose the necessary Voice bot (setup instructions are available in this guide How to set up Voice Bot for x-hoppers)

  • Broadcast -> select one of the previously created broadcasts (make sure it is the same broadcast you specified under *Wairhotline*), choose the sound to be played on joining the broadcast or create it dynamically using TTS, for example Joining the broadcast back

x-hoppers Quick Start Guide-wair Dialplan.png

Demo of the broadcast and push-to-talk

Headset Overview

 

2a3ddd73-25ba-4d00-ae09-eb0ca21456f4.png

 

Join the broadcast

The headset automatically joins the broadcast once lifted from the charging station.  

If the headset goes out of range or has been removed from the broadcast, it automatically rejoins the broadcast within 5 seconds of becoming available again.

Speak in the broadcast

There are two options to mute/ unmute to speak in the broadcast:

  • Push-to-talk mode: press and hold the Push-to-talk button to get unmuted. You stay unmuted only while pressing the button. When the button is released, the headset goes back to mute. This mode is recommended for passing short messages.

  • Handsfree mode: press the Mute button to unmute and be able to speak in the broadcast. All people in the broadcast can hear you. You stay unmuted till the Mute button is pressed again or till the headset is placed on the charger. This mode is recommended in case your hands are busy and you need to speak for a longer period of time.

Answer an incoming call

  • Double-press the Push-to-talk button to answer an incoming call and put yourself on hold in the broadcast. 

Same as in the broadcast, the headset stay muted by default. To unmute and speak to the caller, you have two options:

  • Press the Mute button to put yourself in a hands-free mode. This mode is recommended to have a normal lengthy conversation.

  • Otherwise, press and hold the Push-to-talk button every time you speak to the caller. This mode is recommended for short conversations.

Consult the x-hoppers headset User Guide for more information.

 

Related content