Info |
---|
This Guide provides instructions for setting up, configuring and demonstrating the capabilities of x-hoppers Green Box. Created: August 2023 Updated: January February 2024 Permalink: https://wildix.atlassian.net/wiki/x/B4BeDw |
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
If you need any additional guidance on the Headsets registration, follow the instructions in W-AIR Headset User Guide. |
...
Tip |
---|
Before proceeding with the setup, change the admin password and upgrade your PBX from rel60rel60beta. |
Step 1. Mapping Green Box to PBX
...
Scan any QR code located inside the boxBox
After scanning, you will be redirected to a web page where you need to provide insert the necessary data to map the box 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
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description on how to create users can be found in WMS Start Guide, “Adding users manually” section. |
...
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. |
...
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
- required for ChatGPT IntegrationView file name "ChatGPT" Dialplan procedure.bkp
- required for dialling into x-hoppers broadcasts remotelyView file name x-hoppers remote join demo.bkp
...
Modify the users Dialplan by adding *Wairhotline*as a called number and 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" -> select 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
...
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-data-engine
Configuring Voice-Enabled User Authorization
Note |
---|
The verification of users by voice will be available after Feb 13, 2024. |
Within x-hoppers, you can enable the logic of assigning W-AIR headsets to users via speech-to-text and verify their identity by voice footprint. In this chapter, we will explore how to enable and use this feature.
By default, this feature is disabled and can be activated by adding the following parameter to the
/etc/systemd/system/pbx-data-engine.service.d/override.conf
fileCode Block --xhop_voice_login true
Install the specific libraries to enable verification of identity by voice using this command
Code Block pip install librosa
- set up the Dialplan to allow users to record their voice footprint.View file name x-hoppers_auth.bkp Add the variable
XHOP_VOICE_AUTH=yes
to WMS -> Dialplan -> General Settings -> Set dialplan variables field
When the feature is enabled:
Users need to call the designated number in the Dialplan and follow the instructions to record their voice footprints
Upon lifting W-AIR headset, users are prompted to say their name and surname
The system matches the pronunciation with user records and assigns the headset accordingly
Each time the headset is placed into the charger, it gets unassigned meaning that it gets Service license type
If you have already assigned the headsets via WMS, to initiate this feature:
After enabling, for the first headset use, users need to lift the headset from the charger, place it back, and then lift it again
Alternatively, before activation, unassign headsets via WMS (Devices -> choose device -> click Assign to user -> in the Extension field, choose “unknown”). Subsequently, users should press the Call button when lifting the headsets from the charger.
Step 5. Installing W-AIR firmware for managing incoming calls
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description on W-AIR Headsets firmware update can be found in W-AIR Headset User Guide, “Update of the Firmware” section. |
...
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).
...
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. |
Joining the broadcasts remotely
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.
...
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 statics per a specific PBX, select “x-hoppers HelpPoints”
Tip: To generate statistics for multiple stores, it is necessary to have multiple active conferences.
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Note: Detailed description of x-hoppers Analytics can be found in x-hoppers Agents and Stores StatsAnalytics. |