Install the Service SDK for Android

Install the Service SDK for Android using Gradle.

Before running through these steps, be sure you’ve checked the Requirements for the Service Chat SDK for Android.

The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to Messaging for In-App and Web before that date. Messaging offers many of the chat features that you love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in Help.

Important

To get started with the Service SDK for Android:

  1. Install the SDK using Gradle.

    The Service SDK is hosted in a maven repository.

    Feature Dependency Name Maven Repository URL
    All Features

    com.salesforce.service:servicesdk:224.2.6

    https://s3.amazonaws.com/salesforcesos.com/android/maven/release
    Chat

    com.salesforce.service:chat-ui:4.3.6

    (if you're only using Chat Core, then use com.salesforce.service:chat-core:4.3.6)

    https://s3.amazonaws.com/salesforcesos.com/android/maven/release

    To install all the Service SDK features, add the following maven repositories to your project's build.gradle file.

    allprojects {
      repositories {
        google()
        mavenCentral()
        maven {
          url 'https://s3.amazonaws.com/salesforcesos.com/android/maven/release'
        }
      }
    }

    Be sure to put the repositories list in the allprojects section.

    Note

    And add the following dependency to your module's build.gradle file.

    dependencies {
      implementation 'com.salesforce.service:servicesdk:224.2.6'
    }
  2. Declare permissions.

    You must declare the following permissions in your AndroidManifest.xml.

    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

You can now start using the Service SDK for Android.