x-hoppers Green Box Documentation

Introduction

x-hoppers is an innovative Retail Headset System designed to connect retail assistants and increase customer conversions. The solution is built on DECT technology, linked to a full communications system in the Cloud. Fully wireless, x-hoppers lets retail assistants easily communicate with each other as well as receive external calls. Also, x-hoppers offers an integrated QR code system, which can provide retail assistants with instant buyer alerts.

x-hoppers Green Box serves as a demonstration kit that showcases the capabilities and advantages of the system. It's a comprehensive package that includes all the essential components needed to simulate its functionality in real-world scenarios.

What is inside the Box

Open

x-hoppers Box content

The Box also includes chargers, plugs and x-hoppers keychain.

Licensing explanation

Besides the hardware components within the Box, you also get:

• a PBX, functioning as the central communication system to configure all aspects of your demonstrations

• CLASSOUND DID, enabling remote joining of broadcasts using any device

Upon ordering x-hoppers Green Box, you will receive all the necessary information, such as PBX domain, credentials and CLASSOUND DID, via email.

Assemble the Box

Step 1. Unpack the box

When unpacking x-hoppers Green Box, please be aware that it consists of two layers, each with specific contents:

Top Layer:

• six x-hoppers headsets

• x-hoppers keychain

Bottom Layer:

• MultiCharger for six headsets

• W-AIR Small Business Base Station

• Power supply for the base station and plugs

Step 2. Connect and update the base

1. Power up the base station

2. Go to WMS → Devices and make sure it’s provisioned and it’s firmware is up to date

Open

Step 3. Register and update the 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. Proceed with other headsets. After the registration, all the headsets are listed in WMS W-AIR devices tab. You can now check the battery level of the headsets:

4. 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.

Basic settings

Step 1. Map Green Box to the PBX

By following this procedure, you ensure that your x-hoppers Green Box is correctly mapped to the appropriate PBX:

1. Access WMS and navigate to Users menu

2. Create a user profile with the following parameters:

   • Role -> Admin

   • Full Name -> DemoFlowUser

   • Extension -> 100

      

3. Navigate to PBX menu, Integrations -> Applications -> Simple Token tab

4. Create a token for the user 100 and copy its key

5. Scan any QR code located on the inner side of the Box’s cover

6. After scanning, you are redirected to a web page where you need to insert the necessary data to map the Box to your PBX (you can find the required data in the email we sent you):

   • Your company name

   • PBX domain name

   • Simple Token key

Set your preferred language for the mapping and Help Points interfaces (see “Basic scenarios” chapter). If you need to change the language, please contact support.

Once the mapping process is completed, you can proceed to the further setup

Step 2. Create users

1. Access WMS and navigate to Users menu

2. Create user profiles for every user of the system. Since you have nine licenses, it is recommended you create nine users:

   • six users with x-hoppers-SalesFloorHopper license (you will assign six x-hoppers headsets to these users)

   • one user with x-hoppers-SuperHopper license (the manager’s license)

   • optionally you can create two additional users with x-hoppers-BackOffice license

Step 3. Assign headsets

1. Navigate to Devices menu, W-AIR devices tab

2. Assign the headsets to the six users with “SalesFloorHopper” license

Set up the broadcast

Dialplan configuration of the broadcast

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 (ChatGPT)

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

• *Wairhotline*

  • Set -> Language -> choose language

  • Play sound -> click Browse (three dots) and 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

  • Conference -> enter the conference room ID number. This can be any number, e.g. 1, 2, 3, etc. 

• *wair*

  • Set -> Language -> choose language

  • Play sound -> click Browse (three dots) and 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

  • Conference -> enter the conference room ID number. Make sure it’s the same Conference ID that you specified under *Wairhotline*

Demo of the broadcast and push-to-talk

Headset Overview

Join the broadcast

The headset automatically joins the broadcast once left up 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.

Configure Help Points

In the Green Box demonstration we have four help point scenarios.

On the inner side of the Box’s cover you can find three QR codes for the following demo scenarios:

• Help Point 1 (QR code 1): Customer is looking for help in a specific area of a shop. Automatic audio notification is played to the broadcast

• Help Point 2 (QR code 2): Customer is looking for help with a specific product. Automatic audio notification is played to the broadcast

• Help Point 3 (QR code 3): Direct call via WebRTC Kite to the call group where a customer can talk directly with a headset user.

Also, you can demonstrate the scenario with click & collect service using a tablet or a laptop (you will have to open a web browser to show this scenario):

• Help Point 4 (web browser): Customer enters any number into the input field for click & collect service. Automatic audio notification is played to the broadcast notifying the users that customer arrived to collect the order with that number (with the number inserted by the customer).

Configuration of Help Points 1, 2 and 4 (click & collect)

1. Download and import the following Dialplan procedures in Dialplan rules tab , where:

   • XHoppersHelpPoints is required for playing audio notifications to the broadcast when one of the following help points is triggered: QR 1, QR 2, Help Point 4 (click & collect)

   • clickcollect is required for demonstrating Help Point 4 scenario (click & collect service). In this procedure you can customize the audio notification for click & collect service.

2. Navigate to General Settings tab, under Set dialplan variables, set the following variables and click Save button:

   • HelpPoint1=Help point 1 is triggered. Customer is looking for help in fresh fruits area

   • HelpPoint2=QR 2 is scanned. Customer is looking for more info about WorkForce phone

Configuration of Help Point 3 (direct Kite call)

1. Navigate to Call Groups tab and create a new call group. Make sure to activate Call waiting option when configuring the Call group strategy, so its members can receive more than one call at a time (consult the documentation for detailed guidance on how to create Call groups)

2. Proceed to Dialplan rules tab and select kite Dialplan procedure

3. Add 223344 as the called number, add “Call group” Dialplan application under the called number → Select the Call group you just created

Help Point 3 (QR 3 of the box) is set up to dial the number 223344, so with this configuration in the kite Dialplan, the call is sent to the call group directly via WebRTC Kite.

Demo of Help Points

Help Point 1. Help is required in a specific area 

This use case involves triggering a help point (QR code or tablet) when customers need assistance in a specific area, for example, the fresh fruits section of a store. 

To demonstrate:

• Trigger QR code 1 or follow the link designed for tablets https://x-hoppers-tablet.wildix.com/?box_id=X&key=X&action_id=1 (insert your own box_id and key instead of X)

• Upon triggering the help point, x-hoppers system sends an audio alert

• Users who are wearing W-AIR headsets hear a prompt through the broadcast channel. The prompt informs about the specific help point that was triggered and the assistance required. For example, the prompt could be: "QR 1 is scanned. Customer is looking for help in the fresh fruits area." (it is specified in WMS Dialplan -> General Settings)

• Simultaneously, after triggering the help point, x-hoppers displays a message to customers indicating that their request for help was received and is being addressed

Help Point 2. Customer is interested in a specific product 

In this use case, a help point is designed to provide customers with detailed information about a specific product. When scanned, the QR code directs customers to a webpage where they can learn more about the product they're interested in.

To demonstrate:

1. Scan the QR code 2

2. Upon scanning the QR code, x-hoppers system sends an audio alert

3. Users who are wearing W-AIR headsets hear a prompt that informs them about the specific QR code being scanned and a customer's product interest. For example, the prompt might be: "QR 2 is scanned. Customer is looking for more information about the Workforce phone." (it is specified in WMS Dialplan -> General Settings)

4. Simultaneously, after scanning the QR code, x-hoppers redirects customers to a predefined webpage https://www.wildix.com/product/voip-phones-and-headset/ related to the product, where they can access its detailed information

Help point 3. Direct Kite call for assistance

In this scenario, Help point 3 is designed to enable customers to initiate a direct call for immediate assistance.

To demonstrate:

1. Trigger QR code 3 or follow the link designed for tablets https://x-hoppers-tablet.wildix.com/?box_id=X&key=X&action_id=3 (insert your own box_id and key instead of X)

2. Upon triggering the help point, the system redirects customers to Kite web page

3. After entering customer’s name, a call is placed automatically to a pre-configured call group

4. Retail assistants within the call group receive the call and are alerted to the customer's request for assistance

5. Double-press Call button to answer the call, double-press AUX Function button to finish the call

Tablet scenarios and Click and Collect service

Out of the box we support tablet scenarios for Help Point 1 (ask for expert personnel), Help Point 3 (ask for audio assistance) and Help Point 4 (click&collect) and we have dedicated web pages that you need to open in the browser to showcase these scenarios:

• Help Point 1: same as QR code 1, this scenario enables customer to ask for expert personnel, but instead of scanning a QR code, customer has to tap on a glowing button.

The web page URL for this scenario is: https://x-hoppers-tablet.wildix.com/?box_id=xxx&key=yyy&action_id=1

• Help Point 3: same as QR code 3, this scenario enables customer to ask for audio assistance (direct call via Kite) from a tablet.

The web page URL for this scenario is: https://x-hoppers-tablet.wildix.com/?box_id=xxx&key=yyy&action_id=3

• Help Point 4: customer has to enter the order number into the input field for click & collect service. Automatic audio notification is played to the broadcast notifying the users that customer arrived to collect the order with that number (with the number inserted by the customer).

To demonstrate:

1. Open the following URL in the browser: https://x-hoppers-tablet.wildix.com/?box_id=X&key=X&action_id=4

2. Enter a number into the input field and tap on the glowing button

Automatic notification is sent to the headsets informing store associates that customer arrived to collect a certain order (you can customize the message in clickcollect Dialplan procedure)

Additional scenarios

Chat conversation with transcriptions

Configure chat conversation and transcriptions

All the messages exchanged in the broadcast can be posted to a dedicated chat, where each message is transcribed and an audio file is attached.

Follow the steps below to set up the chat and automatic transcriptions:

1. Log in to x-bees and create x-bees conversation with all the users participating in the broadcast and the manager user. In the next step, you will need to copy its ID

2. Open the terminal on the PBX. To gather and post transcriptions of conversations, use these commands in Terminal:

   • create directory /etc/systemd/system/pbx-data-engine.service.d

     # mkdir /etc/systemd/system/pbx-data-engine.service.d

   • add the following key to the file 

     # nano-tiny /etc/systemd/system/pbx-data-engine.service.d/override.conf [Service] ExecStart= ExecStart=/usr/sbin/pbx_data_engine.py --daemon --mode calls presence -cr

   • add the following data to /rw2/etc/pbx/x-hoppers.json file

     [ { "audio_conf_id": "2", "xbees_channel_id": "f6d17593-98b6-471d-941a-cd03153f" } ]

   • where:

     • audio_conf_id: ID of the audio broadcast channel in x-hoppers where the communication takes place

     • xbees_channel_id: ID of the x-bees conversation, where the content will be posted

   • reload systemd and restart the service to apply the changes:

Demonstrate how transcriptions work

After you set up the transcriptions, the system automatically records and transcribes all the messages exchanged in the broadcast. Transcriptions and attached audio files are automatically posted to the chat conversation.

You can demonstrate how it works by opening the relevant chat conversation on the mobile app (download the “x-bees by Wildix” app from the Apple store or Google Play Market) or in the web browser.

AI Assistant (ChatGPT)

Configure AI Assistant

Integrating ChatGPT with x-hoppers allows for intelligent question-answer interactions, enhancing customer support and information sharing. In this demo, you can showcase how users can ask questions and receive answers from the open sources.

In the basic demo scenario we demonstrate how AI Assistant can find answers to simple questions available in open sources (ChatGPT scenario). In the real retail environment, you will connect the x-hoppers AI Assistant to the database/ knowledge base.

To configure AI Assistant, follow the steps:

1. Download the following Dialplan and upload it on your PBX in the tab Dialplan rules:

2. Edit the “users” procedure, add the following Dialplan applications under *wair* called number

• Speech to text -> insert Please unmute and say question for Chat GPT, or wait to join the broadcast or any customized text

• Jump to if -> "${RECOGNITION_RESULT}"="question" -> select ChatGPT procedure

Demonstrate AI Assistant

Integrating ChatGPT with x-hoppers allows for intelligent question-answer interactions, enhancing customer support and information sharing. In this demo, you can showcase how users can ask questions and receive answers.

To demonstrate:

1. Double-press the AUX function button on the headset

2. Ask a question, for example:

   • Could you compare and contrast the following two products: an Asus Vivobook 15 and a Samsung Galaxy Book 3?

   • Which induction hobs can be plugged in and which must be wired in directly?

   • Is the discontinued EXPEDIT series compatible with KALLAX?

   • Are Kraft Jet-Puffed brand marshmallows kosher? Are they halal?

   • Are there any allergens present in Naked Fruit and Nut bars?

3. x-hoppers, powered by ChatGPT, processes the question and generates an appropriate response based on its knowledge base

4. The response is then played back to you audibly through the broadcast channel

To ask another question, double-press the AUX function button. This action hangs up the broadcast and restarts the interaction, allowing users to ask a new question.

External calls with your CLASSOUND DID

Dialplan configuration for managing external calls

1. Download the Dialplan and import it to the Dialplan rules tab (required for dialing into x-hoppers broadcasts remotely)

2. Modify the classound Dialplan by adding CLASSOUND DID as a called number and add the following Dialplan applications:

   • Set -> Codec -> alaw

   • Record a call -> specify an email

   • Jump to -> select “IVR for xhoppers” procedure

      

3. Modify the IVR for xhoppers Dialplan by specifying extensions, Call groups, audio files etc present on your PBX

Demonstrate how to join the broadcast remotely from PSTN

One of the remarkable features of x-hoppers system is its ability to allow users to join any broadcast from any location using any device. By dialling into x-hoppers demonstrations line via PSTN, for example, you are presented with a menu of choices to engage with the system and join specific broadcasts, allowing for flexible and accessible participation.

To demonstrate:

1. Dial CLASSOUND DID from an external device

2. Choose one of the options from the interactive menu:

   • Option 1: Ring all retail assistants in Call group. By pressing 1, you initiate a broadcast to all users in a specific Call group. This option is ideal for scenarios where a general announcement or message needs to be communicated to all users simultaneously

   • Option 2: Hunt through Call group with Priority or Round Robin strategy. By pressing 2, you trigger a call routing mechanism that hunts through each user connected to a specific Call group in a predefined order. This option is suitable for customer care scenarios where callers need to be connected to representatives consecutively until a successful connection is established

   • Option 3: Call directly to a single user. By selecting 3, you directly contact a specific user, typically a manager or designated contact person. This option allows for one-on-one communication and is useful for private conversations

   • Option 4: Join broadcast 1. Pressing 4 enables you to join the first broadcast. This option grants the ability to participate in a specific broadcast session and communicate with all users simultaneously

   • Option 5: Join broadcast 2. Pressing 5 enables you to join the second broadcast, extending the capability to address a different group of users simultaneously

Alerts from integrated equipment (AI theft detection)

In addition to calls and QR codes management, x-hoppers also provides a powerful API functionality that allows interacting with x-bees channels programmatically and performing various actions like getting the list of conversations, create or update a conversation and other actions, you can check all available API endpoints in Wildix API Documentation. Additionally, you can also demonstrate Veesion integration possibilities by posting alerts and videos.

To demonstrate:

1. Download the following JSON file containing a collection of practical API examples: .

2. Make sure you have Postman installed on your computer. If you don't have it, download and install it from Postman API Platform

3. Import the downloaded file to Postman

4. To start, you need to get an access token: navigate to Get OPENID Token request, Pre-request Script tab

5. Change the following parameters. You can use any created user:

6. Click Send button to complete the request

7. All other requests within the collection represent a specific API action you can perform. Among the list, select a request you want to perform. You can click on the request to expand its details and modify any necessary parameters. For example, to create x-bees conversation, perform POST https://api.x-bees.com/v1/conversations/. If needed, change parameters in Body section

Retail 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 retail assistants 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 conference management to improve efficiency.

To access x-hoppers Analytics, follow these steps:

• Open x-bees and navigate to Analytics menu, Liveboards tab

• Select “x-hoppers: Agents Stats” Liveboard to view Agents or Stores Stats or

• Select “Demo: x-hoppers HelpPoints” Liveboard to demonstrate the usage of help points. Note, that stats for this report are artificially generated. To show the real stats per a specific PBX, select “x-hoppers HelpPoints”

Voice-Enabled User Authorization

Retail assistants can log in to the broadcast via speech-to-text and verify their identity by voice footprint (either for all users or for users of specific Departments only).

Explore how to enable and demonstrate this feature in the documentation: https://x-hoppers.atlassian.net/wiki/x/AwAU

Push-to-talk from mobile app

This option allows sending of voice messages to x-hoppers broadcast from the mobile app (x-bees by Wildix mobile app can be downloaded from Apple Store or Google Play Market. Users can send voice messages to x-hoppers broadcast via mobile and receive broadcast messages to x-bees conversation, having them played automatically in Speaker mode. 

Explore how to enable and demonstrate this feature in the documentation x-hoppers Guide for Managers