x-hoppers Green Box Documentation

Introduction

x-hoppers is an innovative Retail Headset System design 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 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

x-hoppers Box content

+keychain

Licensing explanation

Datasheet

How to assemble the Box

Step 1. Unpacking

Carefully unpack all components from the Box. Verify that you have received all the items listed in the package.

Step 2. Charging W-AIR Headsets

Place the Headsets into the Charger one by one. Ensure they are properly seated and charging. Allow at least 10 hours for the full charging before use.

Step 3. Provisioning W-AIR Base Station

• Access WMS and navigate to Devices menu, Devices tab

• Click + Add button to provision the device

• Insert the Base Station’s MAC address and copy the Provisioning link

• Access the Base Station’s web interface (credentials for the first time access: admin : admin), navigate to Management menu and insert the link, click Save and Reboot button

Step 4. Registering W-AIR Headsets

• Put the Headset in the registration mode by pressing Call, Volume+ and Volume- buttons at the same time 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”

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

• After the registration, all the Headsets are listed in W-AIR devices tab

Step 5. Updating Firmware

• To update the firmware of the Base Station, navigate to Devices tab, select the Base and click Configure/Sync button. Wait for several minutes, note that during the update, the device is rebooted. As soon as the update procedure is finished, the new fw version appears in Devices tab and the Base Station is no longer marked with the blue color

• After successful registration of W-AIR Headsets, put them into the Charger to update firmware. You can check the progress on the web interface of the W-AIR base.

How to Set Up

Step 1. Creating users

• Access WMS and navigate to Users menu

• Create user profiles for each individual who will be using x-hoppers

Step 2. Assigning users to the Headsets

• Navigate to Devices menu, W-AIR devices tab

• Associate each user with their respective W-AIR Headset

Step 3. Configuring Dialplan for joining the broadcast

• Navigate to Diaplan menu, Dialplan rules tab

• Modify the users Dialplan by adding *wair* as a called number

• Add the following Dialplan applications:

  • 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 “Joining the conference”

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

Step 4. Configuring settings for demonstration

• Download and import the following Dialplan procedures in Dialplan rules tab

  • - required for playing notifications for x-hoppers users after scanning QR codes

  • - required for ChatGPT integration

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

  • HelpPoint1=QR 1 is scanned. Customer is looking for help in fresh fruits area

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

• Navigate to Call Groups tab and create a new call group specifically for handling assistance requests triggered by QR codes (it is needed for QR code 3 scenario)

• Proceed to Dialplan rules tab and select kite Dialplan procedure

• Add 223344 as the called number and "Call group" Dialplan application to the chosen number

• In the Call Group application settings, select the call group that you created

• Create x-bees conversation with all the users that are participating in the x-hoppers conference and also needed managers, copy its ID

• To gather and post transcription 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: 

    # vi /etc/systemd/system/pbx-data-engine.service.d/override.conf
     
    [Service]
    ExecStart=
    ExecStart=/usr/sbin/pbx_data_engine.py --conf_recording

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

    # systemctl daemon-reload
    # systemctl restart pbx-data-engine

  • 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

How to perform the Demo 

During a demonstration of x-hoppers, you can present both basic and advanced scenarios to showcase the system's capabilities. Basic scenarios involve scanning QR codes and utilizing x-bees for gathering and posting content, while advanced scenarios showcase integration with Veesion and ChatGPT, taking communication to the next level.

Joining the broadcast

The broadcast is the core functionality of x-hoppers, it refers to the network created by the system that enables real-time communication between x-hoppers users (retail assistants).

x-hoppers users are connected to the broadcast in Retail mode (muted) by default once W-AIR Headsets are left up from the charging cradle.

To start speaking in the broadcast, use one of the options:

1. Call button: press and hold the button to get unmuted. You stay unmuted only while pressing the button. When the button is released, the Headset goes back to mute

2. Mute button: press the 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 to the Charger

Basic scenarios

QR code 1. Help is required in a specific area 

This use case involves scanning a QR code when customers need assistance in a specific area, for example, the fresh fruits section of a store. 

To demonstrate:

• Scan the QR code 1

• Upon scanning the QR code, x-hoppers system triggers an alert

• Users who are wearing W-AIR headsets hear a prompt through the broadcast channel. The prompt informs about the specific QR code that was scanned 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 scanning the QR code, x-hoppers triggers an update for customers by displaying a message indicating that their request for help was received and is being addressed

QR code 2. Customer is interested in a specific product 

In this use case, a QR code 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:

• Scan the QR code 2

• Upon scanning the QR code, x-hoppers system triggers an alert

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

• 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

QR code 3. Direct call for assistance

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

To demonstrate:

• Scan the QR code 3

• Upon scanning the QR code, the system triggers a redirection to Kite web page

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

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

QR code 4. Click and Collect (optional)

You can create a QR code

Transcribe and post all in-store conversations in x-bees channel

• Initiate and hold conference conversations using W-AIR Headsets

• The system automatically records and transcribes everything that is said during the conversations

• The transcriptions of conference conversations are automatically displayed in x-bees channel

• Managers and team members with access to the x-bees channel can view the transcriptions in real time. This allows them to monitor discussions, decisions, and interactions that occurred during the conference

Advanced scenarios

ChatGPT Integration

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, receive answers

To demonstrate:

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

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

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

Veesion Integration

Integrating Veesion's AI-powered security cameras with x-hoppers opens up a new level of security monitoring. In this demo, you can showcase how alerts and videos from Veesion can be seamlessly posted to x-bees channel using Postman.