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.

Facebook / WhatsApp charges its customers, i.e. your organisation, for every template message sent. Make sure you are aware of this by reading the following two articles:

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.

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.

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)

Name	Type	Purpose
Template Language Mapping Name	Text(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 Code	Picklist (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

From the App Launcher, go to Template Language Mappings
Click New
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
Select the available languages in the Language Code field
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 Name	BE
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:

Click the scroll wheel in the top right corner of the page on which the chat window is located
Click Edit Page
Click on the Social25Messenger Lightning Component
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)
Save the page
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.

Supported HSM template components and parameters

Header: Optional header that has a text or media format. The media parameter can be an image, video or pdf. If the header has text format, we support text parameters.
Body: Body text with text parameters .
Footer: Footer text with text parameters
Buttons: We support both Call To Action and Quick Reply buttons that let your customers quickly respond to your message or take an action:

Call to Action: We support text parameters that contain valid url characters and can be added to the end of the url of a Call to Action button. This creates a personalized link for the customer.

Using HSM templates

Once a chat has expired, the chat window will display relevant HSM template messages. Agents can select a template, and if required fill in the parameters. Agents will only be able to send the template after the parameters have been filled in.

Select Language if needed from the language picker:

Search / filter template list for given language or clear search:

Select message template to preview and press “Next” to edit the template’s parameters:

Fill in the necessary fields and upload the appropriate file type if needed:

Send the template message after you finished editing: