Authentication

TapTalk.io Omnichannel SDK provides some essential methods to handle user authentication.

Authenticate User (Optional)

You can authenticate the user that is currently logged in before calling openTapTalkLiveView. To do this, provide the user's full name and email by calling authenticateUser from the TapTalkLive class after initializing the SDK.

Java

YourActivity.java

import io.taptalk.taptalklive.TapTalkLive;
import io.taptalk.taptalklive.Listener.TTLCommonListener;

...

TapTalkLive.requestAccessToken(FULL_NAME, EMAIL, new TTLCommonListener() {
    @Override
    public void onSuccess(String successMessage) {
        // Authentication successful
    }

    @Override
    public void onError(String errorCode, String errorMessage) {
        
    }
});

Kotlin

YourActivity.kt

import io.taptalk.taptalklive.TapTalkLive
import io.taptalk.taptalklive.Listener.TTLCommonListener

...

TapTalkLive.authenticateUser(FULL_NAME, EMAIL, object : TTLCommonListener() {
    override fun onSuccess(successMessage: String?) {
        // Authentication successful
    }

    override fun onError(errorCode: String?, errorMessage: String?) {
        
    }
})

Parameters NAME: (String) current user's full name EMAIL: (String) current user's email address

After successfully authenticated, user will no longer be required to fill name and email to create a case.

Authenticate with Auth Ticket (Optional)

You can also authenticate using an existing auth ticket with requestAccessToken method from the TapTalkLive class after initializing the SDK.

Java

YourActivity.java

import io.taptalk.taptalklive.TapTalkLive;
import io.taptalk.taptalklive.Listener.TTLCommonListener;

...

TapTalkLive.requestAccessToken(AUTH_TICKET, new TTLCommonListener() {
    @Override
    public void onSuccess(String successMessage) {
        // Authentication successful
    }

    @Override
    public void onError(String errorCode, String errorMessage) {
        
    }
});

Kotlin

YourActivity.kt

import io.taptalk.taptalklive.TapTalkLive
import io.taptalk.taptalklive.Listener.TTLCommonListener

...

TapTalkLive.requestAccessToken(AUTH_TICKET, object : TTLCommonListener() {
    override fun onSuccess(successMessage: String?) {
        // Authentication successful
    }

    override fun onError(errorCode: String?, errorMessage: String?) {
        
    }
})

Parameters AUTH_TICKET: (String) existing auth ticket retrieved from the server

Logout

You can clear the currently authenticated user data using the logout method. After logout is finished, locally saved user and chat data will be cleared, and you may authenticate another user.

Java

import io.taptalk.taptalklive.TapTalkLive;
import io.taptalk.taptalklive.Listener.TTLCommonListener;

...

TapTalkLive.logout(new TTLCommonListener() {
    @Override
    public void onSuccess(String successMessage) {
        // Successfully logged out
    }

    @Override
    public void onError(String errorCode, String errorMessage) {
        // An error occured, but local data is still cleared
    }
});

Kotlin

import io.taptalk.taptalklive.TapTalkLive;
import io.taptalk.taptalklive.Listener.TTLCommonListener;

...

TapTalkLive.logout(object : TTLCommonListener() {
    override fun onSuccess(successMessage: String?) {
        // Successfully logged out
    }

    override fun onError(errorCode: String?, errorMessage: String?) {
        // An error occured, but local data is still cleared
    }
})

Logout and Clear TapTalkLive Data

Call this method when you need to logout and clear all local cached data from Omnichannel SDK.

Java

import io.taptalk.taptalklive.TapTalkLive;

...

TapTalkLive.clearAllTapLiveData();

Kotlin

import io.taptalk.taptalklive.TapTalkLive;

...

TapTalkLive.clearAllTapLiveData()