How to Upload Bot Responses in Bulk

Updated on January 27th, 2023

+ More

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

Delete

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.