Desk360 Chat Android SDK

Introduction

Desk360 Live Chat SDK is an open source Android library that provides live support to your customers directly from your application by writing a few lines of code.

Features

• Talk to your customers using our panel and make use of our SDK to identify a user and provide contextual support.
• Powered by Firebase Realtime database
• Username/Email Address login
• Offline Messaging Support
• Text, Image, Video (.mp4) and Document (word, excel, pdf) messages
• Ability to integrate Chatbots.
• Multi-languages support: It supports 40+ languages.
• Chat Feedback
• Smart Plug
• Custom Fields
• Auto Login
• Canned Response

Technical Details

• Coding Language - %100 Kotlin
• Persistence - Room
• Reactive Programming - RXJava, RXAndroid
• Multi-threading
• Architecture- MVVM, Use Cases
• Binding- Data Binding, View Binding
• API Level 21+

Setup

To integrate Desk360 Live Chat into your Android project , add below parts to your build.gradlle

allprojects {
	repositories {
		...
        mavenCentral()
		maven { url 'https://jitpack.io' }
	}
}

To enable the usage of data binding in your Android application, add the following snippet to the app/build.gradle file.

 android {
     dataBinding.enabled = true
     }

Add the dependency

dependencies {
        implementation 'com.github.Teknasyon-Teknoloji:desk360-livechat-android-sdk:1.2.6'
}

(Please change latest_release with : https://jitpack.io/#Teknasyon-Teknoloji/desk360-livechat-android-sdk)

Add File Provider to Your AndroidManifest.xml

	<application>
	...
         	<provider
         	   android:name=".YourFileProvider"
         	   android:authorities="${applicationId}.provider"
         	   android:exported="false"
         	   android:grantUriPermissions="true">
         	   <meta-data
          	      android:name="android.support.FILE_PROVIDER_PATHS"
          	      android:resource="@xml/provider_paths" />
        	 </provider>
	 ....
	 </application>

Usage

import com.desk360.livechat.manager.Desk360LiveChat
import com.desk360.livechat.manager.LiveChatHelper
import com.desk360.livechat.manager.LiveChatManager

        val settings = mapOf("age" to "23")
        
        val liveChatManager = LiveChatManager.Builder()
            .setDomainAddress("https://domain.desk360.com")
            .setToken("token")
            .setLanguageCode("tr")
            .setUserName("Luke")
            .setUserEmailAddress("luke@emailadress.com")
            .setSmartPlug(settings)
            .build()

        Desk360LiveChat.init(this, liveChatManager) { isActive ->
            // You can start Desk360LiveChat after initialization completed
            btnLiveChat.visibility = if (isActive) 
                View.VISIBLE
            else 
                View.GONE
        }

        btnLiveChat.setOnClickListener {
            // when you want to start Live Chat
            Desk360LiveChat.start()
        }

ProGuard

If you are using proguard you must add this rules to avoid further compile issues.

-keep class com.desk360.livechat.data.** { *; }
-keepnames com.desk360.livechat.data.** { *; }

Versioning

We use SemVer for versioning.

Support

If you have any questions or feature requests, please create an issue.

Licence

Copyright Teknasyon 2022.

Desk360 Live Chat SDK is released under the MIT license. See LICENSE for more information.