Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »


WhatsApp does not allow the sending of free text messages after the 24h customer care window closes: WhatsApp for Business Customer Care Window. After the closure of this window, you will only be able to send Highly Structured Message (HSM) templates. This article explains how to configure the Social25 chat window to surface the correct languages for the item you are working on.

If no existing mappings are found, the chat window will return English US and English UK HSM templates by default. Follow below steps to configure which languages should be returned.

Language mappings

Social25 uses the Template Language Mapping object to store language mappings. You configure the chat window in such a way that it knows where to look for those languages.

The Template Language Mapping object

The Template Language Mapping object contains two fields that are used to map languages to countries or markets (or anything else defining which language should be available)

NameTypePurpose
Template Language Mapping NameText(80)Main identifier of a country or market. You can create a field (or use an existing field) on the object from which you are chatting and fill it with this value. The chat window will then only retrieve HSMs that have a translation in the related languages, defined through the next field, Language Code
Language CodePicklist (Multi-Select)Allows you to link multiple languages to a country or market (or anything else defining which language should be available)

Create a mapping

  1. From the App Launcher, go to Template Language Mappings
  2. Click New
  3. Fill in a Template Language Mapping Name. Remember that this should reflect the value in the field on the object from which you are chatting
  4. Select the available languages in the Language Code field
  5. Click Save

Example 

Assume you want to create a mapping for Belgium. According to Wikipedia, Belgium has three official languages: French, Dutch and German. Hence, you want to allow your agents to send HSM template messages in those languages when chatting with people from Belgium.

Let's now assume that your are chatting from a case, and that your Case object contains a formula field "Country". The data in field is fed from the related account and contains the value "BE" for your Belgian customers. A corresponding language mapping would look as follows:

Template Language Mapping NameBE
Language Code
  • French
  • Dutch
  • German

This example references an existing field. As you may not have such field in place, you can also create a custom Text field and fill it accordingly. This can be done manually, or via the many automated options Salesforce provides (Apex, Triggers, Flows, Process Workflows, etc..)

Configure chat window

Finally, you need to tell the chat window to which field it should look:

  1. Click the scroll wheel in the top right corner of the page on which the chat window is located
  2. Click Edit Page
  3. Click on the Social25Messenger Lightning Component
  4. You will see that the chat window attributes window contains a field called Language Mapping Field Name. Specify the field that contains the language information ("BE" in our previous example)
  5. Save the page
  6. Potentially Activate the page

When a chat now expires due to the WhatsApp for Business Customer Care Window closing, the chat window will return HSM templates for the related languages.

Related articles

On this page

  • No labels