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.

null

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.

null

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.

null

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).

null

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).

null

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).

null

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).

null

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).

null

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).

null

Figure 9. Error Tooltips

 

7. Once you've done this, the TruCHAT Smart Support Bot will appear to help you out (see Figure 10).

null

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.

 

Table of Warnings And Errors
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!