Unbabel has launched a revamped experience for Knowledge Base translations. As of package versions 2.x, Unbabel introduced two new components for managing knowledge article translations directly from the article record page: Submit Translations and View Translations. The components use a logic that doesn't depend on a queued apex job running periodically to request translations, but rather interact with Unbabel's api directly, ensure that translation requests are immediate and simplifying the backend architecture of the integration.
If you want to move from using legacy queue-based translation to the new components, the move is very simple. If your integration is running, most of the necessary configurations are already set up, and the required changes are minimal.
To make the change, follow the guide below.
Upgrade the package to version 2.10 (or newer)
Ensure you have the latest Unbabel packages up-to-date:
- Unbabel Connector v3.108
- [Your Salesforce Org URL]/packaging/installPackage.apexp?p0=04td10000004t4LAAQ
- Unbabel for Salesforce Knowledge Base v2.10
- [Your Salesforce Org URL]/packaging/installPackage.apexp?p0=04tWV0000006dDB
The new components and logic are part of the updated KB package, so it's a pre-requisite that the package is updated to follow the next steps.
Add the Translations Component (Unbabel Translation)
The Unbabel Translation component will be created by creating a Ligthning Action that uses a custom component added to your org with the Unbabel package.
1 - Go to Setup - Object Manager.
2 - Select the relevant Knowledge article object.
3 - Click Buttons, Links, and Actions.
4 - Click New Action.
Fill in the following fields:
- Action Type: Lightning Component
- Lightning Component: unbabelkbl:ExposeSubmitTranslationsCmp
- Height: 400px
- Label: Unbabel Translation
- Name: Unbabel_Translation
5 - Click Save.
6 - Click Page Layouts in the side panel and select the relevant page layout.
7 - Click Mobile & Lightning Actions.
8 - Drag the new Action to the section “Salesforce Mobile and Lightning Experience Actions”.
9 - To edit this section, you may first need to hover over it and click the wrench icon on the right.
10 - Click Save.
11 - Ensure the action is also selected in the Lightning Record Page.
Add the View Translations Component
1 - Go to a Knowledge article record page.
2 - Open the Setup Menu and click Edit Page.
3 - Drag the custom component viewTranslationsComponent into the desired place.
4 - Click Save.