Storing the end user language in a related field with Language IO Chat

Overview

The purpose of this document is to describe the setup and usage of the "Language Field" and "Language Lookup" custom settings fields in Language IO Chat.

This feature is available in Language IO Chat from version 2.41 and later.

What is it?

The purpose of this feature is to set or update the locale, or store a detected locale, for an end user in a related "language" field. This makes it possible for agents to reference the locale of the end user in follow-up conversations, such as a Case or a new Chat with the same related record.

When a Chat session starts, if the "related language" field is empty, the system fills in the language upon detection. If there is already a language specified in the field, and this language is different from the language detected, a popup opens to ask whether to update the field with the new language. The same process happens if you activate the "language re-detect" function.

Similarly, if the lookup record that stores the related language is updated, the same verification happens: if the new record does not have a related language, the system fills in the detected language. If the new record already has a related language, and this language is different from the language detected, a popup opens to ask whether to update the field with the new language.

Custom Setting Configuration

You can choose any field (custom or standard) for this functionality, as long as it is a type that can store the language (text, picklist, text area, etc). The field must exist on a related object to the Chat Transcript standard object (see examples below).

There are two components to the field:

• "Language Lookup" represents the API name of the lookup field for the related object.
• "Language Field" represents the API name of the field that contains the language.

Available Objects

By default, the related language field can be found on any of these objects:

• Account, for which the lookup is "AccountId"
• Case, for which the lookup is "CaseId"
• Chat Button, for which the lookup is "LiveChatButtonId"
• Chat Visitor, for which the lookup is "LiveChatVisitorId"
• Contact, for which the lookup is "ContactId"
• User, for which the lookups are "CreatedById", "LastModifiedById" or "OwnerId"
• Chat Deployment, for which the lookup is "LiveChatDeploymentId"
• Lead, for which the lookup is "LeadId"
• Skill, for which the lookup is "SkillId"

In addition, any related custom object can hold the related language.

Setup Examples

Example 1

1. In the Object Manager, you open the Contact standard object. In Fields and Relationships, you set the "Language" field with the "Language__c" name from the API:
   
   (Click to enlarge)
2. In the Object Manager, you open the Chat Transcript standard object. In Fields and Relationships, you set a custom setting called "Contact Name" with the value "ContactId":
   
   (Click to enlarge)
3. In Setup > Custom Settings, open the Language IO Chat Public Settings. Make sure that the "Language Field" entry contains the "Language__c" value and the "Language Lookup" entry contains the "ContactId" value:
   

Example 2

1. In the Object Manager, you open the Case standard object. In Fields and Relationships, you set the "Language" field with the "Language__c" name from the API:
   
   (Click to enlarge)
2. In the Object Manager, you open the Chat Transcript standard object. In Fields and Relationships, you set a custom setting called "Case" with the value "CaseId":
   
   (Click to enlarge)
3. In Setup > Custom Settings, open the Language IO Chat Public Settings. Make sure that the "Language Field" entry contains the "Language__c" value and the "Language Lookup" entry contains the "CaseId" value: