Requirements

This guide covers everything you need before you can install and use the Kustomer Chat Android SDK.

Android development requirements

The Kustomer Chat Android SDK requires the following:

• Android version: At minimum, Android API version 21 (that is, Android 5.0 Lollipop)
• Multidex (enabled): Multidex must be enabled in the App. To learn more, see Configure your app for multidex in the Android developer documentation.

Kustomer platform permissions

To work with the Kustomer Chat SDK, you'll need at least Administrator-level permission sets to create API keys and to access the chat settings for your Kustomer organization.

Kustomer API Key

The Kustomer Chat SDK requires an API key with the org.tracking role for your Kustomer organization.

You can manually generate an API key in your Kustomer Security settings.

Manually generate the API key

To generate the API key manually:

1. Go to Settings in your Kustomer app, and select Security > API Keys > Add API Key.

2. Enter a descriptive name for your API key. Set Roles to org.tracking and Expires (in days) to "No Expiration".

3. Select Create to generate a new API Key. Save your API key in a secure location.

To learn more about Kustomer API keys, see API keys in the Kustomer Help Center.

Default Android permissions

The Kustomer Chat UI Android SDK includes the following permissions by default:

<!--Required to make network requests-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>

<!--Required to take a picture and send as an attachment over chat-->

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

<queries>
    <intent>
        <action android:name="android.media.action.IMAGE_CAPTURE" />
    </intent>
    <intent>
        <action android:name="android.intent.action.GET_CONTENT" />

        <data android:mimeType="*/*" />
    </intent>
    <intent>
        <action android:name="android.intent.action.SEND" />

        <data android:mimeType="*/*" />
    </intent>
</queries>

Optional: Remove permissions for attachments

You can remove the permission to request camera access if you don't allow taking pictures.

Use the following code to override the default permissions for CAMERA:

<uses-permission android:name="android.permission.CAMERA" tools:node="remove" />

Proguard rules

If you are using Proguard in your app, add the following rules to your Proguard rules file.

# Kustomer
-dontwarn com.kustomer.**
-keep class com.kustomer.** { *; }

# PubNub
-dontwarn com.pubnub.**
-keep class com.pubnub.** { *; }

Additional Dexguard rules

If you are using Dexguard in your app, please make sure to include the following Dexguard rules along with our existing Proguard rules.

-keepresources drawable/ic_kus_*
-keepresources drawable/kus_*

📘

Note

We will add these rules within our SDKs consumer-proguard.pro file in a future release.