Add Intents and Utterances

If you take a look at How are you today?, Hello!, Hey, fella! and Hi!, you will notice that all of them are variants on the same theme, namely "greeting." In the terminology of chatbots, the variants are utterances and the theme an intent.

The second step in setting up a chatbot is to list user intents and utterances. Although a minimally functional bot can work with only four intents (greeting, goodbye, a use case, and exception handlingClosedIt means managing an unforeseen scenario. Such as when a user starts being aggressive or cracks a joke or ask a question not related to your organization's business.), it's recommended to keep their number commensurate with your organization's use cases. If the chatbot is going to answer to 50 kinds of queries, then the recommended number of intents is 50 + 3; the latter for greeting and bidding farewell. There are three ways to add intents: 

  1. Add intents one at a time
  2. Import intents
  3. Accept SearchUnify-suggested intents

Utterances are the words, phrases, and sentences customers employ to express intents. The more utterances are there in an intent, the higher are its chances of being recognized by your chatbot. The chatbot needs at least five utterances for each intent to function, but it's recommended to add way more than that, which can be done in one of the three ways:

  1. Add utterances one at a time
  2. Import utterances
  3. Accept SearchUnify-suggested utterances

Get to the Intents Screen

  1. From the main navigation, go to Virtual Agent.

  2. Click to view chatbot settings.

You will be on the Intents screen.

Add Intents

There are three ways to add intents.

Method 1: One Intent at a Time

Upon clicking Create New Intent, a dialog appears. Enter a label in the Intent Name field, a summary of what it is about in Description (60 characters), and click either Save or Save and New depending on what you intend to do next.

Method 2: Add Intents in Bulk

Click Import Intent and select the file where the intents are stored. Only CSV files are accepted. For the format in your CSV file, check Download Sample.

Method 3: Accept SearchUnify-Suggested Intents

  1. Click Intent Suggestions.

  2. Click Move Intent.

  3. A dialog will open, click Confirm.

Add an Utterance

There are three ways to add an utterance.


Add as many utterances as possible.

If you want to capture the intent "HOW TO ADD A CONTENT SOURCE?", you can add the following utterances: (1) add content source, (2) configure content source, (3) content source configuration , (4) content source addition , (5) how to add a content source, and (6) how to configure a content source. You will notice that a few keywords repeat in these utterances, such as add, configure, and content source.

The repeating keywords train your chatbot, enabling it to capture an intent from a large number of utterances with the correct keyword.

Method 1. One Utterance at a Time

  1. Click on an intent.

  2. Write an utterance in the search box and press Enter.


You can insert entities in your utterances. The entities can be admin-defined (custom) or fetched from the system you're using. Here's what an intent with custom entities looks like.

Method 2. Add Utterances in Bulk

Click Import and select the file where the utterances are stored. Only CSV files are accepted. For the format in your CSV file, click .

Method 3. Accept SearchUnify-Suggested Intents

When you accept SearchUnify-suggested intent, all the utterances contained thereof are also added. For details, consult Method 3: Accept SearchUnify-Suggested Intents.

Previous step: Connect the Chatbot to a Search Client

Next step: Create Entities for Use in Intents and Responses

Last updatedFriday, September 4, 2020