Updated on 2026-08-14

app/src/main/java/com/tangem/tap/common/chat/ChatConfig.kt

@@ -0,0 +1,24 @@
+package com.tangem.tap.common.chat
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+sealed interface ChatConfig
+
+@JsonClass(generateAdapter = true)
+data class ZendeskConfig(
+    @Json(name = "zendeskApiKey")
+    val apiKey: String,
+    @Json(name = "zendeskAppId")
+    val appId: String,
+    @Json(name = "zendeskClientId")
+    val clientId: String,
+    @Json(name = "zendeskAccountKey")
+    val accountKey: String,
+    @Json(name = "zendeskUrl")
+    val url: String,
+) : ChatConfig
+
+data class SprinklrConfig(
+    val appId: String,
+) : ChatConfig

app/src/main/java/com/tangem/tap/common/chat/ChatManager.kt

@@ -0,0 +1,26 @@
+package com.tangem.tap.common.chat
+
+import android.content.Context
+import com.tangem.tap.ForegroundActivityObserver
+import com.tangem.tap.common.chat.opener.ChatOpener
+import com.tangem.tap.common.chat.opener.implementation.SprinklrChatOpener
+import com.tangem.tap.common.chat.opener.implementation.ZendeskChatOpener
+import com.tangem.tap.persistence.PreferencesStorage
+
+class ChatManager(
+    private val preferencesStorage: PreferencesStorage,
+    private val foregroundActivityObserver: ForegroundActivityObserver,
+) {
+    private val openers = mutableMapOf<ChatConfig, ChatOpener>()
+
+    fun open(config: ChatConfig, feedbackDataBuilder: (Context) -> String) {
+        val opener = openers.getOrPut(config) {
+            when (config) {
+                is SprinklrConfig -> SprinklrChatOpener()
+                is ZendeskConfig -> ZendeskChatOpener(config, preferencesStorage, foregroundActivityObserver)
+            }
+        }
+
+        opener.open(feedbackDataBuilder)
+    }
+}

app/src/main/java/com/tangem/tap/common/chat/opener/ChatOpener.kt

@@ -0,0 +1,7 @@
+package com.tangem.tap.common.chat.opener
+
+import android.content.Context
+
+internal interface ChatOpener {
+    fun open(feedbackDataBuilder: (Context) -> String)
+}

app/src/main/java/com/tangem/tap/common/chat/opener/implementation/SprinklrChatOpener.kt

@@ -0,0 +1,10 @@
+package com.tangem.tap.common.chat.opener.implementation
+
+import android.content.Context
+import com.tangem.tap.common.chat.opener.ChatOpener
+
+internal class SprinklrChatOpener : ChatOpener {
+    override fun open(feedbackDataBuilder: (Context) -> String) {
+        // TODO: Open activity with Sprinklr WebView, will be in further MRs
+    }
+}

app/src/main/java/com/tangem/tap/common/chat/opener/implementation/ZendeskChatOpener.kt

@@ -0,0 +1,83 @@
+package com.tangem.tap.common.chat.opener.implementation
+
+import android.content.Context
+import android.os.Build
+import com.tangem.core.analytics.Analytics
+import com.tangem.domain.common.LogConfig
+import com.tangem.tap.ForegroundActivityObserver
+import com.tangem.tap.common.chat.ZendeskConfig
+import com.tangem.tap.common.chat.opener.ChatOpener
+import com.tangem.tap.persistence.PreferencesStorage
+import com.tangem.tap.withForegroundActivity
+import com.tangem.wallet.R
+import com.zendesk.logger.Logger
+import zendesk.chat.Chat
+import zendesk.chat.ChatConfiguration
+import zendesk.chat.ChatEngine
+import zendesk.chat.ChatProvidersConfiguration
+import zendesk.chat.VisitorInfo
+import zendesk.configurations.Configuration
+import zendesk.messaging.MessagingActivity
+
+internal class ZendeskChatOpener(
+    private val config: ZendeskConfig,
+    private val preferencesStorage: PreferencesStorage,
+    private val foregroundActivityObserver: ForegroundActivityObserver,
+) : ChatOpener {
+    private var isInitialized = false
+
+    override fun open(feedbackDataBuilder: (Context) -> String) {
+        foregroundActivityObserver.withForegroundActivity { activity ->
+            initZendeskIfNeeded(activity.applicationContext)
+            setChatVisitorInfo()
+            setChatVisitorNote(feedbackDataBuilder(activity))
+            showMessagingActivity(activity)
+        }
+    }
+
+    private fun initZendeskIfNeeded(context: Context) {
+        if (isInitialized) return
+        isInitialized = true
+
+        Chat.INSTANCE.init(context, config.accountKey, config.appId)
+        Logger.setLoggable(LogConfig.zendesk)
+    }
+
+    private fun setChatVisitorInfo() {
+        if (preferencesStorage.chatFirstLaunchTime == null) {
+            preferencesStorage.chatFirstLaunchTime = System.currentTimeMillis()
+        }
+        val chatUserId = (preferencesStorage.chatFirstLaunchTime.toString() + Build.MODEL).hashCode()
+        val visitorInfo = VisitorInfo.builder()
+            .withName("User $chatUserId")
+            .build()
+
+        Chat.INSTANCE.chatProvidersConfiguration = ChatProvidersConfiguration.builder()
+            .withVisitorInfo(visitorInfo)
+            .build()
+    }
+
+    private fun setChatVisitorNote(note: String) {
+        Chat.INSTANCE.providers()
+            ?.profileProvider()
+            ?.setVisitorNote(note)
+    }
+
+    private fun showMessagingActivity(context: Context) {
+        Analytics.send(com.tangem.tap.common.analytics.events.Chat.ScreenOpened())
+        MessagingActivity.builder()
+            .withMultilineResponseOptionsEnabled(false)
+            .withBotLabelStringRes(R.string.chat_bot_name)
+            .withBotAvatarDrawable(R.mipmap.ic_launcher)
+            .withEngines(ChatEngine.engine())
+            .show(context, buildChatConfig())
+    }
+
+    private fun buildChatConfig(): Configuration {
+        return ChatConfiguration.builder()
+            .withOfflineFormEnabled(true)
+            .withAgentAvailabilityEnabled(true)
+            .withPreChatFormEnabled(false)
+            .build()
+    }
+}