FAQ

conversational bots are driving the new era of user interactions end users don’t want to feel as if they are talking to a machine they want to enter their queries in a free format and expect a response that provides apt information or resolution engati with its propriety nlp (natural language processing) engine makes it possible to train your bot to handle such queries engati has further made this quite simple with the construct of using faqs to train the bot in conversational intelligence frequently asked questions (faqs) are standard query response combinations that help train your bot to handle customer queries engati allows you to add any number of variations in each faq set thus helping make the training as broad as possible for instance, if you have a bot for a school, it would need to be trained to answer questions like what is the location of the school, what are the timings, and what is the fee these questions with all their variations and a response for each query or intent can be uploaded as faqs engati takes care of the difficult task of using that to then train the bot in handling these queries in a way that a common person may ask availability availability adding and uploading faqs is available for all plans except for whatsapp growth and rapid the ability to configure synonyms and stopwords is available business plan onwards terms and definitions terms and definitions terms definitions faq frequently asked questions (faqs) are the standard queries relevant to a product or a service intent intention/purpose of the user in the conversational flow entity it is a data point or value which you can extract from a conversation/user query this helps you to customize what kind of information you are collecting or how you want to associate it or want to add some custom value to it for more information on entities and intents synonyms these are different words that mean the same adding synonyms can improve faq responses since synonyms are assigned the same value when matching an faq for a valid response stopwords stop words are the words that are excluded in nlp while matching a given query for more information on synonyms and stopwords nlp natural language processing is the ability of a computer program to understand human language as it is spoken nlp is a component of artificial intelligence (ai) managing faqs managing faqs to access this functionality navigate to train > faq > +add faq there are two ways to add faqs to your bot one faq at a time this is relevant for a scenario where the number of faqs is limited or there are individual entries to be made from time to time multiple faqs in one go there is an upload faq option where a user can upload a file containing all the faqs this is relevant when the bot owner has a collection of faqs available adding faqs one by one adding faqs one by one step 1 click on add faq button on the faq page step 2 fill in the fields available for your convenience, we have provided descriptions for each field, indicating the values to enter in each category select the category the faq belongs to language select the language the faq is written in question enter the question the faq answers entities add the entities that are related to the faq prompt message this is triggered if the query is triggered without a valid entity response type this can be a message as shown in the above use case or you can trigger a path in this response a message will only provide static information while a path can lead to an interactive process answer when the response type is a message a user can add an answer for the query/question mentioned above this will be static information and will not change in the bot flow step 3 once you have filled in the details of your faq, click on "add faq" scenario lets consider a scenario for a better understanding query how can i enrol in the iot course? now there may be the same procedure for enrolling in a set of subjects let’s say database management, artificial intelligence, machine learning, data mining, and iot the procedure to enrol for each of them is the same instead of creating 5 faqs, you can create an entity of type course with the name of all the courses in it step 1 navigate to train > entities > +add entity and create an entity step 2 return to the faq page and incorporate the created entity into the entity section to employ this entity, select the word that will be substituted by one of the entities based on the end user's query initially, include the entity created in the entity section, then double click on the custom value provided in the question section a dropdown menu will appear, allowing you to select your entity this is how you can upload faqs one by one upload faq file upload faq file if your use case has a large number of faqs and multiple faq categories you can simply upload a formatted csv file there is a predefined format that engati supports for uploading an faq file you can navigate from train to faq, and click on the upload faq button, you will get a modal where you can upload a csv file you can download the sample file which details the format required https //s3 ap south 1 amazonaws com/branding resources/default/sample upload file csv instructions use the faq csv file upload mechanism to instantly train the chatbots with multiple faqs this is a structured document, the detailed usage instructions for which are provided below the responseid field is used to tag faq entries this is a system generated value which should not be altered the action field is used to indicate what operation you are performing on the faq set valid values are – insert, update or delete for faq entries where no changes are being made, the action field can be left blank the responseid should not be modified for adding new rows/entries, mark the action field as insert for these cases the responseid field would be blank here wherever any changes are being made to an existing faq set, mark the action field as update for these cases the responseid should not be modified if an existing faq set is to be deleted from the bot’s training, mark the action field as delete for these cases the responseid should not be modified use the category field to classify faqs and manage them better use the response field to enter the response of the chatbot and the subsequent columns for adding the query and query variations to denote against which user queries would the bot reply with the entered response for making changes to the faqs via csv upload, it is recommended to download the current copy of the file and update it with the changes it is also a good practice to eliminate data sync issues, especially when the faqs are altered from the ui as well faq upload api you can use engati’s faq upload api to insert , update , or delete faqs in bulk by uploading a formatted csv file here’s how the api is used curl location 'https //api engati com/bot api/v1 0/customer/90022/bot/4ae3d7044a96490f/faq/upload?locale=nl' \\ \ header 'authorization basic 4d6f685 68a 482b 93fd 21b6df17b1e g4guod' \\ \ form 'file=@"/users/john/downloads/api delete test api delete test csv"' notes replace the authorization token and file path with your actual engati token and csv file location the csv should follow engati's predefined format https //s3 ap south 1 amazonaws com/branding resources/default/sample upload file csv use insert in the action column to add new faqs, update to modify existing ones, and delete to remove faqs download faq queries download faq queries you can download all the faqs added by you on your bot in the same format as the above file navigate to train > faq and click on the " " button and select download all faq view upload history view upload history you can check from upload history the status of your upload this will show how many faqs are successfully uploaded on the bot navigate to train > faq and click on the " " button and select view upload history manage faq categories manage faq categories you can maintain faqs in different categories this would help you in segmenting the queries and as appropriate focus on looking for responses during a particular conversation flow/path in one or more specific categories navigate to train > faq and click on the " " button and select manage faq categories manage faq categories a simple example can be an organization that has multiple departments, let’s say finance, marketing, support, and operations you can segregate all your queries into these categories while using the support path you can limit the faqs to the support category that covers everything about faqs i trust that reading this documentation has provided a clearer understanding of how to make the most of the faq section on our platform if you face any issues or queries please reach out to us at mailto\ support\@engati com