Desk360 Mobile Chat SDK for Android

Last update: Dec 13, 2022

Overview

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

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 {
		...
		maven { url 'https://jitpack.io' }
	}
}

Add the dependency

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

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

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-livechat-android-sdk</artifactId>
	    <version>Tag</version>
	</dependency>

Step 3. 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 liveChatManager = LiveChatManager.Builder()
                .setDomainAddress("https://your.domain.address/")
                .setToken("your_private_token")
                .setLanguageCode("language_code")
                .build()

        Desk360LiveChat.init(activity.applicationContext, liveChatManager) { isActive ->
           // your code
        }

        // 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

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

Liquid SDK (Android)

Liquid Android SDK Quick Start to Liquid SDK for Android This document is just a quick start introduction to Liquid SDK for Android. We recommend you

17 Nov 12, 2021

AWS SDK for Android. For more information, see our web site:

AWS SDK for Android For new projects, we recommend interacting with AWS using the Amplify Framework. The AWS SDK for Android is a collection of low-le

975 Dec 24, 2022

新浪微博 Android SDK

ReadMe 公告：鉴于线上服务器出现问题，推荐下载本地aar后上传到自己公司的服务器，保证后续服务稳定，我们也将尽快重新提供一个稳定的地址供大家使用。新包地址：https://github.com/sinaweibosdk/weibo_android_sdk/tree/master/2019

1.8k Dec 30, 2022

Official Appwrite Android SDK 💚 🤖

Appwrite Android SDK This SDK is compatible with Appwrite server version 0.8.x. For older versions, please check previous releases. Appwrite is an ope

62 Dec 18, 2022

This App is sending Face capture data over network, built around the latest Android Arcore SDK.

AndroidArcoreFacesStreaming From any Android phone ArCore compatible, using this app will send over TCP 5680 bytes messages: The first 5616 bytes is a

30 Nov 16, 2022

Trackingplan for Android SDK

With Trackingplan for Android you can make sure that your tracking is going as you planned without changing your current analytics stack or code.

3 Oct 26, 2021

Storyblok Kotlin Multiplatform SDK sample (Android, JVM, JS)

storyblok-mp-SDK-sample *WIP* ... a showcase of the Storyblok Kotlin Multiplatform Client SDK. (Android, JVM, JS, iOS, ...) What's included 🚀 • About

6 Jan 8, 2022

A demo of Rongcloud uniapp sdk integration for compiling debug-apk in Android Studio

Rongcloud-uniapp-sdk-demo A demo of Rongcloud uniapp sdk integration for compiling debug-apk in Android Studio 这是一个为了给uniapp在Android平台打出debug-apk的demo

1 Oct 13, 2021

StreamPack: live streaming SDK for Android based on Secure Reliable Transport

StreamPack: live streaming SDK for Android based on Secure Reliable Transport (SRT) StreamPack brings the best audio/video live technologies together

2 Aug 10, 2022

Comments

java.lang.IllegalStateException StartNewChatActivity You need to use a Theme.AppCompat theme

Flutter SDK: 3.0.5
compileSdkVersion 33
minSdkVersion 21
targetSdkVersion 33
classpath 'com.android.tools.build:gradle:7.2.1'
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.10"
implementation 'com.github.Teknasyon-Teknoloji:desk360-livechat-android-sdk:1.2.3'
dataBinding: true

I am getting this error while trying to do a simple test just like the example inside the docs

   val liveChatManager = LiveChatManager.Builder()
            .setDomainAddress("https://8orders.desk360.com")
            .setToken("token")
            .setLanguageCode("tr")
            .setUserName("Luke")
            .setUserEmailAddress("[email protected]")
            .setSmartPlug(settings)
            .build()

Fatal Exception: java.lang.RuntimeException: Unable to start activity ComponentInfo{com.test.test/com.desk360.livechat.presentation.activity.livechat.StartNewChatActivity}: java.lang.IllegalStateException: You need to use a Theme.AppCompat theme (or descendant) with this activity.
       at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3308)
       at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3457)
       at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:83)
       at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:135)
       at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:95)
       at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2044)
       at android.os.Handler.dispatchMessage(Handler.java:107)
       at android.os.Looper.loop(Looper.java:224)
       at android.app.ActivityThread.main(ActivityThread.java:7562)
       at java.lang.reflect.Method.invoke(Method.java)
       at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:539)
       at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:950)

opened by ahmedsalamay 1

Releases(1.2.3)

1.2.3(Aug 25, 2022)
Fixed offline firebase path

Source code(tar.gz)
Source code(zip)
1.2.2(Aug 17, 2022)
Remove rx binding dependency

Source code(tar.gz)
Source code(zip)
1.2.1(Aug 14, 2022)
Improve internet connection control in chat

Source code(tar.gz)
Source code(zip)
1.2.0(Jul 25, 2022)
Fixed online offline request timing.

Add auto login concept

Add canned response feature.

Fixed general helper bug fix

General refactor.

Source code(tar.gz)
Source code(zip)
1.1.0(Jul 25, 2022)
Fixed to add file option for online chat case.

Add custom fields for offline chat and dynamic offline chat screen

Add base model refactor for isOffline mode properties check.

Fixed Firebase helper bug

Add Style status bar

General refactor.

Source code(tar.gz)
Source code(zip)
1.0.8(Jan 6, 2022)
Fixes

Assets fixed for API 23 and below

Fixed to require urls end with slashes,

Source code(tar.gz)
Source code(zip)
1.0.7(Dec 29, 2021)

Source code(tar.gz)
Source code(zip)
1.0.6(Sep 1, 2021)

Source code(tar.gz)
Source code(zip)
1.0.5(Aug 10, 2021)

Source code(tar.gz)
Source code(zip)