Use the UI SDK for Android

The UI SDK allows you to add Messaging for In-App into your iOS app with a ready-to-go user experience. Open a conversation with the UIClient class. You can customize the colors and strings so that the Messaging user interface looks natural in your app.

Most of the SDK classes are from these two packages:

Create a CoreConfiguration object using the config file that you previously downloaded from your org, or you can manually add the values from within this config file. Use this CoreConfiguration object to create a UIConfiguration object.

OPTION 1: Configure Using the Config File

Once you've added the config.json file to your project, you can reference it from the code.

To learn how to download the config file from your org, see Configure a Messaging for In-App Deployment in Salesforce Help. This file contains the Service API URL, the org ID, and the API name for the deployment. For example:

  "OrganizationId": "00ZZZ0000000Zzz",
  "DeveloperName": "MyMessagingForInAppDeployment",
  "Url": ""

OPTION 2: Configure Manually with Config Info

If you don't want to use the config.json file in your project, you can configure the SDK manually using the Service API URL, the org ID, and the API name for the deployment.

Create a UIClient object. Open a conversation to show the UI.

Without any additional code, the UI SDK automatically provides your customers with Messaging features such as pre-chat forms, bot support, file attachments, and estimated wait time. To learn how to configure these features in your org, visit our Messaging for In-App and Web learning map.

This step is only required if you want to implement push notifications.

Before you add code in your app for notifications, set up your Firebase project for notifications. Then follow Salesforce org setup instructions at Set Push Notifications for Messaging for In-App.

In your mobile app, make an additional call into the SDK when receiving the device token. To learn more, see Set Up Messaging Notifications for Android.

This step is optional.

The UI SDK automatically brands the app with a default color scheme, provides icons for all UI elements, and uses default text for all UI labels.

  • To customize the color scheme in your app, create a color resource file in your app using the SDK's token names. To learn more, see Customize Colors for Android.
  • To customize any UI text, create a strings.xml resource file in your app using the SDK's resource names. To learn more, see Customize Strings for Android.
  • To customize the icons and images used throughout the SDK, add a drawable asset to your project using the associated keyword. To learn more, see Customize Icons for Android.