ANDROID SDK

Desk360 is an Android SDK that helps you embed customer support in your mobile Android apps with ease.‌
Features
The Desk360 SDK lets customers do any of the following:‌
Create new support tickets
View and comment on existing tickets
Interactively communicate with related support teams.
The latest version of Android SDK is 0.7.3.
Installation
Gradle
To integrate Desk360 into your Android project, add the code below to your project level build.gradlle
allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}
Add the dependency
dependencies {
  implementation 'com.github.Teknasyon-Teknoloji:desk360-android-sdk:0.7.3'
}
Or Maven
Step 1. Add the JitPack repository to your build file
<repositories>
  <repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
  </repository>
</repositories>
Step 2. Add the dependency
<dependency>
  <groupId>com.github.Teknasyon-Teknoloji</groupId>
  <artifactId>desk360-android-sdk</artifactId>
  <version>Tag</version>
</dependency>
Add to your AndroidManifest.xml
<application
	...
	<activity
    android:name="com.teknasyon.desk360.view.activity.Desk360BaseActivity"
    android:windowSoftInputMode="stateHidden|adjustResize"
    android:theme="@style/Theme.AppCompat.Light.NoActionBar"/>
</application>
Network Security Config
Create network_security_config.xml  and add it to your application.
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">teknasyon.desk360.com</domain>
    </domain-config>
</network-security-config>
​
Add reference to new created network security config in application tag in your manifest file
<application
	...
    android:networkSecurityConfig="@xml/network_security_config"
​
 </application>
or you can just add this line to your application
<application
	...
    android:usesCleartextTraffic="true"
​
 </application>
ProGuard
If you are using ProGuard you must add this rules to avoid further compile issues.
-keep class com.teknasyon.desk360.model.** { *; }
-keepnames class com.teknasyon.desk360.model.** { *; }
-keep class com.teknasyon.desk360.modelv2.** { *; }
-keepnames class com.teknasyon.desk360.modelv2.** { *; }
Usage
Desk360 helper method returns an intent to open Desk360 screen. 
Target ID is the ID of a ticket opened with a notification. If there is no intent to open a ticket page directly this parameter can be passed blank.
Push token can be fetched from Firebase Messaging SDK. If notification integration won’t be used, this parameter can be left blank.
Start Desk360
val intent = Desk360Constants.initDesk360(
    context= context,
    token= pushToken,
    targetId= targetId,	
    appVersion= BuildConfig.APP_VERSION,
    deviceToken= uuid,
    appKey= BuildConfig.DESK360_KEY,
    appLanguage= "en",
    environment = "production",
    platform = Platform.GOOGLE,
    appCountryCode = "de",
    name = "user name",
    emailAddress = "[email protected]"
)
startActivity(intent)
Parameters
Description
token
Firebase token
targetId
ticket ID from Firebase message body
appKey
desk360 API Key will provided when you get the license
appVersion
version number of your application
deviceToken
your Android device ID
appLanguage
Code for SDK languages: "en" , "fr" , "tr"
environment
Production for prod
Sandbox for development
platform
Only for devices with Huawei Mobile Service (hms): Platform.HUAWEI 
For others: Platform.GOOGLE
appCountryCode
Country Code
name
User name
emailAddress
User email address
GetFirebase Token
FirebaseInstanceId.getInstance().instanceId
​
.addOnCompleteListener { task ->
​
    if (task.isSuccessful && task.result != null) {
      val token = task.result!!.token
    }
}
Parse "targetId" from Firebase Notification Body (Firebase Notification Service)
When your application is on foreground onMessageReceived will handle notification body.
override fun onMessageReceived(remoteMessage: RemoteMessage) {
  super.onMessageReceived(remoteMessage)
​
  val hermes = remoteMessage.data["hermes"]
​
  hermes?.let {
	val targetId = Desk360Constants.getTicketId(hermes)
}
Handling "targetId"
If target_id is not null you must open Desk360SplashActivity if not you must open your starting activity
Example (In your firebaseMessagingService class) :
​
 val pendingIntent: PendingIntent?
​
        pendingIntent = targetId?.let { targetId ->
​
            val intent = Desk360Constants.initDesk360(
                context = this,
                token = "your firebase token",
                targetId = "targetId from notification body",
                appVersion = "app version",
                deviceToken = "your Android device id",
                appKey = "desk360 api key ",
                appLanguage = "your selected ISO 639 - 1 Code for language",
                environment = "String flag for test or prod environment info",
                platform = "Only hms device Platform.HUAWEI, others Platform.GOOGLE",
                appCountryCode = "country code",
                name = "user name",
                emailAddress = "user mail address"
            )
		    
            intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_SINGLE_TOP)
​
            PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_ONE_SHOT)
        } ?: run {
            PendingIntent.getActivity(this, 0, Intent(this, YourStartingActivity::class.java), PendingIntent.FLAG_ONE_SHOT)
        }
Parse "targetId" from Firebase Notification Body (Starting Activity)
When your application is killed the notification body will be in your starting activity's extra.
val bundle = intent.extras
  bundle?.let {
	
  val hermes = bundle?.getString("hermes")
    hermes?.let {
      val targetId = Desk360Constants.getTicketId(hermes)
    }	
}
Open Desk360 without Notification Service
If your app will not use notification then you must set token "and for targetId"
val intent = Desk360Constants.initDesk360(
    context = this,
    token = "your firebase token",
    targetId = "targetId from notification body",
    appVersion = "app version",
    deviceToken = "your Android device id",
    appKey = "desk360 api key ",
    appLanguage = "your selected ISO 639 - 1 Code for language",
    environment = "String flag for test or prod environment info",
    platform = "Only hms device Platform.HUAWEI, others Platform.GOOGLE",
    appCountryCode = "country code",
    name = "user name",
    emailAddress = "user mail address"
)
​
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_SINGLE_TOP )
startActivity(intent)
finish()

Language
If you don't want to use custom language then you must set to "", desk360 SDK will use your Android device language
Customize Desk360 Theme
You should use Desk360 dashboard for custom config. For further information, please contact us via [email protected]​
SDK - Previous
iOS SDK
Next - DESK360 API (beta)
API Documentation
Last updated 3 weeks ago
Parameters	Description
token	Firebase token
targetId	ticket ID from Firebase message body
appKey	desk360 API Key will provided when you get the license
appVersion	version number of your application
deviceToken	your Android device ID
appLanguage	Code for SDK languages: "en" , "fr" , "tr"
environment	Production for prod Sandbox for development
platform	Only for devices with Huawei Mobile Service (hms): Platform.HUAWEI For others: Platform.GOOGLE
appCountryCode	Country Code
name	User name
emailAddress	User email address