Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

...

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

Chats and videoconferencing

Using x-bees apps

Adding guests to conversations

Integrations

Personal contact-me link, meeting scheduler, website widget

Website widget setup

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 
(max 2 calls on DECT headset) 

Up to 10 devices / 8 calls
(max 2 calls on DECT headset)

Up to 10 devices / 8 calls 

Contact center events logging

DECT headset included

Internal broadcast channel

Customer service powered by AI prompts

Wallboard and analytics

Tippanel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note:

  • Before WMS 6.04.20230920.1:
    You need to assign "Business" license to all the users who need "x-hoppers-SalesFloorHopper" and "x-hoppers-SalesFloorHopper_AI" licenses.
    Possibility to assign all types of x-hoppers licenses on PBX for each single user is coming soon. 

  • Starting from WMS 6.04.20230920.1:
    The relevant licenses can be assigned to users via WMS -> Users -> Edit user -> License type field. See more in PBX Licensing and Activation - Admin guide (section "Assign correct license type to each user").

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

...

7 - Volume+ button

8 - Speaker

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: There are 2 button combinations that have to be pressed at the same time:

Register - Call, Volume+ and Volume-

Power off - AUX function, Volume+ and Volume-

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-Сharger overview

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

...

Before headsets can be assigned to specific users, they need to be registered to W-AIR Base Station. 

Note

Limitation: It is impossible to register a headset if the code of DECT network set up in WMS → Devices → W-AIR Networks is different from "0000" (default code).

Workaround: you can temporarily change the code to default one ("0000") on the W-AIR Networks page in WMS, register and assign the Headset(s), and then change it back to the custom one.

...

info

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: In case you have several W-AIR networks (for example, in a test environment), the Headset might register to a Base station belonging to another network. In such a situation it’s recommended to hold the Headset closer to the Base station you would like to register it to.

  1. 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”.

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

Note: If
Info
Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: If the registration fails, the voice prompt announces “Headset not subscribed”. Before trying to register the Headset again, please check if it is within range of W-AIR Base station and the voice prompt announces “Registering”.

...

  1. Go to WMS -> Devices -> W-AIR devices

  2. Choose the headset and click Assign to user

  3. Enter user extension and click Save.  

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: After assigning headsets to users, to figure out which headset belongs to whom, you can dial users’ extensions and see which headsets respond.

...

  • Retail Mode: On

  • Audio feedback: Voice

  • Silent charging: On

  • Silent mode: Off

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Notes:

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

  • Starting from WMS 6.01.20221122.1, it is possible to control silent charging setting (with default "on" setting, there is only LED indication while charging; you can set headsets to have both LED indication and audio while charging, or configure the headset to be disconnected without possibility to receive calls while charging). See the document Provisioning Custom Settings for more instructions. 

...

  1. Choose the headset on the W-AIR devices tab -> click Assign to user

  2. Select “unknown” in the Extension field and click Save.  

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Documentation: WMS Start Guide: Devices management.

...

  1. Click Add number

  2. Enter *Wairhotline*

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: It is the value which is dialled by the headset in the Retail mode. This value is default and should not be changed.

  1. Add the below 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 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. 

...

    • , etc. 

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Documentation: Dialplan Applications - Admin Guide.

...

  • A user should dial the feature code for Conference access (98 by default) + the conference room number. Example: 981 for conference room number 1.

  • Alternatively, a Dialplan can be configured so that when users dial a certain number, e.g. 333, the call is automatically put into the broadcast.

...

info
Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Documentation: Dialplan Applications - Admin Guide.

...

Code Block
curl -X POST --header 'Authorization: Bearer {token}'

https://{pbx domain}/api/v1/Originate -d

'channel=Local/999@myDialplan&application=System&async=true' -d

'variable=dst=777,dept=Sales,msg=help required at checkouts'

...

  • 999 (you can set a custom number) = the Dialplan rule that processes the request. 

  • dst = the rule in the outgoing Dialplan of users that should receive the announcement

  • dept =  department name

  • msg = the announcement: a text prompt or a path to an audio file stored on the PBX

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: msg and dept values can be wrapped in double quotation marks (“)

...

  1. Create a Dialplan rule with dst number (this can be any number that is not occupied by a user or by another real destination, e.g. 111 or 777) in the outgoing users Dialplan(s). If users have different Dialplans, the rule with dst number should be created in each of them (or it can be added as an included procedure). Configuration:

    • Set :: Language :: en (this one is needed for TTS processing)

    • Set(sound=${SHELL(/usr/sbin/data_engine_cli GetSound ${CALLERID(num)})})

    • Play sound :: ${sound}

Note

Important: In case of changing Department name, make sure to reload PBX engine to apply the changes:

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

Modifying the timeout of broadcast mute

...

Code Block
# systemctl daemon-reload
# systemctl restart pbx-data-engine
Infopanel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: For WMS versions prior to 6.07, instead of XHOP_UNHOLD_TIMEOUT, the parameter UNHOLD_TIMEOUT should be used.

...

Additionally, on the product web page you can place a Kite button, letting customers contact clerks or back office via chat, audio or video call. 

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Kite documentation: Wildix WebRTC Kite - Admin Guide - English.

...

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.

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Documentation: Developer Documentation.

Infopanel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: To protect the system from spam, you may set up CAPTCHA on your website before the call is initiated. 

...

On the Dialplan side, you need to configure the call to be sent to the broadcast with clerks. The call should be accompanied with notification via our Text-to-speech feature, to inform clerks which page was scanned/ where in the store assistance is required. QR codes require separate Dialplan entries. 

...

Dialplan entries. 

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Documentation: Dialplan applications - Admin Guide.

...

It is possible to configure recording of in-store conversation, with possibility to listen to it in CDR-View, as well as post x-hoppers broadcast content to x-bees channel.

...

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: The support starts from WMS 6.03.20230630.3. 

Note

Important: For correct work of the features of gathering and posting content to x-bees channel, a correct email has to be set up for all the users in the channel.

Record in-store conversations (listen in CDR-View)

...

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

    Code Block
    # mkdir /etc/systemd/system/pbx-data-engine.service.d
  2. Add the following key to the file:

    Code Block
    # 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
  3. Reload systemd and restart the service to apply the changes:

    Code Block
    # systemctl daemon-reload
    # systemctl restart pbx-data-engine
Note

Important: Reloading systemd is required each time you make any changes to the  /etc/systemd/system/pbx-data-engine.service.d/override.conf file.

Once enabled, the recording of in-store conversations get displayed in the CDR-View. Recording starts when a user unmutes themselves in the conference and starts talking.

Note

Current limitations:

  • Recording is not automatically stopped if user forgets to mute the headset.

  • For a new user who joins the conference, recording is automatically started even if the user is muted, and the recording file of about 3 seconds is saved on the PBX.

Post content to x-bees channel

...

It is possible to transcribe the content of x-hoppers conference (everything that was said during the day) and post it to x-bees conversation (both the transcription and the audio recording of each piece of the conversation). The transcription is posted on behalf of the users that were talking at a given moment.

Note

Important: Make sure you've also set up recording of the in-store conversations (see the "Record in-store conversations (listen in CDR-View)" section of this guide.

How to configure

  1. Create x-bees conversation with all the users that are participating in the x-hoppers conference and also needed managers.

  2. Copy x-bees conversation ID (available in the URL of the conversation)

  3. Add the following data to the /rw2/etc/pbx/x-hoppers.json file:

...

When the feature is enabled, whatever is told in the conference is automatically transcribed and displayed in x-bees conversation, so managers could monitor what was discussed in the conference.

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: If user talks for more than 60 seconds without a pause, the message is not transcribed.

How to increase volume for noisy environments

Infopanel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF

Note: The support starts from WMS Beta 6.03.20230601.1.

...