General information about the feature
The DataSet feature enables administrators and editors to upload list of entities to be used by the chatbot as options to select by the end user.
For live chat, those options can appear as buttons or drop-down according to the settings selected in the Picker Node.
For WhatsApp, those options will appear as a button or a list according to the number of options provided and if the WhatsApp Interactive Messaging feature is activated.
How does the feature work?
When available in your environment, the Data Set environment is available under Build > Actions > Data Set.
When there is no datasets created, the page will offer you the option to import a data set.
The Data Set to import should be a CSV with semicolon separator.
The CSV should be presented as such:
entity value
|
colors
|
Pink, Blue, Yellow, Green, Orange, Black, White
|
|
countries
|
Germany, France, Netherlands, Turkey, Belgium, Japan
|
|
dutch_cities
|
Amsterdam, Utrecht, Rotterdam, Breda
|
Rules:
Entity names can not start with system,
The separation between the entity column and the value column must be a ; {semicolon}
The value column contains the list of options, each option must be separated by a , {comma}
Value limit: Max 300 options per entity
Entities limit: Max 500 entities in one file (row)
Max CSV file size: 1 MB
When selecting the file, the file will be processed if it respects the rules mentioned above.
-
If one row does not comply with the rules, the entire file is not processed.
When the file is processed, the entities and the values are directly available in the table
You can review the importing flow here:
Full importing flow
The entities are imported how to use them in the dialog?
You can use it in the dialog with e.g Picker node
When using the DataSet Import, it is then easy to recognize in which dialog the entity is used thanks to the column Used in dialog on the page. If the entity is used, it will tag the name of the dialog it is linked to. From this, you can directly navigate to the appropriate dialog.
You can update the values in your file.
The Entity name can’t be updated - if you change the entity name in your file we will treat it as a new entity and the new entity will be added in Data Sets as a separate row.