Using flows with Language IO API Managed Package

This document describes a potential use case for the Language IO API managed package: using a Salesforce flow to translate a case Subject to the current user language upon creation of the record.

The Language Detection and Translation methods are Invocable Methods. This means that you can use them in Automation processes such as Flows.

How it works

Creating a new flow

1. Open Salesforce. Go to Setup > Flows > New Flow.
2. Select "Record-Triggered flow" and click Create. The following screen opens:
   
   (Click to enlarge)
   1. Select "Case" as the base object
   2. Set the flow to run when a case is created.
   3. No entry conditions are necessary.
   4. Optimize the flow for "Actions and Related Records". This allows you to use invocable methods.
   5. Check the "Include a Run Asynchronously path..." setting. The flow uses an asynchronous path to do API callouts for language detection and translation through the Language IO API. This is because the detect and translate callouts are designed to run in real time in the managed package.

Detect Language

1. Create a text variable to store the detected language.
   
2. Add an apex action that calls the Detect Language invocable method from the Language IO managed package. The method is called "Detect Locale" (api name: LIO__DetectionAPI). The action will be added on the Run Asynchronously branch.
   
3. Click Done, then populate the required input and output parameters:
   
   1. namedCredential: the API name of the named credential used to make the callout to the Language IO server.
   2. routableID: unique ID specific to the current detection callout. This can be the case ID for example.
   3. sContent: the text for which you want to detect the language, in this example, the case subject.
   4. sDetectedLanguage: the detected language, saved in the variable created in step 1.

Perform Translation

1. Create a text variable to store the translated text.
   
2. Add an apex action that calls the Translate invocable method from the Language IO managed package. The method is called "Translate" (api name: LIO__TranslationAPI). The action will be added on the Run Asynchronously branch.
   
3. Click Done, then populate the required input and output parameters:
   
   1. namedCredential: the API name of the named credential used to make the callout to the Language IO server.
   2. routableID: unique ID specific to the current detection callout. This can be the case ID for example.
   3. sContent: the text that is translated. In this example, the case subject.
   4. sTargetLocale: the target language. In this example, the language of the current user.
   5. sSourceLocale: the language of the original text (source language) that was detected in the previous callout.
   6. sTranslation: the translation result.

Update case subject

1. Add an "Update Triggering Record" action to the flow, on the "Run Asynchronously" branch:
   
   (Click to enlarge)
   1. The current case record to update.
   2. Set the conditions so that the update only happens if a translation was performed.
   3. Update the case Subject with the translation that was saved in the variable defined in the "Perform Translation" step.