Overview
Earlier, to add bot responses for a new language, we needed to go to each and every step and add the language specific bot response one at a time. This took a significant amount of time. But we have a solution now.
We are giving more power to bot builders via a predefined TSV file. This TSV file will be used to bulk add/edit bot responses across languages, and across all the nodes of the bot in a single go.
Accessing Upload Language Bot Responses
On your bot's graph screen, click the three dots aside the Publish button. You will see the Upload Language Bot Responses option as below.
A pop-up window will appear as below displaying further steps to be followed.
Download Bot Responses as TSV
Click on Download Bot Responses TSV button as shown above in step 1. This will send an email containing the download link of the TSV file to the configured email ID.
This TSV file will contain the bot responses of all the steps across the languages that have been enabled on this bot. For newly added languages that have been added to the bot where no bot responses have been added as of yet, the language column will be empty.
Upload Bot Responses from TSV
After downloading the TSV file containing the bot responses, update the bot responses in the downloaded TSV file. Once this is done, the TSV file is ready to be uploaded into the bot.
We will again click the Upload Language Bot Responses option to open the pop-up containing Upload Bot Responses TSV button as shown above in step 3. Click that button and choose the updated TSV file. Your bulk bot responses will now be saved to your bot.
TSV File Format
- Step ID: Unique step ID for the step
- Step Name: Unique name of the step
- Response ID: This ID corresponds to the responses stored in English and unique for every Bot Says Type.
- Bot Says Type: Type of bot say based on linked entities
- Property: Identification parameter for quick replies and other customizations
- Languages (English, Nepali, or any other language): Language of bot responses
Info
Do not add/remove any of the columns or edit the values in any other columns apart from the language responses. Also, do not add, remove or change the order of the rows.
Guide to Error Messages
While uploading your TSV file, you may see the following errors.
Actual Error Message |
Meaning of that Error Message |
|---|---|
The headers |
Mismatched Headers! It seems one or more headers of the uploaded TSV do not match with the originally downloaded TSV. |
Node name does not exist |
Could not find the Step with Name: "{{node_name}}" |
Response ID not exist |
Could not find the bot response mentioned on row number "{{row no}}" of the TSV for this specific Step in the "{{language_name}}" language. |
Response text is empty for {response_id}, {node_name}' |
The bot response has been left BLANK for the "{{language name}}" language on row number "{{row no}}" of the TSV. |
Property mismatch in {response_id}, {node_name}' |
The property "{{property}}" on row number "{{row no}}" of the TSV could not be found in the bot response properties of this step. |
While downloading, one may see the following errors.
Actual Error Message |
Meaning of that Error Message |
|---|---|
Message if no data in the sheet |
The CSV generation activity was canceled since there are no "Active Steps" in this bot. |
mismatch HSL properties’ error |
The entire step was skipped since the Bot-Response element(s) used for the "{{language}}" language are different from their corresponding "English" Bot-Response element(s). |
skip raw/json HSL |
A "Raw Text/JSON" bot response on this step has been ignored from the "{{language}}" Language bot responses. |
Global Entity |
The prompt bot responses of this "Global Entity" have been skipped since they are shared across multiple bots. |
Warning
This feature is still in Beta mode. For more information, contact your Haptik SPOC.