Info |
---|
This Guide provides instructions for setting up, configuring and demonstrating the capabilities of x-hoppers Green Box. |
...
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.
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note | ||||||||
This page has moved! Follow the link https://x-hoppers.atlassian.net/wiki/x/RCDOAQ to check the detailed x-hoppers Documentation including Datasheet, Brochure, Use Cases and User Guides.Also you can watch dedicated video tutorials: |
What is inside the Box
...
x-hoppers Box content
...
Item
...
Quantity
...
Products
...
W-AIR Headset (2 earhooks, 2 neckbands, 2 headbands)
...
6
...
W-AIR Headset MultiCharger
...
1
...
W-AIR Small Business Base Station
...
1
...
Licenses
...
x-hoppers-backoffice
...
2
...
x-hoppers-SalesFloorHopper-AI
...
6
...
x-hoppers-SuperHopper-AI
...
1
The Box also includes chargers, plugs and x-hoppers keychain.
Licensing explanation
...
BackOffice
...
SalesFloorHopper + AI
...
SuperHopper + AI
...
For administration and support roles that are not client-facing
...
For retail assistants working on the shop floor
...
For managers and supervisors
...
Internal chats and meetings and external calls
...
Full-scale customer communication via chats, calls, meetings and website widget
CRM integrations
Contact center event logging
Internal broadcast channel
Customer service powered by AI prompts
...
Full-scale customer communication via chats, calls, meetings and website widget
CRM integrations
Contact center event logging and stats
Wallboard and analytics
Customer service powered by AI prompts
Datasheet
Note |
---|
Coming soon. |
How to assemble the Box
Tip |
---|
Note that W-AIR Small Business Base Station is already provisioned to your PBX and listed in WMS Devices menu, Devices tab. |
Step 1. Unpacking
When unpacking x-hoppers Green Box, please be aware that it consists of two layers, each with specific contents:
Top Layer:
W-AIR Headsets
x-hoppers keychain
Bottom Layer:
MultiCharger
W-AIR Small Business Base Station
Chargers and plugs
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. 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 WMS W-AIR devices tab
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
If you need any guidance, follow the instructions in W-AIR Headset User Guide. |
Step 4. 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
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
If you need any guidance, follow the instructions in W-AIR Headset User Guide, “Update of the Firmware” section. |
How to Set Up
Tip |
---|
Before proceeding with the setup, change the admin password and upgrade your PBX from rel60beta. |
Step 1. Mapping Green Box to PBX
By following this procedure, you ensure that your x-hoppers Green Box is correctly mapped to the appropriate PBX:
Access WMS and navigate to Users menu
Create a user profile with the following parameters:
Role -> Admin
Full Name -> DemoFlowUser
Extension -> 100
...
Navigate to PBX menu, Integrations -> Applications -> Simple Token tab
Create a token for the user 100 and copy its key
Scan any QR code located inside the box
After scanning, you will be redirected to a web page where you need to provide 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
...
Once the mapping process is completed, you can proceed to the further setup
Tip |
---|
You can always verify which PBX your particular box is mapped to by following this link:
|
Step 2. Creating users
Access WMS and navigate to Users menu
Create user profiles for each individual who will be using x-hoppers
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description on how to create users can be found in WMS Start Guide, “Adding users manually” section. |
Step 3. Assigning users to the Headsets
Navigate to Devices menu, W-AIR devices tab
Associate each user with their respective W-AIR Headset
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description on how to assign W-AIR Headsets can be found in x-hoppers Admin Guide, “Assign headsets to PBX users” section. |
Step 4. Configuring settings for demonstration
Navigate to Dialplan menu, Dialplan rules tab
Download and import the following Dialplan procedures in Dialplan rules tab
- required for playing notifications for x-hoppers users if one of the help points is triggered and demonstrating click and collect scenarioView file name "XHoppersHelpPoints" and "clickcollect" Dialplan procedures.bkp
...
View file | ||
---|---|---|
|
...
Add the following Dialplan applications:
Set -> Language -> choose language
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" -> ChatGPT procedure
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
...
Tip |
---|
If you need to customize Dialplan procedures to your specific language, install a dedicated sound package that corresponds to your language in WMS Settings -> PBX -> Language & Region and make changes for the following Dialplan applications:
|
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
...
Tip |
---|
With the variable HelpPointX, where X is a help point ID, you can customize the content of audio alerts sent to users and create any additional help points if needed. Please note that Help points 1-10 are preserved so you need to start adding from HelpPoint11. |
Navigate to Call Groups tab and create a new call group specifically for handling assistance requests triggered by QR codes (it is needed for Help point 3 scenario). 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)
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
...
Log in to x-bees and create x-bees conversation with all the users that are participating in x-hoppers conference and also needed managers. In the next step, you will need to copy its ID
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description on how to create x-bees conversations can be found in x-bees User Guide, “Conversations” section. |
...
To gather and post transcriptions of conversations, use these commands in Terminal:
create directory /etc/systemd/system/pbx-data-engine.service.d
Code Block # mkdir /etc/systemd/system/pbx-data-engine.service.d
add the following key to the file
Code Block # vi /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
Code Block [ { "audio_conf_id": "2", "xbees_channel_id": "f6d17593-98b6-471d-941a-cd03153f" } ]
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:
Code Block # systemctl daemon-reload # systemctl restart pbx-data-engine
Step 5. Installing W-AIR firmware for managing incoming calls
Tip |
---|
This step is temporary until the stable firmware version is released. |
Download the firmware package: https://drive.google.com/file/d/1xFin3lGk581LX-32fWaGXl9Hv3dbalFe/view?usp=drive_link
Upload the package from your PC to the PBX using the FileZilla tool (SFTP) or the console
Code Block scp -P2222 wms-wildixair-firmwares_6.05.20230926.1~786e2dc8_all.deb admin@pbx_domain.wildixin.com:/home/admin
admin@pbx_domain.wildixin.com -> insert your PBX domain name
Access home/admin directory
Code Block cd /home/admin/
Unpack the package
Code Block dpkg -i wms-wildixair-firmwares_6.05.20230926.1~786e2dc8_all.deb
Navigate to WMS Devices menu, select the W-AIR Base Station and click Configure / Sync device
W-AIR Headsets start updating, you can check the status on the Base station’s web interface
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description on W-AIR Headsets firmware update can be found in W-AIR Headset User Guide, “Update of the Firmware” section. |
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 or using tablets and utilizing x-bees for gathering and posting content, while advanced scenarios showcase integration with Veesion and ChatGPT, taking communication to the next level.
Tip |
---|
To showcase tablet scenarios, you do not need to have an actual tablet, you can use a web version by using the link:
|
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 lifted from the charging cradle.
To start speaking in the broadcast, use one of the options:
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
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 Mute button is pressed again or till the Headset is placed to the Charger
It is also possible to manage incoming and outgoing calls. Once a call ends, the Headset will automatically return to the broadcast.
To answer incoming calls:
Double-press Call button to answer the call
Double-press AUX Function button to finish the call
To make outgoing calls:
Open x-bees app on your device
Access the dialpad within the app
Before placing the call, select the Headset as the audio output device to ensure the call audio is routed through the Headset
Dial the desired number using the dialpad and initiate the call
Tip |
---|
Wildix desk phones can also join the broadcast, as long as they are connected to the same PBX. We suggest connecting SuperVision (specifically relevant for managers) and joining the broadcast via one of the following options:
In case you need to join several broadcasts, you can set a dedicated Function key to enter each broadcast. |
Basic scenarios
Tip |
---|
Ensure that all demo users are connected to an audio conference set up in Dialplan (in our example, conf 2), as all audio alerts are delivered to this specific conference. |
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
Tip |
---|
This scenario is applicable for demonstrating QR code usage only. |
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:
Scan the QR code 2
Upon scanning the QR code, x-hoppers system sends an audio 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
Help point 3. Direct call for assistance
In this scenario, Help point 3 is designed to enable customers to initiate a direct call for immediate assistance.
To demonstrate:
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)
Upon triggering the help point, the system redirects customers 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
Double-press Call button to answer the call, double-press AUX Function button to finish the call
Help point 4. Click and Collect (optional)
In this scenario, Help point 4 is designed to simplify the process for customers who have placed orders online. Customers can effortlessly collect their online orders in-store by entering their order ID on a dedicated tablet, leading to immediate notifications for retail assistants through x-hoppers broadcast.
To demonstrate:
Follow the link designed for tablets https://x-hoppers-tablet.wildix.com/?box_id=X&key=X&action_id=4 (insert your own box_id and key instead of X)
Upon triggering the help point, customers need to enter a number of their order
...
Users who are wearing W-AIR headsets hear a prompt that informs them about the specific help point being triggered and a customer's product interest. For example, the prompt might be: "Order number ${text} has arrived for collection, Order number ${text} has arrived for collection" (you can customize it in clickcollect Dialplan procedure)
Simultaneously, after triggering the help point, x-hoppers displays a message to customers indicating that their request was received and is being addressed
Transcribe and post all in-store conversations in x-bees channel
x-hoppers offers a valuable feature that allows you to transcribe and post all in-store conversations to a dedicated x-bees channel. This capability ensures that important discussions and insights are easily accessible to team members.
To demonstrate:
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 the conference conversations are automatically displayed in x-bees channel
Managers and team members with access to 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 and receive answers.
Note |
---|
For the current development stage, users are limited to asking one question. To ask another question, put the Headset into the Charger and then lift it again. This restarts the interaction, allowing users to ask a new question. |
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
Posting in x-bees channels using APIs
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:
Download the following JSON file containing a collection of practical API examples:
View file name X-BEES API_Postman_collection.json Make sure you have Postman installed on your computer. If you don't have it, download and install it from Postman API Platform
Import the downloaded file to Postman
To start, you need to get an access token: navigate to Get OPENID Token request, Pre-request Script tab
Change the following parameters. You can use any created user:
Code Block <<USER EXTENSION>> <<USER PASSWORD>> <<PBX DOMAIN>>
Click Send button to complete the request
Note |
---|
Important: The access token is valid for 1 hour. After that it expires and needs to be refreshed. |
...
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
...
Here are some tips for obtaining conversation, message and member IDs:
{conversationId}: Firstly, you can copy it from x-bees. Secondly, when you create a conversation via the API, the conversation ID is typically available in the response
{memberId}: Use emails of created users
{messageId}: When you send a message via the API, its ID is typically available in the response. Alternatively, you can request a list of messages for a specific conversation and find the message ID in the response
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. 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
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description of x-hoppers Analytics can be found in x-hoppers Agents Stats. BgBJ to go to the new separate x-hoppers knowledge base. |
...