Info |
---|
This glossary includes the most commonly used x-hoppers terms and features and their descriptionsdocument provides description of Voice Bots feature, setup instructions, use cases and overview of how you can benefit from using Voice Assistant. Created: November 2024 Updated: December 2024 Permalink: https://x-hoppers.atlassian.net/wiki/x/DAD8B |
...
Enter Voice Bot name
Enter First message (optional)
Select the integration type for processing events:
Generative AI
Webhook
AWS SQS
Dialogflow CX
OpenAI Assistant
Fill out the necessary fields depending on the selected integration type (see instructions below)
...
Add Tools:
Tools allow a Voice Bot to execute specific tasks during a call. By integrating tools, you can align your Voice Bots with your existing workflow. See the list of available tools below:Transfer: allows to transfer a call to an agent or route via Dialplan
Delegate: gives possibility to delegate user’s request to another Voice Bot
Hangup: allows the Voice Bot to end a call by himself it the call is considered finished
Wait: allows to analyze the the user’s response and wait for more input if the response was incomplete
Third-party Function: gives possibility to integrate Voice Bot with various API options
To add a tool:
Click Add Tool -> choose the necessary option:
...
Fill out the necessary details:
...
Configure Advanced Configuration:
Interruption Detection: if enabled, customers can interrupt the bot and the system will stop the playback of the voice bot's response. By default, the option is disabled.
Silence Timeout: set the timeout before a call is automatically ended due to inactivity and the action (hangup or transfer) that should be performed when the call ends.
In case you choose to transfer the call after the Voice Bot reaches the silence timeout, you need to specify:Context: the Dialplan procedure
Extension: extension to which the call should be transferred
...
Maximum Duration: the maximum duration of a call in seconds and action (hangup or transfer) that should be performed when the call ends.
...
Click Add to save your Voice Bot
...
On the screen that pops up, type the word “delete” and click Delete:
...
Dialplan Configuration
...
Set Voice Bot in a Dialplan
...
Set a language which the Voice Bot will use: add Set application -> Language -> select the language
Info |
---|
Note:
|
Add the Voice Bot application and choose the necessary Voice Bot from the list:
...
Note |
---|
Note: Voice bot cannot be started in case the call was answered with opus codec. To avoid such a scenario, you can set alaw/ ulaw codecs in Dialplan: add Set application -> Codecs -> alaw, ulaw: |
Choose speaker
Info |
---|
Note: The support starts from WMS 6.09.20241129.1. |
You can change the default speaker by adding the following applications before the Voice Bot application in the Dialplan:
Set application -> choose the parameter Language - > choose language
Set application -> choose the parameter TTS Voice - > select speaker:
...
Traces
In Traces section you can see a table with the following information: Session ID, Voice Bot name, Caller, Duration of the call, date and language. :
...
Clicking on a session in Traces, you can view events of the session.:
...
Voice Bots API
You can find Voice Bots API here: https://docs.wildix.com/api-reference/rest/wim/voicebots/#/
Use Case: Using Voice Bots with Chat Bots
You can enhance your experience of using Voice Bot feature by combining it with Chat Bots (you can find Chat Bots documentation here: https://wildix.atlassian.net/wiki/x/4APOAQ ). For example, you can set up Voice Bot that would gather information from a customer and send it to the conversation with managers via a Chat Bot:
Step 1. Create a Chat Bot
Go to WMS -> PBX -> Integrations -> Cloud integrations
Select Chat Bots and click Add new Chatbot
Enter a name for your chatbot
Select the Webhook integration type for processing chat events
Fill out the Target field
Enable Allow users to find the bot using search checkbox to let users interact with the bot
Click Add to save and activate your chatbot
...
After creating the bot, click on Manage API keys to create API key:
Click Create new API Key
Enter a name for identification
Click Create and copy the secret using the Click to reveal button. You will need the secret when configuring Voice Bot.
...
Step 2. Create a conversation
Create a conversation in x-bees where you need to add the Chat Bot you’ve created as well as the managers who should receive the notifications.
Also, make sure to copy conversation ID, which will be required during Voice Bot creation:
...
Step 3. Create Voice Bot
Configure Voice Bot of Generative AI integration type.
In our example, we’ve used the following text as the First Message:
Hello! Do you have any complaints or suggestions regarding Wildix products?
And added the following instructions:
You are a customer care agent that collects all the complaints and suggestions about Wildix products. Try to understand with which product customer is having problems or has a suggestion. Carefully collect all the details. Then pass them to the manager in the chat.
Share with the manager any emotions or sentiments the customer had if any. Ask the customer their name before passing the information to the manager and remember to pass the customer's name as well. Hang up after saying thank you and good-bye if the customer says they have nothing else to add.
In Tools section, add Hangup and Third-party Function options:
...
We’ve used the following parameters in the Parameters section of Third-party Function section:
Code Block |
---|
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The message to the manager containing all the details about complains and suggestions collected from a customer"
}
},
"required": [
"text"
]
} |
In Integration section, in the URL field (1) next to the POST Method, entered the following data:
Code Block |
---|
https://api.x-bees.com/v2/conversations/channels/{Conversation_ID}/messages |
Where {Conversation_ID} is the ID of the conversation from Step 2.
Click Add authorization and enter the Secret from Step 1 into the Bearer field (2):
...
Click Save to save the changes.
Step 4. Configure Dialplan
Set up Voice Bot in the Dialplan:
...
When calling the number set in the Dialplan, the call is answered by Voice Bot, which gathers the required information and send it to the conversation:
...