Managing Intents

What is an Intent?
Dialogflow's definition of Intent
An intent categorizes an end-user's intention for one conversation turn. For each agent, you define many intents, where your combined intents can handle a complete conversation. When an end-user writes or says something, referred to as an end-user expression, Dialogflow matches the end-user expression to the best intent in your agent. Matching an intent is also known as intent classification.
A basic intent contains the following :
Training phrases - These are example phrases for what end-users might say. When an end-user expression resembles one of these phrases, Dialogflow matches the intent.
Action - You can define an action for each intent. When an intent is matched, Dialogflow provides the action to your system, and you can use the action to trigger certain actions defined in your system.
Parameters - When an intent is matched at runtime, Dialogflow provides the extracted values from the end-user expression as parameters. Each parameter has a type, called the entity type, which dictates exactly how the data is extracted.
Responses - You define text, speech, or visual responses to return to the end-user. These may provide the end-user with answers, ask the end-user for more information, or terminate the conversation.
A more complex intent may also contain the following:
Contexts: Dialogflow contexts are similar to natural language context. If a person says to you "they are orange", you need context in order to understand what the person is referring to. Similarly, for Dialogflow to handle an end-user expression like that, it needs to be provided with context in order to correctly match an intent.
Events: With events, you can invoke an intent-based on something that has happened, instead of what an end-user communicates.
The intents can be triggered based on your contacts' Country and Language. If your contact has a country or language value present in their contact details, the intents can be triggered based on the different values of country and language. 
Viewing Intents
Step 1: Login to Dialogflow
Navigate to the Dialogflow console and login with your user credentials. 
Step 2: Navigate to Intents
Select the agent you would like to configure and select Intents from the side navigation menu
All the default intents and created intents will be listed in this view.
Default Intents
When you create an agent, two default intents will be created for you by Dialogflow
Default Welcome Intent: This intent is matched when the contact begins a conversation with the platform. This intent should return a response that lets the end-user know what your agent does or what they can say to begin a conversation.
Default Fallback Intent: This intent is matched when the agent cannot match the end-user expression to any other intent.
Default Welcome Intent
Learn more on Dialogflow's definition of Default Welcome Intent!
As you can see, the Default Welcome Intent has a pre-requisite of Welcome event and greetings phrases. When a contact messages you for the first time, this intent will be matched according to what was specified. 
Refer to the following example :
Suggestion: We would like to suggest to include responses that inform the contact that they are interacting with a chatbot. By doing so, contacts' expectation towards resolution can be managed well. 
Default Fallback Intent
Learn more on Dialogflow's definition of Default Fallback Intent!
When the incoming message or event does not match any of the existing intents, a fallback intent will be matched instead. 
Refer to the following example :
Suggestion: When the Agent could not respond in return, the agent should offer to handoff to a live agent to help with the contact's issue. 
Creating an intent
You can create new intents if you would like to create automated processes for specific use cases. With Parameters and Events, intents can be created to suit multiple use cases. 
In order to help you better understand, the following guide will be based on a specific use case as described below:
Company XYZ often receive queries on order status from the website's webchat. As they were going through the conversations, they detected a common pattern where their agents will ask for the customer's customer ID to further check the issue or resolve the enquiry. Once they obtained the customer ID from the customer, they will update the custom field and add it as a tag. 
Based on the scenario above, the process of obtaining the customer ID can be done by the chatbot. Once the customer ID is obtained, the contact will be handoff to a human agent for further assistance. 
Let's break it down to simpler steps:
1.
Create an intent to prompt for customer ID
2.
Create an intent to obtain the customer ID
3.
Saving the customer ID as a custom field on respond.io
4.
Adding a tag
5.
Handing off the conversation to a human agent
6.
Notifying the human agent
7.
Disabling the bot
Expected Outcome
Creating a basic intent
Step 1: Create Intent
Navigate to the Dialogflow console and press Intents from the side navigation menu. Press the ➕
or CREATE INTENT from the top of the module. 
Step 2: Name your Intent
Enter a name for your intent. Your intent name should represent the end-user expressions it recognizes.
For this scenario, we'll name is order_status_enquiry

Step 3: Include Training Phrases
Based on the scenario above, we should include training phrases that asked for order status specifically. Start by typing in the placeholders in Training Phrases section. You can include multiple phrases to cater for different type of phrases. 
For example,
where is my order
could you help me check my order please
what is the status of my order
Step 4: Build Intent Response
For this intent, the response should prompt contact for their customer ID to be used for the following intent. 
Scroll down to the Responses section and type in the response. You can either add a Text Response or Custom Payload. For this scenario, Text Response will serve the purpose. 
Tips: 
You can send multiple responses at one time for better readability.
You may add a few variants of response and it will be randomised when sending it to a contact. 
The response we will build for this intent is :
I apologize in advance if your order is taking too long.
Can I have your customer ID please?
To learn about response templates, click here!
Creating an entity
Before we can save the value as custom field, we will need to create an entity to detect the value from incoming messages. 
Based on the scenario above, we will name this entity as customerId and it will be used to store the customer id for a customer. 
Step 1: Create an Entity
Navigate to the Entities module. Press on the ➕
 or CREATE ENTITY.
Step 2: Name the Entity
For this example, we will name it customer_id. 
Step 3: Enter the possible values
The entity should accept a string with 5 integers in length. Regular expression will be applied to validate the value. 
For this example, the value will be (\d){5} that accepts any string with 5 digits. 
To learn about regular expression, click here!
Read here for more information on entities!
Creating an intent with parameters
Step 1: Create Follow Up Intent
Navigate to the Dialogflow console and press Intents from the side navigation menu. Locate the previous intent created and press Add follow-up intent.
A follow-up intent is used instead because this intent will need to be triggered after the specified intent. 
By default, the context and action will be populated by default so that the intent will work in sequence.  

Step 2: Include Training Phrases
The phrases to include in this intent will most likely be phrases that contains the customer ID. We can input a phrase and highlight the text that is likely to be the customer ID. Select the entity created earlier and annotate the text with it. 
By default, a parameter will be created when you annotate a text with an entity so store the values.
Read here for more information on annotating training phrases!
Step 3: Build Intent Response
For this intent, the response should inform the contact that the customer ID has been received and a human agent will take over the conversation and resolve the issue. 
Scroll down to the Responses section and type in the response. Add a Text Response. 
The response we will build for this intent is :
Thanks for providing your customer ID. Your issue is being assigned to our human agents.
Saving value as custom field
When the contact responds with their customer ID, the value can be saved as a custom field in respond.io platform.
In order to save the value to a custom field, please ensure the custom field is created at respond.io platform.
To save the value, add a parameter RB_FIELD_{custom field's name}. In this case, the parameter will be RB_FIELD_customerid and set the entity $customer_id as the value.
Adding a tag 
Add a parameter RB_ADDTAGS and set the entity $customer_id as the value
Handing off the conversation
Now, we want to hand off the conversation to a human agent. This can be achieved with another parameter, RB_USER_ASSIGN and set the user's email as the value
Disabling the bot
The parameters will be executed in sequence. Lastly, we will disable the bot response for this contact because we do not want any intent to be triggered when the contact is handled by a human agent. 
To do so, we will add another parameter, RB_BOTSTATUS and set FALSE as value.
When a bot is disabled, contacts can no longer receive messages from the bot until the bot status is enabled. The bot status can be enabled manually through the messaging console or via automation.
Location Handling
When a location is received from a contact, an event of type  LOCATION will be sent to Dialogflow. You may add LOCATION to the events to trigger the respective triggers.
Check out the other parameters available to use in Dialogflow :
Parameters
Testing an intent
If you need to test the intent, use the Testing panel located at the right side of Dialogflow console. 
Deleting an intent
From the intent list, hover to the intent you wish to delete. Press the trash icon of the intent. 
Troubleshoot
Away Message Settings
If the chatbot is not working as expected, please check the Away Message Settings in your Space settings and make sure you have it switched off. Enabling the Away Message Settings will not allow for bot responses. 
Having trouble with Dialogflow? Contact us here!
​