Skip to main content

Data Source

Data Source
Data Source

Chatbot can deliver more than a static piece of information, it can display dynamic and real-time data from a specified database. Data Source is the place where you create such mini-database only for your chatbot.

FAQ Data Source

FAQ list in Data Source
FAQ list in Data Source

We recommend you to use Data Source to facilitate the making of a FAQ chatbot. You simply just need to store the database of your frequently-asked questions in Data Source and setup the connection to the specific Data Source in responses to have the questions and answers displayed properly. You may make live changes by importing the new .CSV at any time.

Format of FAQ in .CSV

You must follow a standard format to create your FAQ database, the .CSV should include the following column heads:

Example FAQ column heads
Example FAQ column heads
PropertyDescriptionRequired
LanguageTo indicate the language of this FAQ; "en" for English, "zh-hk" for Traditional Chinese and "zh-cn" for Simplified ChineseY
Question IDLabelling of the question; each question should be named with an unique question IDY
CategoryTo indicate the question category; only applicable to Web Chat platformN
Question DisplayedThe FAQ that to be displayed on the chatbot within the FAQ listY
Dialogflow IDDialogflow intent that this question should fall into; only applicable when you enable Dialogflow in IntegrationsN
Keyword Group 1The first keyword group that matches with the question displayed and triggers the corresponding answerY
Keyword Group 2The other keyword group if you want to add additional keyword group to specify the trigger conditionsN
Keyword Group 3The other keyword group if you want to add additional keyword group to specify the trigger conditionsN
TypeType of your answer; can specify as "Text", "Image", "Text_Image" and "Button"Y
TextString; only applicable when type is "Text", "Text_Image" or "Button"N
Image URLURL of the image file; only applicable when type is "Image" or "Text_Image"N
Button NameString; caption displayed on the button; only applicable when type is "Button"N
Button URLURL of the website that the button opens; only applicable when type is "Button"N
tip

We recommend including at most three keyword groups for each question. Too many keyword groups will cause difficulty for user to input a text that can fulfil all keyword conditions. You may just leave the field blank if it's not applicable to the question.


How to Create a Data Source?


Add New Data Source

  1. Click "+ New Data Source".
Add new data source
Add new data source
  1. A modal will pop up and you can fill in the data source details. Click "+ Create" to create a new data source.
Create data source
Create data source
  1. A new row for your newly created data source will be created. Click "Edit" and you will enter into a blank data source.

Import from .CSV

Instead of creating your data from zero at the Data Source, you may just want to import an external well-constructed data from your computer. We support importing of .CSV currently.

  1. Click "Import" to import your data.
New blank data source
New blank data source
  1. A new modal will pop up and you can click "Choose file" to select your .CSV file.
Import new data
Import new data
  1. Once selected your .CSV file, you can enable the following settings:
Import selected data
Import selected data
PropertyDescription
ActionTo indicate whether you are adding new entries to the data source by importing the file or you are replacing the whole file; toggle to "Append" if you want to add additional entries only; toggle to "replace" if you want to replace the whole data source
Parse JSONTo convert text inside the field into a computer-readable programming codes; must switch on for FAQ chatbot
  1. Then you should see a successfully imported data source.

Edit Document

  1. Click on any of the row and a modal that shows the details of that specific data entry will pop up.
Edit existing document
Edit existing document
  1. You can edit the existing document details by editing in the above advanced-mode modal.

Add New Document

  1. Click the "+ New Document" button and a blank advanced-mode modal will pop up. You may paste the content of your own document and save it.
Add new document
Add new document
tip

You can always click the rubbish bin icon to remove any data entry or data source.


Lock Data Source

To prevent the data source from being modified without notice, the Admin or App Owner can lock the datasource by using the Lock Data Source button.

Add new document
Add new document

You can no longer import or add new document to this data source until it is unlocked by the Admin or App Owner.

Add new document
Add new document