1. Language IO
  2. Salesforce Support
  3. Salesforce Case - Admin Guide

Articles in this section

See more

Using Templates in Language IO Case for Salesforce

Salesforce allows for the use of email templates. Email templates can be useful to respond quicker and have several models of answers ready to use based on the most common user queries, for example.

The purpose of this article is to show you how to use templates with your Language IO Case integration, to translate your responses or add content to pre-translated templates.

Using Language IO to store your templates

You can request to store email templates with Language IO. In this scenario, you only store the primary language template within Salesforce, and the translations are stored in the Language IO database.

The primary advantage of this setup is that it offers a mix of human and machine translation: human translation for the body of the template, and machine translation for the ad-hoc text that you add, delimited by brackets in the template.

Creating a template

A template is typically formatted like this:

“Hello, 
Thank you for contacting support. We have identified the following solution for your problem:
[placeholder]
Best regards,” 

As shown, use square brackets '[]' as a placeholder to mark the areas of the template that the agent can edit. This is where they would insert the relevant response to this particular user, for example how to renew a password, or office hours for a business, etc.

Note: Language IO supports Salesforce Classic email templates, Lightning email templates without letterhead, and Lightning email templates with letterhead.

Submit a support request:

  • to provide Language IO with your translated templates to store them with Language IO;
  • if you only have templates in the source language and need to have them translated.

Inserting a template in an email

  1. To insert a template, simply use the native button in the Salesforce email screen to select the desired template:
    Screenshot_2023-03-14_at_11.30.56.png
  2. Complete the answer as required. Edit only the part between brackets (highlighted below). Your email draft is saved automatically. 
    Screenshot_2023-03-14_at_12.14.17.png
  3. Click the "Translate" button in the Language IO section to the right:
    Screenshot_2023-03-14_at_11.47.25.png
  4. You can now see the translation of your email in the body, ready to send (You may remove the brackets and auto-responder text):
    Screenshot_2023-03-14_at_12.16.01.png
  5. To see your original text, as well as other translations for this case, click the Language IO tab at the top:
    Screenshot_2023-03-14_at_11.52.12.png
Important: You can only use the pre-bracketed area of the template to add text. If you modify, add or delete parts of a template other than the pre-bracketed area, they may no longer match the templates stored in the Language IO database. This may cause translation discrepancies or errors. 

Formatting templates (advanced)

When you create templates, to identify content that should be translated, content that should be passed through as is to the target template, and the template ID to identify the localized sibling templates, follow these best practices:

  • Surround the variables (called merge fields in Salesforce) that you want passed into the target template with <span class="liomaintain"></span>.

    Important: Merge fields in the source template must match the merge fields in the target template. If the fields are empty, or if they are deleted from the source template, the translations will fail.
  • Markup areas where agents enter custom content that is to be translated [TranslateStart][TranslateEnd]. (These markers are removed automatically from the translation results.)

Language IO Support will create and insert the template ID after mapping the sibling templates in the database: <span style="display:none">|~|Unique Id Here|~|</span>.

Example

Below is an template example that demonstrates these three pieces:

Hi <span class="liomaintain">{!Contact.FirstName}</span>,<br>
[TranslateStart][TranslateEnd]<br>
<br>
Your subscription is now cancelled. We're sorry to see you go.<br>
<br>
We won't take any further payment from you, although you can still enjoy watching until <span class="liomaintain">{!Contact.LastModifiedDate}</span>.<br>
<br>
If you change your mind and would like to continue watching TV with our services, simply go to My Account before <span class="liomaintain">{!Contact.LastModifiedDate}</span> to reactivate your subscription.<br>
<br>
<GO TO MY ACCOUNT> CTA<br>
<span style="display:none">|~|ACMEINC-EN_US|~|</span>

Note about word counts

When you translate a template, the system processes every word in the template for translation, including the pre-translated content. This means that the word count that you see in your reports will match the entire template, and not only the dynamically translated text. 

Language IO tracks which words match a pre-translated template, and which are marked for machine translation processing (this is the portion of the template that the agent edited). Language IO’s translation service processes the entire length of the template, identifies which sections are dynamically translated, and recreates the template with both human and machine translated content merged for final delivery. These processing steps blend the benefits of machine and human translation to create a high quality translation output.

This is why it is important that you do not modify the parts of the template that are not pre-bracketed for agent input, as doing so would no longer match stored translations. 

Related articles