/
x-hoppers Admin Guide

x-hoppers Admin Guide

This guide explains how to configure x-hoppers, which is a complete retail headset system with AI assistance that connects store associates and increases customer conversions.

Created: May 2022

Updated: March 2025

x-hoppers Quick Start Guide for admins: https://x-hoppers.atlassian.net/wiki/x/bQBlAg

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

Introduction

x-hoppers is a retail communication system that uses headsets to keep your store associates connected on the shop floor. Team members can communicate instantly through an always-on broadcast by pressing a push-to-talk button, ensuring quick responses to questions, tasks and alerts. Beyond internal communication, x-hoppers also:

  • Helps customers interact with products and request assistance through smart call points

  • Integrates AI for better service

  • Connects in-store devices like cameras and till points etc

  • Provides real-time theft detection and prevention

  • Supports external communication with customers, suppliers and vendors through a mobile app or a web platform

Requirements 

  1. x-hoppers system on WMS 7.0X

  2. W-AIR DECT Network components:

Recommendations before deploying x-hoppers

  • Bandwidth availability:

    • G711 requires approx. 80 kbps

    • Every time a headset is lifted off a charger, an audio stream is initiated from the headset to the Base station, and then from the Base station to the PBX

  • Using Hardware PBX as a Proxy

    • If Hardware or Virtual PBX is on the same subnet as the Base stations, you can proxy through the PBX to the Base stations and access them easily

    • Another benefit for Hardware PBX: e.g. if the internet goes down, and there is a hardware PBX, x-hoppers still continues working

Licensing

x-hoppers licenses can be ordered in Salesforce Partner Community. The following licenses are available:

image-20240619-101840.png

 

Device

BackOffice

HelperHopper

SalesFloorHopper

SalesFloorHopper + AI

SuperHopper + AI

 

Device

BackOffice

HelperHopper

SalesFloorHopper

SalesFloorHopper + AI

SuperHopper + AI

Ideal for: 

For SIP devices

Administration and support users who don't face customers 

Customer care, contact center, users who need access to integrations 

Retail assistants who work on the shop floor

Retail assistants who work on the shop floor

Managers and supervisors

Free minutes for outbound calls

100 min

3000 min

3000 min

3000 min

3000 min

3000 min

SMS included

100 sms

200 sms

1000 sms

1000 sms

1000 sms

1000 sms

Max number of devices / calls*

Up to 1 device / 2 calls

Up to 10 devices / 4 calls

Up to 10 devices / 8 calls

Up to 10 devices / 8 calls 

Up to 10 devices / 8 calls

Up to 10 devices / 8 calls 

Chats and videoconferencing

Using mobile app

Adding guests to conversations

Integrations

Personal contact-me link, meeting scheduler, website widget

Contact center events logging

DECT headset included

Internal broadcast channel

Simple user sign in

Customer service powered by AI prompts

Voice authentication

AI Video Alerts (AIVA)

Live board and analytics

Sales Intelligence

Website widget setup

  • Current limitation: Users that have x-hoppers-HelperHopper / x-hoppers-SalesFloorHopper + AI licenses, need to be assigned x-hoppers-SalesFloorHopper license in x-hoppers admin.

  • * - max 2 calls on a DECT headset

x-hoppers headset overview

x-hoppers admin guide-headset.png

Note: There are 2 button combinations that have to be pressed simultaneously:

  • Push-to-talk, Volume Up and Volume Down to register a headset

  • AUX function, Volume Up and Volume Down to power it off

LED indicators overview

Color

LED indication

Status

Green

Short blink followed by long blink

Power Up

Fast short blink, repeated

Incoming call

Single short blink. Notification of call only via audio in HS

2nd incoming call, call active

Single short blink

In call

Long blink

Battery charging

Steady on

Battery charging, full

Red

Long blink followed by short blink

Power Down

Fast, short blink

Low battery

Steady on

Battery charging, low battery

Long blink

Registration failed

Single short blink repeated slow

Idle, out of range

Blue

Short blink repeated fast

Registration, ongoing

Long blink

Registration completed

Single short blink repeated slow

Idle, connected

Purple

Steady on

Menu

 

None

Deregistered

Multi-charger overview

Multi-charger consists of 6 chargers connected in parallel with a 5V/ 4A power supply and can simultaneously charge up to 6 headsets.

x-hoppers-multicharger-overview.jpeg

1 - Charging pins

2 - Charger connection

Using the charger

When charging a headset for the first time, it is necessary to leave it in the charger for at least 10 hours before the battery is fully charged, and the headset is ready for use. The headset is automatically deactivated and can’t receive calls while charging. 

For correct charging, ensure that the room temperature is between 5°C and 45°C / 41°F and 113°F. Do not place the headset in direct sunlight when charging.

Detailed description on the headset can be found in https://wildix.atlassian.net/wiki/x/GwvOAQ.

Hardware setup 

Step 1. Connect and update base station(s)

You need to install and provision W-AIR Base stations. Depending on your setup, you can choose either:

  • W-AIR Sync Plus (for multicell configurations)

  • W-AIR Small Business (for single cell configurations)

Proceed with these steps to set up:

  1. Power up and connect your base station

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

  3. (For multicell) Navigate to x-hoppers admin -> Devices -> W-AIR Networks, create a W-AIR Network, then go back to Devices and make sure to Configure / Sync the base station; reboot the base station

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

Step 2. Register and update headsets

  1. Put a headset in the registration mode by pressing Push-to-Talk, Volume Up and Volume Down buttons at the same time and keeping them pressed for more than 5 seconds. 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. After the registration, you can check all the headsets in x-hoppers admin -> Devices -> W-AIR devices tab

x-hoppers Admin Guide-Register headsets.jpg
  1. After successful registration of x-hoppers headsets, put them into the charger to update firmware. You can check the progress on the web interface of the W-AIR base

W-AIR-Headset-check-update.jpg

It is recommended to update the firmware of the headsets one by one or in groups of two. Updating six headsets simultaneously might take a long time.

For additional information on how to update the firmware, consult W-AIR Headset User Guide.

Step 3. Assign headsets to PBX users 

  • Navigate to Devices menu, W-AIR devices tab

  • Choose the headset and click Assign to user

  • Enter user extension and click Save 

x-hoppers Admin Guide-Assign a headset.png

Notes:

  • W-AIR base station needs to be configured/ synced in order to push all necessary settings to the headsets

  • After assigning headsets to users, to figure out which headset belongs to whom, check its EPEI and compare it to the IPEI listed on W-AIR devices tab

For additional information on how to assign headsets, consult WMS Start Guide: Devices management.

For additional information on how to check the IPEI, consult W-AIR Headset User Guide.

Broadcast setup

Important!

The following description relates to the new broadcast setup process available in WMS 7.01. To ensure proper system functionality after upgrading from WMS 6.10, follow these steps and reconfigure your setup accordingly.

Team members can communicate instantly through an always-on broadcast. Follow the steps below to set it up.

Step 1. Create a Broadcast

  • Navigate to x-hoppers admin -> Broadcasts menu, Broadcast tab and click + ADD

x-hoppers Admin Guide-Broadcasts.jpg
  • Specify the following fields:

    • Broadcast name: Enter a name for the broadcast

    • PBX: Select the appropriate PBX (if multiple PBXs are available in WMS network)

    • Members: Start typing a name or extension, then select members from the list. Current behaviour: Only users with a valid email address who have logged in at least once can currently be added, this will be addressed in future releases

    • Tags: (Support for this functionality is planned for future releases) Use tags to enable scheduled or instant messaging across multiple broadcasts

  • Transcription: Enable this option to record and transcribe all in-store conversations. Recordings and transcriptions are posted to a dedicated x-hoppers group conversation

  • Default broadcast: Enable this option to make this broadcast the default one for your store

  • Avatar: Upload an image to be used as x-hoppers group conversation picture

x-hoppers Admin Guide-Creare a broadcast.png
  • Click ADD to create a broadcast

Once you save the changes, a dedicated group conversation is created in x-hoppers, including added members and x-hoopers bot. Do not delete the bot, as it is required to post transcriptions and audio recordings.

x-hoppers Admin Guide-Created x-hoppers channel.png

 

Step 2. Configure Dialplan 

  • 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 charger

    • *wair*: this string dialed to bring the headset back to the broadcast, e.g. after receiving a call, or when using AI Assistant, Dial-by-name option

  1. Click Add number

  2. Enter *Wairhotline*

  3. Add the below Dialplan applications:

    • Set -> Language -> choose language

    • Broadcast -> select the previously created broadcast, 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, enable battery level announcement

x-hoppers-configure-users-dialplan.png

Refer to Dialplan Applications - Admin Guide for detailed information on how to set up Dialplans.

  1. Proceed with adding another number *wair*

  2. Add the below Dialplan applications:

    • Set -> Language -> choose language

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

    • Broadcast -> select the previously created broadcast, choose the sound to be played on joining the broadcast or create it dynamically using TTS, for example Joining the broadcast back, enable battery level announcement

It should be the same broadcast, selected for *Wairhotline* called number.

x-hoppers Quick Start Guide-wair Dialplan.png

Smart call points setup

The smart notifications feature in x-hoppers enables instant alerts to be broadcasted to store associates when specific events are triggered, such as an assistance requests from till points, QR code-based smart call points or security alerts, etc. This functionality integrates with various devices, including call buttons, cameras, POS systems, through a dedicated Smart Notifications API.

QR codes

Use cases  

  • QR code for each product: If you have a separate web page for each product and want customers to be directed to that exact page upon scanning the QR code, this option is ideal for you. Attach a unique QR code next to each product, allowing customers to scan and access detailed product descriptions

  • QR code for a category of products: For larger stores with many products, consider using a QR code for each category of products. In this case, you can place the code in each row in your store, to be easily found by customers

In both scenarios, once a QR code is scanned, store associates receive instant notifications about the specific product or product category a customer is interested in. This enables them to provide timely assistance and guidance. Additionally, you can gather valuable statistics on which QR codes were scanned and how often, allowing you to analyze customer engagement and make informed decisions.

For detailed setup instructions on QR codes, please refer to the dedicated How to generate and manage QR codes documentation.

To improve customer interaction, you can also:

  • Include a Kite button on the product web page. This feature allows customers to connect with sales associates or back-office staff via chat, audio, or video call. Check the documentation: Wildix WebRTC Kite - Admin Guide - English for instructions

  • Set up call generation. We provide SDK (REST APIs), which can be used to set up call generation when someone scans the code. So for this part, you need a web developer, who would configure the relevant POST and CURL requests for each QR code. Note: To protect the system from spam, you may set up CAPTCHA on your website before the call is initiated

Click and collect

Click and collect functionality speeds up and simplifies the process of processing the orders made online. When customers with online orders come to the store, they just need to enter their order ID number on a dedicated tablet. The staff is immediately notified in the broadcast that the relevant order number is there to collect. 

To configure click and collect, refer to x-hoppers Smart Notifications documentation.

Conversation recordings and transcripts

Current limitation: Messages to x-hoppers broadcast with transcription of in-store conversations enabled should not be longer than 5 minutes.

If the Transcription option is enabled when creating the broadcast, all in-store conversations throughout the day are recorded and posted to a dedicated x-hoppers group channel. Both the transcription and audio recording of each segment are included. They are posted on behalf of the users speaking at that moment. System messages, e.g. when a customer scans a QR code, are posted by the x-hoppers bot.

x-hoppers Admon Guide-Transcriptions.png

Tip: You can use Chat AI Assistant (magic pencil icon) feature to get a quick AI-generated summary of what was going on in the broadcast during the day:

  1. Create a new custom command, named e.g. “Conversation today” (check the “Create a New Command” section of the guide How to use AI Assistant for instructions)

  2. Write the necessary instructions in the Prompt field, e.g. “Summarize the conversation for the last 24 hours and break it into what each user said. Provide bullet points underneath each user”

  3. Running the command you’ve created, you can get a brief summary of conversations in the broadcast during the day

AI Video Alerts (AIVA)

x-hoppers AI Video Alerts (AIVA) provides real-time theft detection and prevention, improving store security while supporting the in-store shopping experience. AIVA instantly detects suspicious actions captured by store CCTV cameras and sends alert notifications with video recordings to a group conversation and discreet audio alerts to headsets, helping to reduce theft.

Documentation: x-hoppers AI Video Alerts (AIVA).

Custom settings

Consult the documentation x-hoppers Custom Settings to check the list of custom settings, e.g., how to create multiple broadcasts, enable battery level announcement, join a broadcast from any other device etc.

Additional scenarios

Voice authentication  

Voice authentication is designed for assigning headsets to users. When enabled, the system compares the voice of the user with user voices previously saved in the system and in case of a match, allows authorisation, eliminating the risk of user logging in under a different name.

Documentation: https://x-hoppers.atlassian.net/wiki/x/AwAU.

Push-to-talk for mobile

The feature allows you to send Push-to-talk messages to x-hoppers broadcast from mobile.

Documentation: https://x-hoppers.atlassian.net/wiki/x/AYAx.

Announcements for specific Departments

In case you need to make announcement in the broadcast to users of specific Departments only, check out the guide How to Make Announcement to Users of Specific Departments.

Voice bots

Voice Bots functionality allows you to configure automated responses and route customers' and your team’s queries via bot assistance.

Documentation: How to set up Voice Bot for x-hoppers .

Dial-by-name

Dial-by-name functionality allows you to configure the possibility for store associates to initiate a call to a colleague right via x-hoppers headset.

Documentation: How to set up and use Dial-by-name feature.

Analytics

x-hoppers offers a dedicated Analytics feature that provides detailed statistics about the system’s usage. By monitoring these metrics, managers can gain insights into the time distribution of store associates in conferences, including the total time spent, wait time, and talk time, as well as view statistics per each separate store, including the number of active users, average and total talk time and monitor the usage of help points, both tablets and QR codes. Such information can be valuable for analyzing productivity and optimizing broadcast management to improve efficiency.

Documentation: x-hoppers Analytics.

Integrations

Veesion

x-hoppers supports integration with Veesion, software that allows detecting thefts in real time, by analysing video feeds and sending real time alerts when suspicious behaviour is detected.

Documentation: https://x-hoppers.atlassian.net/wiki/x/AYAj.

Flic

By integrating x-hoppers with Flic, it is possible to use the Flic button as a help point trigger. When the button is pressed, broadcast users receive an audible alert indicating that assistance is needed at a particular location, which allows them to promptly handle the customer's requests.

Documentation: https://x-hoppers.atlassian.net/wiki/spaces/DOC/pages/19791873.

Power BI

x-hoppers integration with Power BI enables you to download x-hoppers analytical data and import it to Power BI for advanced reporting and visualization.

Documentation: https://x-hoppers.atlassian.net/wiki/spaces/DOC/pages/67174435.

Related content