Introduction
TruCHAT validation is a useful means for chatbot builders that helps them detect weak spots in the chatbots and fix them. For those who are new to chatbot building, it might be useful to check out the following articles: How To Create A Chatbot From A TruCHAT Template, Creating Your First Script On The TruCHAT Platform.
This article describes the following concepts:
TruCHAT Validation Tools
There are two types of validation tools in TruCHAT: warnings and errors. They may appear after clicking either Preview or Publish button indicating that the validation process went wrong (see Figure 1). Warnings and errors have different functions and are displayed differently in the UI.
Figure 1. The Chatbot Preparing Stopped Pop-Up
Warnings
Warnings are labeled with an exclamation mark in a yellow triangle and listed in a separate tab in the Chatbots section (see Figure 2). They inform you about your actions that have an unexpected result or might be destructive, but are not crucial for the chatbot functioning. They do not need to be fixed before the chatbot is published.
Figure 2. The Warning List
Errors
Errors are labeled with an exclamation mark in a red circle and listed in a separate tab in the Chatbots section (see Figure 3). They usually appear when a critical mistake prevents your chatbot from working correctly. These must be fixed prior to chatbot publishing.
Figure 3. The Error List
How To Fix Mistakes
1. If you want to find out what mistakes there are in your chatbot (or to make sure that it's flawless), click on either Preview or Publish button in the Chatbots section (see Figure 4).
Figure 4. The Preview And Publish Buttons
2. Whenever you preview or publish a new version of your chatbot, the validation process takes place (see Figure 5).
Figure 5. The Validation Pop-Up
3. If something goes wrong during this process, the Chatbot Preparing Stopped pop-up appears on the screen. It says that some errors and warnings were found during the preparing process and invites you to go to the error list (see Figure 6).
Figure 6. The Go To Error List Button
4. If you closed this pop-up beforehand, you can click either the error tab or the warning tab in the Chatbots section (see Figure 7).
Figure 7. The Error And Warning Tabs
5. You will see the list of all the errors or warnings found. To fix an error, click on its name (see Figure 8).
Figure 8. The Error List
6. This will immediately take you right to the place on the diagram or in the script where the error occurred. To see the error details, click on the question mark near its name (see Figure 9).
Figure 9. Error Tooltips
7. Once you've done this, the TruCHAT Smart Support Bot will appear to help you out (see Figure 10).
Figure 10. TruCHAT Smart Support Bot
8. Fix the error according to the Smart Support Bot's instructions and repeat these steps for the remaining errors.
Table Of Warnings And Errors
The table below contains all the warnings and errors that you may face during your chatbot building. They are collected in one place for your convenience. Please refer to this table whenever you need.
| Type | Title | Description |
|---|---|---|
| Error | Intent Name Length Exceeds The Limit | The length of the intent name cannot exceed 50 characters. Please edit the intent name. |
| Error | Intent Name Is Not Unique | The name of each intent must be unique. Please change the intent name. To learn more about setting up intents, refer to the article How To Work With Intents In TruCHAT. |
| Error | Script Is Deleted Or Does Not Exist | The selected script has been deleted or does not exist. Please select another script. |
| Error | Not Enough Utterances | There must be at least 5 utterances in the intent. Please add more utterances. To learn more about setting up intents, refer to the article How To Work With Intents In TruCHAT. |
| Error | Utterance Length Exceeds The Limit | The length of the utterance cannot exceed 500 characters. Please edit the utterance. |
| Error | Utterance Is Empty | The utterance field must not be empty. Please add the text of the utterance. To learn more about setting up intents, refer to the article How To Work With Intents In TruCHAT. |
| Error | Utterance Is Not Unique | Utterances must be unique. Please change the text of the duplicate utterances. To learn more about setting up intents, refer to the article How To Work With Intents In TruCHAT. |
| Error | Intent Destination Is Not Configured | Please specify the destination for the intent using the "GO TO" dropdown. To learn more about setting up intents, refer to the article How To Work With Intents In TruCHAT. |
| Error | LUIS Training Failed | LUIS training failed. Please try again later. |
| Error | LUIS Training Failed | LUIS training failed. The number or the quality of intents/utterances is not enough for training. |
| Error | Custom Field Is Broken | The variable used in the field has been deleted or deactivated. Please select another variable, or activate it if it is disabled. |
| Error | Topic Name Is Empty | The topic name field must not be empty. Please add the topic name. To learn more about setting up topics, refer to the article How To Work With Topics On The TruCHAT Platform. |
| Error | Topic Name Is Not Unique | Topic names must be unique. Please change the text of the duplicate topic names. To learn more about setting up topics, refer to the article How To Work With Topics On The TruCHAT Platform. |
| Error | Topic Name Length Exceeds The Limit | The length of the topic name cannot exceed 50 characters. Please edit the topic name. To learn more about setting up topics, refer to the article How To Work With Topics On The TruCHAT Platform. |
| Error | Number Of Keywords Exceeds The Limit | The number of keywords for a topic cannot exceed 5000. Please remove the extra keywords. To learn more about setting up topics, refer to the article How To Work With Topics On The TruCHAT Platform. |
| Error | Keywords Are Missing | There are no keywords for the topic. Please add at least one keyword. To learn more about setting up topics, refer to the article How To Work With Topics On The TruCHAT Platform. |
| Error | Script Is Deleted Or Does Not Exist | The selected script has been deleted or does not exist. Please select another script. |
| Error | Step Is Deleted Or Does Not Exist | The selected step has been deleted or does not exist. Please select another step. |
| Error | Step Is Not Configured | Step is not configured. Please configure settings for this step. |
| Error | Integration Is Not Configured | You have not configured the integration for this item. Please go to the Integrations section using the link and configure them. To learn more about setting up integrations, refer to the article How To Configure The Verification Step In TruCHAT. |
| Error | File Is Not Configured | File is not configured. Please configure settings for this file. |
| Error | Action Is Not Configured | Action is not configured. Please configure settings for this action. |
| Error | Orphan Step | This step is not connected to other steps. Please set up transitions to other steps. |
| Error | Invalid URL | Incorrect URL was entered. Please check its correctness and enter it again. |
| Error | Custom Field Is Broken | The variable used in the field has been deleted or deactivated. Please select another variable, or activate it if it is disabled. |
| Error | Comment Is Empty | Comment is empty. Please enter the comment or delete this element. |
| Error | Wrong Connection | This element can only be applied to triggers that are linked to web connections. Please change the connection type or select another element. |
| Error | Quick Reply Is Not Unique | Quick replies must be unique. Please change the text of the duplicate quick replies. |
| Error | Script Is Deleted Or Does Not Exist | The selected script has been deleted or does not exist. Please select another script. |
| Error | Script Is Empty | You have not added any steps to the script, so it will not work. Please add at least one step. To learn more about adding steps to the script, refer to the article Creating Your First Script On The TruCHAT Platform. |
| Error | Script Is Disabled | The script is disabled. Please enable it. |
| Error | Condition Is Empty | Condition is empty. Please configure the condition or delete this element. |
| Error | Connection Is Empty | Connection is empty. Please configure the connection. |
| Error | Connection Is Broken | The selected connection has been deleted or does not exist. Please select another connection. |
| Error | Connection Is Disabled | The connection is disabled. Please enable it or select another connection. |
| Error | Trigger Is Not Configured | The trigger is not fully configured. Please configure it. |
| Error | No Active Triggers | There are no active triggers. Please add a new trigger or enable an existing one. To learn more about setting up triggers, refer to the article How To Set Up Chatbot Triggers In TruCHAT. |
| Error | Number Of Topics Exceeds The Limit | The number of topics cannot exceed 10. Please remove the extra topics. |
| Error | Number Of Utterances Exceeds The Limit | The number of utterances cannot exceed 15000. Please remove the extra utterances. |
| Error | Number Of Intents Exceeds The Limit | The number of intents cannot exceed 500. Please remove the extra intents. |
| Error | Element Before The User Input Is Missing | Please insert any other element before the User Input, otherwise the current step won't work. |
| Warning | Comment Is Empty | Comment is empty. Please enter the comment or delete this element. |
| Warning | Authorization Data Is Not Configured | Authorization data is not configured. Please select the authorization type and fill out the corresponding fields. |
| Warning | Quick Replies Are Not Configured | There are no buttons in the User Input element. Please add at least one button. |
| Warning | Step Is Not Configured | Step is not configured. Please go to the step settings and configure it. |
| Warning | Quick Reply Is Not Unique | Quick replies must be unique. Please change the text of the duplicate quick replies. |
| Warning | Text Element Is Empty | Text element in the Content step is empty. Please add text or delete this element. |
| Warning | Step Is Not Configured | Step is not configured. Please go to the step settings and configure it. |
| Warning | Wrong Connection | Dropdowns and multiple choices can be displayed in the User Input element for web connections only. |
| Warning | Randomizer Is Not Configured | The Randomizer step is not connected to other steps. Please set up transitions to other steps. |
| Warning | Switch Is Not Configured | The Switch step is not connected to other steps. Please set up transitions to other steps. |
| Warning | Integration For Email Is Not Configured | You have not configured the integration for email. Please go to the Integrations section using the link and configure them. To learn more about setting up integrations, refer to the article How To Configure The Verification Step In TruCHAT. |
| Warning | Integration For SMS Is Not Configured | You have not configured the integration for SMS. Please go to the Integrations section using the link and configure them. To learn more about setting up integrations, refer to the article How To Configure The Verification Step In TruCHAT. |
| Warning | No Active Triggers | There are no active triggers. Please add a new trigger or enable an existing one. To learn more about setting up triggers, refer to the article How To Set Up Chatbot Triggers In TruCHAT. |
| Warning | No Active Triggers | There are no active triggers. Please add a new trigger or enable an existing one. To learn more about setting up triggers, refer to the article How To Set Up Chatbot Triggers In TruCHAT. |
| Warning | Intent Destination Is Not Configured | Please specify the destination for the intent using the "GO TO" dropdown. To learn more about setting up intents, refer to the article How To Work With Intents In TruCHAT. |
Conclusion
So we learned about the two types of validation tools in TruCHAT, including the algorithm of fixing mistakes using those tools, and even compiled a full table of the TruCHAT warnings and errors. If you want to dive deeper, please read the articles listed in the table above. From now on, you'll be a more confident chatbot builder who may be challenged by their mistakes but never discouraged!
Leave a comment