Android

v3.3.1

Release date: 11-14-2024

Added

• Added new customer attributes sharedPhones, sharedEmail, and sharedSocials, deprecating emails, phones, and socials, respectively. This provides clearer visibility on updated customer attributes.

Fixed

• Fixed an issue where the navigation would reset after attachment selection in Android OS 33+ devices.
• Fixed a SecurityException thrown when monitoring network status via system service callback.
• Fixed an IndexOutOfBoundsException occurring when converting chat responses to chat messages for the UI.

v3.3.0

Release date: 11-01-2024

Added

• Added openChatAssistant() method as a distinct option to initiate a new conversation with a specified assistant ID. Unlike overrideAssistant(), this method preserves the current active assistant settings in the SDK, allowing new conversations to default to the SDK's active assistant set. This addition also brings feature parity with the iOS SDK.

Fixed

• Fixed an issue where a customer's initial messages were ignored when starting a new conversation with an assistant. This flow now functions correctly with or without an assistant configured.

v3.2.3

Release date: 10-22-2024

Fixed

• Fixed an issue related to the usage of the OkHttp BOM that caused build failures when using Android Gradle Plugin versions 8.2 or higher.

Updated

• The in-app notification logic has been updated to display notifications while the app is in the foreground across all screens, including Kustomer’s views. In prior versions, notifications were only shown when Kustomer views were visible. This update brings the Android behavior in line with the iOS SDK.
• The SDK initialization logic has been updated to ensure that chat assistant rules are always processed, even if an assistant override is present. This update brings the Android behavior in line with the iOS and chat-web SDKs.

v3.2.2

Release date: 10-18-2024

Fixed

• Fixed an issue where the unread count indicator was not set when a conversation received a satisfaction survey while the app was killed. The unread count is now correctly updated when the chat history is reopened.
• Fixed a NullPointerException in KusChatFragment.getBinding that occurred when the pull-to-refresh action was still running while the chat screen was closed.

Updated

• Updated Pubnub version to 9.0.0
• Updated Moshi version to 1.15.0
• Updated OkHttp version to 4.11.0 and added explicit dependency.

v3.2.1

Release date: 09-26-2024

Fixed

• Fixed an issue where the unread count indicator failed to update correctly upon receiving an initial outbound message while the app was terminated.

v3.2.0

Release date: 09-13-2024

Added

• Added Kustomer.isVisible() to the SDK, matching iOS support. Kustomer.isBackground() has been deprecated.
• Introduced KusLogLevel with type-safe log levels in the SDK. You can now set log levels using options..setLogLevel(KusLogLevel). The previous method, options.setLogLevel(Int), is now deprecated.
  

Fixed

• Resolved an IllegalArgumentException on Android OS version 28 and earlier, triggered by overriding the SDK locale with KustomerOptions.setUserLocale() and setting it to the system default, which caused duplicate entries in LocaleList that were not properly supported on older Android versions
• Fixed an issue with log levels where setting the level to "info" only logged info messages, whereas setting it to "error" logged both info and error messages. The hierarchy has been fixed with the introduction of KusLogLevel which enforces proper log level hierarchy.

Improved

• Corrected various lint errors in the UI and core packages for better code quality.

v3.1.3

Release date: 08-20-2024 // Docs (latest)

Added

• Added Kustomer.close() functionality to the SDK, which closes the single Activity used by Kustomer.

Fixed

• Fixed an issue where chat assistant rules were not evaluated in some instances.
• Fixed a localization issue in which certain locales set via KustomerOptions.setUserLocale() were not parsed correctly.
• Fixed a navigation issue caused by a missing default value.
• Fixed a minor NullPointerException that occurred when parsing the verifiedAt field for an identified customer.

v3.1.2

Release date: 08-07-2024

Added

• Added pull-to-refresh functionality for the chat conversation view.

Fixed

• Fixed an issue where the unread message count included messages from different brands.
• Fixed a UI glitch that occurred with blank avatars whenever a conversation was opened.

v3.1.1

Release date: 06-28-2024

Fixed

• Fixed an issue where featured articles failed to load when opened for non-default brands.
• Fixed a minor UI bug in which the "no search results" view text was incorrectly aligned on smaller devices.

Updated

• Upgraded knowledge base APIs to v4, enhancing the reliability of handling article locales and translations.

v3.1.0

Release date: 06-04-2024

Added

• Added support for per app languages for devices with Android 13 and higher. To fully support this feature in the SDK, use KustomerOptions.useAppLocales during SDK initialization, which will honor the app language set by the user. For more information, see localization in Kustomer Android Chat SDK.

Fixed

• Fixed a minor NPE happening during fragment transitions.

🚧

Firebase Cloud Message Server API Keys are being discontinued

To ensure uninterrupted service to Android push notifications, you must upload your new FCM Private Key file to Kustomer by June 20, 2024. Legacy keys will no longer be supported after this date.

Please note that this update does not require an SDK upgrade.

For information on creating your new FCM Private Key file, see Configure push notifications in Kustomer.

v3.0.0

Release date: 04-23-2024

Improved

• Improved the reliability of incoming message delivery when actively viewing a conversation.

v2.13.6

Release date: 04-16-2024

Improved

• Improved and optimized how we fetch messages for a given conversation in our UI.
• Improved the ‘No internet connection’ banner displayed in the chat UI.

v2.13.5

Release date: 04-02-2024

Fixed

• Fixed an intermittent issue where the unread message count didn't properly reset after a user visited a conversation.

v2.13.4

Release date: 03-13-2024

Removed

• Removed UI header for KnowledgeBase category results to mirror other SDKs.

Improved

• Improved the German translations in the knowledge base UI.

v2.13.3

Release date: 02-22-2024

Fixed

• Fixed an issue where the initial agent message disappeared after the user replied to conversations initiated with a default message.
• Fixed an issue where the agent avatar was missing for conversations initiated with a default message.

Updated

• Update Kotlin Coroutines version to 1.6.4.

v2.13.2

Release date: 02-09-2024

Added

• Ignore conversation messages sent from other brands.

Fixed

• Fixed an issue where satisfaction (CSAT) surveys did not appear in a conversation if the customer was still viewing it. Now, once an agent marks the conversation done, the CSAT will be shown to the customer.

Updated

• Update PubNub version to 7.8.0.
• Update Moshi version to 1.14.0.
• Update Kotlin version to 1.8.21.

v2.13.1

Release date: 01-25-2024

Fixed

• Handle multiple concurrency issues in the UI package.
• Fixed an issue that caused initialization errors due to keyset brand mismatch.

v2.13.0

Release date: 12-01-2023

Added

• Support for displaying AI chat assistant messages.
• Support for AI assistant typing indicator.

Fixed

• Initial messages from the chat assistant were missing intermittently.
• User avatar is missing for attachment messages from the agent.
• Tapping on deflection articles after dismissing quick reply actions resulted in a crash.
• Intermittent unresponsive UI when answer button feedback actions are taken.

Improved

• Moved all quick reply actions into the message thread.

v2.12.1

Release date: 10-16-2023 // Docs

Improved

• Catching bugs that caused chat to crash following:
  • An IndexOutofBoundsException error.
  • A request to okhttp3.

Added

• EventBus publishing within Kustomer's logging which allows users to subscribe to events with their error logger.

v2.12.0

Release date: 09-14-2023

Fixed

• Fixed an issue where articles failed to open due to an incorrect URL.
• Fixed an issue that could cause chat sessions to appear across multiple brands in the same integration.
• Fixed an issue where messages sent by an agent would periodically disappear.

v2.10.9

Release date: 05-16-2023

Fixed

• Fixed an issue with displaying branded knowledge base articles.

v2.10.8

Release date: 05-08-2023

Fixed

• Fixed bugs that caused chat to crash following an ConcurrentModificationException error.

v2.10.7

Release date: 03-22-2023

Fixed

• Fixed bugs that caused chat to crash following:
  • An IndexOutofBoundsException error.
  • A request to okhttp3.
• Fixed a bug that might cause the app to crash if the internet connection is lost.

v2.10.6

Release date: 02-21-2023

Fixed

• Fixed bugs that caused chat to crash following:
  • An IndexOutofBoundsException error
  • An ArrayIndexOutofBoundsException error
• Fixed a bug that caused inbound message bubbles to overlap.

v2.10.5

Release date: 11-28-2022

Summary: Hotfix release

Fixed

• Fixed knowledge base article URLs for articles not hosted on custom domains where the top-level domain is .support.

v2.10.4

Release date: 11-16-2022

Fixed

• Fixed a bug where articles that were not in a default brand category failed to open when viewing them in the chat UI. Now, all articles in all brands are displayed properly.
• Fixed a bug where viewing images with a wide aspect ratio caused the app to crash.
• Fixed a bug where the No Connection banner covered the first message in the conversation list.
• Fixed an issue with the unavailable greeting message being off-center.
• Fixed a bug where end-user default messages were ignored when a chat assistant was present.

Improved

• Improved the accuracy of Turkish translations.
• The Deflection report now immediately shows all articles that are clicked in chat, even if the chat is abandoned after the article is clicked.

Added

• Initial messages sent to a customer now appear on the agent timeline when creating a new session.

v2.10.3

Release date: 10-06-2022

Added

• Added a new openKbCategory method that can be used to open a Knowledge base category by its ID.
• Added support to display knowledge base articles marked as “Featured Articles” on the Answers tab in the chat UI.

Improved

• Increased the display height for multi-level lists in the chat UI.
• Improved scroll jank that appeared when multiple assistant template messages are received in a row.

v2.10.2

Release date: 08-22-2022 /

Added

• Added filtering for insecure file types.

Improved

• Improved the user experience when starting a conversation if you have a default assistant set. Now, you can also choose to override the default so that an assistant isn't used at all.
• Improved the conversation list UI. Now, a New Messages divider visually indicates where new, unread messages begin.
• Changes to Chat settings now reflect immediately within the SDK.

v2.10.1

Release date: 08-04-2022

Summary: Hotfix release

Removed

• Removed unused launcher icon files from the SDK.

v2.10.0

Release date: 07-27-2022

Added

• Added a button that allows you to quickly scroll down to the bottom of the message thread.

Improved

• Improved how customer deletion is handled. Now, end-users are logged out of chat when the delete event is received.
• Improved how conversation deletion is handled. Now, deleting an open conversation ends the chat, and the customer is prompted to start a new conversation.
• Improved the exception shown if an app tries to access Kustomer before it’s initialized.
• Improved how articles render in the SDK.

Updated

• Updated jetpack navigation libraries from 2.3.4 to 2.4.2.

Removed

• Removed unused launcher icon files from the SDK.

v2.9.11

Release date: 06-22-2022 // Docs

Added

• Added support for setting a lock-out period with satisfaction (CSAT) surveys. To edit the time period, go to the Settings > Satisfaction > General tab in your Kustomer organization.
• Added two new parameters that can be used on conversation creation:
  • describeAttributes parameter can be used to pass conversation attributes
  • title parameter that can be used to set the conversation name
    For more information, see Start new conversation.

Improved

• Improved the loading of customer profiles with a large conversation history.
• Improved the color of file names sent in messages so that they match the color scheme set by the developer.

v2.9.10

Release date: 05-25-2022

Fixed

• Fixed a bug that caused isLoggedIn to incorrectly return as false when an anonymous customer profile was merged after login.
• Fixed a bug where devices are showing a ‘No Internet Connection’ banner warning despite being connected to wifi.
• Fixed a bug that displayed the ‘Power by Kustomer’ logo when the setting was turned off.

Added

• Added the ability to pinch-to-zoom an image.
• 
  

Improved

• Improved unread counts for conversations with messages going back more than 30 days.
• Improved pagination performance.
• Improved the accuracy of Turkish translations.

Updated

• Updated the Pubnub Jackson library to the latest version.

v2.9.9

Release date: 04-18-2022

Summary: Hotfix release

Improved

• Improved PubNub connection handling for implementations that do not have chat push notifications configured.
• Improved error logging for connection issues. Now, the log displays a red “Error” message if you’re unable to establish a connection with our backend systems.

v2.9.8

Release date: 04-06-2022

Fixed

• Fixed a bug that periodically caused observeActiveConversationIds to return a previously closed conversation.
• Fixed a bug where read receipts weren’t updating for messages sent with attachments.

Added

• Added the preferredView option which allows you to customize what view customers see when they first open the chat widget. This was previously called KusWidgetType.

Improved

• Improved push notifications. Now, we display your org’s app icon in the notification instead of the user avatar.
• Improved error logging around describing a conversation. Now, you will see exact error codes, along with a description of the issue.

v2.9.7

Release date: 03-09-2022

Fixed

• Fixed a bug where the greeting image and message aren’t shown to customers who have chat history turned off.

Added

• Added a title to push notifications to provide additional context to the existing push notification message preview.
• Added a new ‘startNewConversation` method which introduces the functionality to start a new conversation with an end-user message by specifying the initial message direction.

Improved

• Improved the accuracy of Turkish translations.
• Improved the keyboard’s performance while searching the knowledge base.
• Improved how we send CSAT responses to our backend to support CSAT reporting in a variety of languages.

Deprecated

• openNewConversation has been deprecated. Please see startNewConversation.

v2.9.6

Release date: 02-23-2022

Fixed

• Fixed a rare bug that caused the app to crash when calling setChatSettings.
• 
  

Added

• Added a footer to the Knowledge Base search results page that indicates if more than 100 articles were found.
• Added support for disabling attachments. To edit, go to Apps > Chat > Settings on the Kustomer website.

Improved

• Improved the UI when viewing CSAT surveys that contain many questions.
• Improved the Knowledge Base UI by adding a loading indicator.
• Improved our authentication to fix an issue where a chat conversation would occasionally not have an assistant.

Updated

• Updated the Firebase Messaging Library to the latest version.
• Updated sorting on the conversation list. Now, the list is sorted by the timestamp of the most recent message within a conversation.

v2.9.5

Release date: 01-19-2022 //

Summary: Hotfix release

Fixed

Fixed an issue where assistant conversations may show in chat history with an incorrect team name and avatar.

v2.9.4

Release date: 01-13-2022

Fixed

• Fixed a bug that was causing knowledge base articles to render incorrectly when viewing them on an Android device.
• Fixed a race condition that could lead to a rare app crash.
• Fixed a bug where a CSAT message preview wasn’t being shown in the history view if it was the last message in the thread.
• Fixed a bug that prevented a confirmation message from displaying when a user selected a negative article rating if Article Feedback is turned off. Now, users will receive confirmation that their feedback has been submitted.
• Fixed a bug that was giving users the ability to start more than one chat conversation when an existing conversation was loading and ‘restrict to single open chat’ was enabled.

Added

• Added the ability to disable in-app notifications using the showInAppNotifications configuration option. For more information, see KustomerOptons class reference.

Updated

• Updated the conversation list to no longer display draft conversations.