How to set up Voice Bot for x-hoppers

Introduction

Voice bot is a versatile tool that allows store associates to ask questions and instantly receive answers right via x-hoppers headset. Powered with this AI tool, x-hoppers can process questions and generate responses based on its knowledge base (e.g. for questions about company information), which is played back through a user’s headset. Also, Voice bots allow to call a colleague, or, in case there are multiple broadcast channels, easily switch between them.

For detailed description of Voice bot use cases and setup options, check out the guide How to configure Voice Bots.

Requirements

• WMS 6.08.20241029.2 or higher

• License ____

Voice Bot Setup

To add a Voice Bot, follow the steps below:

• Go to x-hoppers admin -> PBX -> Integrations -> Cloud integrations -> Voice Bots

• Click Add New Voicebot:

• Enter Voice bot name and first message, that will be played to a user calling the Voice bot:

• Select the integration type
  In our examples below, we will use the Generative AI integration type for various Voice bot scenarios. To read more about different types of Voice bot integration available, check out the guide: How to configure Voice Bots.

Then, follow the instrustions below to configure different Voice bot options:

Process Questions

In the Instructions field of the Voice bot, provide clear detailed instructions on how the bot should interact with users:

Example:

You are a friendly call assistant for {Company name} employees.

Your responsibility is to serve as a virtual call assistant. You listen to spoken commands from the user, interpret the intent, provide answers to questions when asked, and route calls to the corresponding tool or dialplan within Wildix telephony system. You can perform the following tasks:

Provide answers to questions:

Listen: Capture and process user questions with accuracy, allowing natural language variations.

Provide clear and precise answers from your knowledge base. 

Call Routing:

Listen: Capture and process user commands with accuracy, allowing natural language variations.

Interpret: Map user commands to specific routing options (e.g. switch to another broadcast, dial a colleague).

Route: Forward calls to appropriate dialplans/ tools based on command interpretation.

Error Handling & Feedback:

Unrecognised Commands: If the command isn't understood, respond with helpful feedback, such as: "I didn't understand your command. Please try again."

Unavailable Commands: If the command is not recognised, but there is a similar command, inform the user and offer a list of options available.

Retries: Allow the user a chance to rephrase or repeat the command if an error occurs.

Note: The number of tokens one Voice bot can supports is _____. However, you can configure multiple Voice bots, so there is the main Voice bot that delegates certain requests to other Voice bots.

You can do it via the Delegate tool:

• Go to the Tools section, click Add tool:

• Choose the option Delegate:

• Enter ID of the Voice bot to which the request should be delegated and provide description with clear instructions:

• Click Save to apply the changes.

Rejoin Broadcast

• In the Tools section, click Add tool:

• Choose the Transfer option:

• Fill out the fields:

  • Description: e.g. Transfer if someone asks to rejoin broadcast or join broadcast

  • Context: enter the name of the Dialplan where the call should be transferred to

  • Destination: leave it Predefined

  • Extension: *Wairhotline*

  • Pipeline: choose the option “Transfer the call without replying”, so that user joins the broadcast without any additional audio playback from the Voice bot

• Click Save to save the changes

Switch Broadcast

In case there are several broadcasts and store associates need to switch between them, you can follow the below setup instructions:

• In the Tools section, click Add tool:

• Choose the Transfer option:

• Fill out the fields:

  • Description: e.g. Transfer if someone asks to switch broadcast or change broadcast

  • Context: enter the name of the Dialplan where the call should be transferred to

  • Destination: leave it Predefined

  • Extension: _________?

  • Pipeline: choose the option “Transfer the call without replying”, so that user joins the broadcast without any additional audio playback from the Voice bot

Dial-by-name for calling colleagues

Dial-by-name feature gives possibility for store associates to call a colleague right via x-hoppers headset.

For detailed information and setup instructions, check out the guide How to set up and use Dial-by-name feature.

Dialplan Configuration

You need to add the created Voice bot to the *wair* section of x-hoppers Dialpan, to let store associates access Voice bot functionality via x-hoppers headset. Add the following applications under *wair* number:

• Set -> Codecs -> alaw, ulaw

• Set -> Language -> select the language

• Voice Bot application -> choose the necessary Voice Bot from the list

Usage

Start a call

1. Double-press the AUX Function button

2. After the welcome message, press and hold the Push-to-talk button to unmute yourself

3. Ask the AI Assistant to make a call to the necessary colleague, providing the colleague ID or name, e.g. “Make a call to 335” or “Call John Doe”

The x-hoppers system processes the request and initiates a call to the necessary colleague.______

End a call _______ CHECK

• To end a call and return to the broadcast, double-press the AUX Function button. - or ask to return to the broadcast??

Switch between a call and the broadcast _______ CHECK

• To put the call on hold and switch to the broadcast, double-press the Push-to-talk button.

You hear “Call swapped” every time you switch from the call to broadcast and back.