Customer Gadget Translation

Add a New Language

1. Use a translation file placed on chat-solution/docker/translations/customer-gadget, rename it with the locale symbol in case you want to add a new language (e.g. it.json)

2. The filename should not contain any special character. 

3. Open the file and change the translation as required. (See details in the sections below).

4. The translations folder must exist in the same folder where docker-compose.yml file is placed.

5. Add a new language key: value pair against environment variable LANGUAGES in customer-gadget-variables.env. See Web-chat -> Supported Languages for details.

6. In the volumes section, make sure to have the following line to mount the languages folder of the docker container on the host machine, where translation files are kept. After mounting the volume, you'll need to restart the container for the changes to take effect.

${PWD}/translations/customer-gadget: /usr/src/app/languages

Customize Title Texts 

In the language file, change the Title and SubTitle texts on the Customer Gadget using the variables title, subTitleText. 

Change Inactivity Timeout Message

Change the value of the variable inactivityMessage to customize the customer timeout message. See feature details in Web-chat -> Inactivity Timeout.

Change Agent Unavailability Message

If all of the agents are either logged out or in Not Ready state, the customer would see a message such as, "No Agents are available". Change the value of the variable noAgentAvailable to customize the message. The chat session won't be ended automatically. The customer can choose to close the chat or continue to wait.

Change Agent Availability Timeout Message

If all of the agents are busy and the chat requests wait in the queue until AGENT_AVAILABILITY_TIMEOUT, the customer would see a message such as, "All of the agents are busy" and the chat session will be closed automatically. Change the value of variable agentNotAvailable to customize this message. See feature details in Web-chat -> Agent Availability Timeout.

Change Queue Position Message

Change the value of the variable queuePosition to display the message to be displayed while showing the customer queue position. See feature details in Web-chat -> Estimated Wait Time.

Change EWT Message

Change the value of the variable ewt to display the message to be shown while showing EWT to the customer. See feature details in Web-chat -> Estimated Wait Time.

Change HandOff Message

The system displays this message while finding an agent for the customer chat request. Change the value of the variable handoffMessage to customize this message. 

Change Non-Working Hours Message

Change the value of the variable outOfWorkingHours. See feature details in Web-chat -> Business Hours Integration.

Change Confirmation Message

While ending the chat, the system asks for a confirmation before closing the customer chat session. Change the value of the variable confirmation_message to customize this message.

Change Thanks Message

The system displays this message when the chat is successfully closed. Change the values of the following variables:

Download Chat Transcript 

Change the value of the variable chatTranscript to change the Chat Transcript translation option. See feature details in Web-chat ->Chat Transcript.

Change Message Composer Text

Change the Message Composer window placeholder text by changing the value of the variable typeMessagePlaceholder in the language file. 

Change Callback Translation 

Change the translations of the Callback variables under the callback block.