The Unbabel app uses an email service to send article content to the Unbabel translation pipeline and receive the translation content back. To trigger a translation, this email service is called when an article is assigned to the Unbabel queue. See below how to create it.

Creating an Email Service

If you already have an email service with which to use Unbabel, you can skip this section and move directly to creating the Unbabel queue. Otherwise, follow these steps:

1 - Click the AppLauncher.

2 - Type or find the Unbabel KB - Configuration menu.

3 - Under the Setup section, find and click on "If not created, click here", just above the Email Service field.

4 - In Email Services, click New Email Service.

5 - Fill in the Email Service information and pick up the settings according to the image and instructions below.

• Name: Unbabel Article Translate
• Apex Class: UnbabelTranslateEmailService
• Check the Active checkbox.
• For the section "Failure Response Settings": 
  • select every action as "Bounce message"
  • Enable Error Routing: true
• Route Error Emails to This Email Address: customer-products-salesforce@unbabel.com

Click Save.

6 - Under the freshly created Email Service page, click New Email Address. Give it a name (ex: unbabelRouting) and select your organization addresses like the ones the address accepts emails from (ex. Unbabel.com, gmail.com, etc).

7 - Click Save to complete.

Copy the email address generated. This will be used to create the Unbabel queue.

Creating the Unbabel queue

Once you have an Email Service configured with the Unbabel apex class, you can create a queue for translation requests to be assigned to.

1 - Head back to the Setup section in the Unbabel KB - Configuration menu.

2 - Copy and past the email service address in the field under the same section name.

3 - Click the Create Queue button.

4 - The page will re-render and you should see that the created Unbabel Queue was automatically assigned to human translations by default.

5 - Set the person in your Org that should be notified by the system for any alerts by filling their email in the Notification contact field. The contact gets notified when the translation size exceeds the article field size. In this case, the article will be populated with a message with this information and the contact is notified.

6 - Define the translation batch job; periodically, Unbabel will look for queued article translations to check for missing or failed translations and send them to the pipeline. These schedules match the following runs:

• System.schedule('Unbabel KB Job 1', '0 0 0/1 1/1 * ? *', new unbabelkb.UnbabelBatchServiceSch());
• System.schedule('Unbabel KB Job 2', '0 0 0 1/1 * ? *', new unbabelkb.UnbabelBatchServiceSch());
• System.schedule('Unbabel KB Job 3', '0 0 3 ? * SUN *', new unbabelkb.UnbabelBatchServiceSch());
   

7 - Check Delete failed draft articles to delete the drafts that were created by users that do not have Unbabel Connector permissions.

8 - Click save to complete the process.

Let's continue by configuring the Unbabel translation languages.