Question Step
Last updated
Was this helpful?
Last updated
Was this helpful?
Quick answers are convenient for users to click on rather than type. When you set quick answer:
"Answer Text" is shown to users while "Answer Value" is saved to the variable.
In the question box, for example, put "reply 1 for service A, reply 2 for service B", etc. Then in the quick answer, set "Answer Text" to be "1", "2", etc for matching, and "Answer Value" to be "service A", "service B", etc to save the user's option.
Channel
How to Provide Quick Answers
quick answers will be displayed as buttons
Telegram
quick answers will be displayed as buttons
use buttons instead of quick answer or give prompt
quick answers will show in "Select Option"
SMS
give prompt
Voice
give prompt and use Speech question or DTMF question to ask for keypad/voice input
quick answers will be displayed as buttons
Once the user's input contains one of the "Answer Text", the quick answer is matched (non-case-sensitive). Plus, the order of those quick answers matters because the bot will check in order. Once a quick answer matched, it will stop the matching.
Add a skip button if the question is ok to skip. Also, the label of the skip button is editable.
"No Match" is a very practical feature because different answer types have different specified patterns. Email address, for example, has to be "[email protected]". You can put something like "Wrong email, please try again" as your retry message and jump to another step if there is no match several times.
However, a "[email protected]" format just filters out the wrong email format but a fake email still can pass it. To check whether an email is real or not, try Mini-App for using a third-party verification tool.
Similarly, "No Input" helps you redirect the flow when user input expires. By default, a question expires in 1 hour. Make it shorter if needed.
When the user uploads a document, an URL link pointing to the document is saved in the variable rather than the document itself. Because media document can be very large. Later, if you want to send that document in send message step, you will need to choose "Send Media From URL" and type in the variable there.
This is a question-type listing with limited quick answers, and users have to choose only from these quick answers. For example, when choosing property type, list only house, townhouse and apartment as quick answers. Therefore, if the user doesn't click one of these three, a retry message appears.
The basic validation for Phone number Question is:
only these 11 characters are allowed: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, +.
"+" sign is only allowed in the front of the phone
The basic validation for the Phone number Question is:
only these 11 characters are allowed: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, +.
"+" sign is only allowed in the front of the phone
more than 6 characters
Speech is usually used to get short answers. When the bot asks for speech input, it will listen to the user's words and convert the speech to text with a confidence score. The score is between 0 and 1. The closer to 1, the more confident the speech analysis was.
Use "Advanced Settings" to help improve the conversion:
DTMF refers to keypad input, including numbers 0 to 9, * and #. Usually, it is used to make a main menu for your voice bot, just like what you might hear before "Hi, press 1 for xxx, press 2 for xxx, ..."
"Number of Digits" means how many digits to expect. For example, a credit card number needs 14 or 16 digits while a postcode needs 4 or 6 digits.
"Stop Key" is set to "#" by default, but it is also editable. You will need "Stop Key" when you don't know how many digits to expect. Don't forget to mention the "Stop Key" in the question box. 🤖🤖
"No Input" timeout in Voice Question plays an important role. Often, it will be set to just a few seconds while in other channels, the default timeout is 1 hour.
Again, same as asking for a picture, audio, video or file, you will need a text variable to save the URL link of the record file. Check advanced settings for more details such as "Stop Key" and "Max Record Duration".
You will be able to access the record file through the URL link or manually from the "Recordings" section shown below:
Here you can see all your "Record Question" and "Transfer" recordings with a "Play" button to play the audio.
The transfer feature is more like an Action rather than a Question. Since actions in the Action step are shared across all the channels, we put transfers in the Question steps.
You can record the conversation after transferring for training purposes, etc. Similarly, check the recording from the "Recordings" section from the left sidebar.
One thing to mention, if your clients need to come back to the bot after the transferred conversation. There are 2 ways to do so:
the transferred party hang up first
your clients press the star key (need to enable the option in advanced settings)
In either way, don't forget to mention it to your clients before the transfer.
Add extension to a phone number by using a hash key. e.g. +61412345678#wwww1234. Each "w" will wait for half a second.
Let say I have a voice bot for the number +61412345678, and I put a DTMF question after the Start point of the main flow. The extension "1234" will be considered as the input for this DTMF question. In this way, you are routing the calls automatically.
You can put multiple numbers in the "Transfer To Phone Number" field, separated by ONLY commas. e.g. +61412345678,+61412345679#wwww1234,+61412345670
The bot will call these 3 numbers simultaneously, the first person who answers the call get this transfer, the rest call stops ringing. Your phone number provider will only charge you for one call because only one number is transferred successfully.
The payment feature is more like an Action rather than a Question.
For Twilio users, you will need to enable the PCI mode in your Twilio account to capture a payment either in test or live mode.
Search "Voice Settings" from your account,
click the "Enable" button:
All prompts are already set in English. Feel free to change it if needed like changing to another language. There are 4 pieces of information to gather for a card.
Credit Card Number
Expiration Date
CVV
Postcode (if needed, enable the option in advanced settings).
Each piece of information has 3 speeches to set, asking, timeout and invalid:
Install, name a "UNIQUE NAME" yourself and click "Connect with Stripe". This "UNIQUE NAME" is then your "Unique connector ID", copy it back to the chatbot.
Put a direct number like "99.99" or a number variable here.
You will need a JSON variable to hold the payment result. This is a response example including some card details, confirmation code and payment result.
You can deal with the situation via the "Payment Fail" option. For example, send "Something went wrong" and go to the Payment Step again.
You can choose to capture a payment right now or later.
If you decide to charge right away:
give a value more than 0 in the "Charge Amount" box
If you want to get the payment later
put a "0" in the "Charge Amount" box. In this way, you will get a token for future capture.
Under the situation that you set the charge amount to "0", if you enable the "One Time Token" option in advanced settings, you will get a one-time token. Otherwise you get a reusable token.
By different combinations of charge amount and "One Time Token" option, you will get different payment results:
Charge Amount
One Time Token
What Will Happen
Payment Result
0
Enabled
get one-time token
​
> 0, e.g. 5
Enabled
charge $5
​
0
Disabled
get reusable token
​
> 0, e.g. 5
Disabled
charge $5
​
That means, whenever you set a charge amount greater than 0, it doesn't matter whether you enable the One Time Token option or not, you will charge your client right away and get a payment confirmation code. The code starts with "ch_" if you are using Twilio.
On the other hand, an one-time token starts with "tok_" if you are using Twilio. And a reusable token refers to customer's ID, starting with "cus_" if you are using Stripe.
Check the documentation of how to create a charge with your payment service provider. Let's take Stipe as an example, to make a payment with a reusable token.
In the example, a post request is sent to Stripe with a testing API key and a charge amount, currency and the reusable token, i.e. the customer ID.
After hitting the test button, this is the response if it succeeds:
In the response, you can see there is an id starting with "ch_", which is the payment confirmation code. That means you've successfully made a payment.
"Description" is submitted along with the payment details. For example, you can put “Payment of $20.52 submitted from Phone Number (xxx)-xxx-xxxx” to create a record to show which call created the payment.
Use the following card details for testing if needed:
Credit card number: 4242 4242 4242 4242
Expiry date (MM/YY): 12 25 (pick a date in the future)
Select the corresponding speech model and language. "Numbers and Commands" speech mode can help improve the recognition rate when the answer is a string of numbers, etc. . More importantly, provide the bot with some hints, keywords that might appear in speech (separated by commas and no space).
To get a "Payment Connector", which is a "Unique connector ID", you will need to access your phone number provider and payment service provider. Twilio and Stripe, for example, go to , follow steps 1 to 4 in the following 2 screens:
