When you expect your client to use a specific word or a phrase, use Keywords. This query matching system is excellent when you want an interaction to be triggered precisely by a word or phrase, without considering the whole query.

Quick overview

• Keywords is never set as the default matching system.

• The matching system is configured individually for every user message.

• The system searches only for keywords, and ignores the rest of the query.

• If there are more matching systems available, keywords won’t be prioritized. Please, check the exceptions.

• The maximum distance between two keywords is one word.

How keywords works

Keywords matching system doesn’t analyze the whole user input but focuses on searching words on phrases defined in the user says. The confidence score error margin isn’t applied to this system so only precisely the same words are matched. The system accepts punctuation at the end of the word and maximum one word between keywords.

How to add the keywords in the User Input block

1. Create a new User Input or open the existing one.

2. Click the Add keyword button and fill out the input with your keyword.

3. That’s all! Now your user input will be triggered whenever a user will type this keyword in the ongoing chat.

Remember that to trigger the User Input user needs to be in the same context of the conversation. Read more about context here.

Remember that to trigger the User Input user needs to be in the same context of the conversation. Read more about context here.

Example

The best way to explain the behavior of keywords is to use an example. Imagine that you own a small food truck business, and your bot takes food orders. One of your most famous menu options is a hot dog.

With the updated keywords system we can take orders in a more precise way. Let’s check out some of the cases!

Now let’s see if the marching is successful using various user input:

• The client types: I would like to have a hot dog?
  ✅ This is perfect matching as our bot could find bot keywords.

• The client types: Can I have dog hot?
  ✅ That’s pretty clumsy way to make an order but yes, our bot understands queries in reverse order.

• The client types: Can I have hot a dog?
  ✅ The bot accepts maximum one word between our keywords. The bot takes the order.

• The client types: Can I get dog jdhgf hot?
  ✅ Probably a cat run through the keyboard. The bot will understand the query as there’s one allowed word between keywords and the bot accepts reversed order.

• The client types: Can I get a hut dog?
  ❌ The order won’t be taken. There’s a typo in the word hot.

• The client types: Can I come with my dog. It’s really hot outside.
  ❌ Too many words between our keywords. The bot won’t recognize the query.

• The client types: Can I have a hot dog, I’m so hungry.
  ✅ The bot will take the order. The punctuation at the end of the keyword is accepted.

• The client says: Can I have a hot-dog?
  ❌ The bot won’t recognize these keywords. Two words with a punctuation mark in the middle are considered as one word.

When to use Keywords

• When you expect the user to say a specific word or a phrase.

• When you’re interested in one very specific word.