Preferred Language of Messaging Users
The Enhanced In-App Chat SDK automatically sends the device’s preferred language to the org, which will allow localized Messaging Components to be sent back to the SDK. For this to work, the Identify preferred language of messaging users option on the Messaging Settings page in Setup must be selected. For more information about translating messaging components, see Translate Messaging Components into Your Customer’s Language.
This feature requires version 1.9.0 or later of the Messaging for In-App SDK.
This article applies to the following implementations:
| UI SDK | Core SDK |
|---|---|
| ✅ |
The SDK will automatically pass the language locale of the device to the agent on session creation. For clarification on the difference between a session and a conversation see the Message Glossary.
The list of Supported Languages on the org depends on the level of language support configured on the org. The list of supported languages on the Android platform is much larger. If a language and locale pair that are sent to the service is unrecognized, the translated messaging component won’t be shown in the desired language and you won’t be notified of the failure. The SDK provides a public API remoteLocaleMap on the CoreConfiguration object to allow the language locale to be mapped from the mobile device value to a supported Salesforce language locale.
We highly recommend that you use the remoteLocaleMap API; otherwise, the feature may not work.