Release Notes

All notable releases for the Zendesk SDK for Android will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.17.0] - 2023-11-30

Added

Technical upgrades for better color management.

Fixed

A crash on the Conversation List screen when recovering from the SDK forcibly being closed by the Android system.
A re-rendering issue on the animation of the message receipt.
A crash when entering the Conversation List screen via push notification after the SDK was forcibly closed by the Android system.
Flickering UI of text, image and carousel messages.
Connection banner text changed to “You’re now online” and corrected the text color for dark mode.

[2.16.0] - 2023-10-31

Added

Support for postback action type.

Postback buttons enhance your conversations as they can trigger server-side logic when a user clicks on them and are helpful when building a bot. You can also use them to trigger other server-side actions by clicking a button in the conversation, such as an “add-to-cart” action.

Fixed

Forms with multiple dropdown fields will no longer display multiple dropdown lists at the same time. Only one list will be displayed at a time.

[2.15.0] - 2023-10-03

Added

"See latest" navigation button, which helps users navigate effortlessly to the newest unread messages in a conversation.
Unread messages banner on the conversation screen to indicate to users that there are unread messages in the conversation.
Marking messages in the conversation as read will occur only when clicking the "See latest" navigation button or scrolling to the end of the conversation.
Action buttons in carousel messages for increased user engagement and interactivity.

Fixed

The attachment button has undergone a redesign and fixed an issue where the attachment button was flipped in RTL layouts.
Fixed the issue of adding margin space exclusively for LTR layouts in carousels.
Fixed the behaviour of the retry button in the offline banner to appear after rotating the device.
Resolved the issue where push notifications from the SDK were causing the integrator's app to restart instead of maintaining its current state.
Resolved the issue where the single article within the carousel was scrollable and had the previous and next arrow buttons displayed.
Resolved the issue of the conversation screen back button being not responsive under certain network conditions.

Changed

Update Kotlin to 1.8.
Update Gradle to 8.1.1.

[2.14.1] - 2023-08-28

Fixed

When a user replies using a form field, spell check doesn’t behave as expected compared to the Message Composer.
When a user is typing into a form field of type text, the text is converted into title case.
Conversation does not scroll to the bottom after presented with quick reply options.

[2.14.0] - 2023-08-16

Added

Android 14 support.
Accessibility improvements made to carousels.
When attachment uploads fail due to the max file size limit (50MB), the error message will indicate that the file size exceeds the limit.
An error message and a retry button will be displayed when the conversation screen fails to load.
The “sending” state for messages and attachments will persist for 60 seconds and lead to the “failed” status with a retry option if unsuccessful after 60 seconds.
Minor visual improvements to messages in a sending state.

[2.13.0] - 2023-07-05

Added

APIs to set messaging metadata, also known as conversation fields and conversation tags.
APIs to clear conversation fields and conversation tags from the SDK storage.
Support multiple buttons in carousel cards.

Fixed

Typing event should not force scroll the user to the bottom of the conversation screen.
Zendesk colors should not be used as a fallback.
The SDK should function when integrated with applications that run R8 and ProGuard.
Missing line space for taller locales in proactive message.

[2.12.0] - 2023-05-30

Added

Re-login an authenticated user when a user merge event is detected.
Functionality to enable and disable upload attachments. To disable attachments for mobile devices, you must disable them for both iOS and Android. Note: This feature is available only from version 2.12.0 and later.

Fixed

A field disappears after submitting form while offline.
Messages sent from web are now displayed on both the logged in iOS and Android conversation.
Image attachments is not being displayed.
The blockChatInput flag is not properly handled.
Outbound messages are not grouped correctly.

Changed

Kotlin version to 1.7.21.
The ProGuard rules have been updated to ensure compatibility with the default R8 mode enabled by Gradle 8.

[2.11.0] - 2023-04-24

Added

An API to set text color values until this is available to set via Admin Center.

Fixed

Theme colors now dynamically update when the configuration is updated.

[2.10.0] - 2023-04-17

Added

Various improvements to support future capabilities.

[2.9.0] - 2023-03-27

Added

Proactive messaging support.

Fixed

Conversation screen should scroll to the bottom in landscape mode after uploading images.

Changed

Removed elevation and drop shadow from form buttons.

[2.8.0] - 2022-11-30

Added

Accessibility support to ensure new messages are announced to the user in real time.

Fixed

Answer Bot interactions will always be displayed in the right order.
Failed messages will not affect the status of following successful messages.
Attachment button will still be visible when the composer is disabled.
Unread message divider will always be displayed for messages received while the app is in the background.
Compilation error will not occur when customer uses FileProvider.

[2.7.0] - 2022-10-26

Added

Upgrade Kotlin dependency to version 1.6.X.
Support link action type for all messages.
Upgrade Coil dependency to latest version.

Fixed

Tapping a form text field scrolls to the bottom of the conversation.
Exception appears in logs for Coil upgrade.
NullPointerException in API level 28 and below caused by URLConnection.
ConnectionBanner causes Stackoverflow crash.

[2.6.0] - 2022-09-15

Added

Capability to load more than 100 messages when the user scrolls to the top of the message list.
Accessibility improvements.

Fixed

Notifications runtime permissions will show up on screen (Android 13 only).
Tapping a sent video will play it.
Users will see the latest message that was displayed on the push notification when they tap a notification.

[2.5.0] - 2022-08-10

Added

Message receipt animation.
Improve accessibility.
Push notification permissions.
Media permissions.

Fixed

Scrolling issue after submitting a form.

Changed

Android 13 support.
Carousels have an improved design to a more modern structured look.

[2.4.0] - 2022-05-30

Added

Timestamp divider and grouping of messages on the conversation screen.
Improved handling of denial of permissions.
Support for increased number of items in the dropdown in a future release.

Fixed

Bug fix for the text composer not being re-enabled when new messages are received.

[2.3.0] - 2022-03-31

Added

Sending page view event for Visitor Path.
Support for Android 12.
Agent is typing indicator.

Changed

Kotlin version to 1.5.31.
SDK targets and compiles to API 31.

[2.2.0] - 2022-03-10

Added

A divider in the UI to separate new messages when the user re-enters the conversation screen.
Typed text is now persisted in a conversation screen.

Fixed

Improved connection strategy that sometimes prevented messages from showing in the conversation.

[2.1.0] - 2022-01-25

Added

End user authentication, enables a business to verify the identity of a user.

[2.0.0] - 2021-12-09

Added

Offline banner to inform user of connectivity state with auto retries and retry button.
Send button animation to indicate progress of form submission.
Skeleton loader is displayed while images and avatars are downloading from the network.
Hide the text composer when a form field is in focus.
Event Observer API to observe events emitted from the Zendesk SDK. See events documentation.
Event that passes the unread message count when the total number of unread messages has updated.
API to get the total number of unread messages.

Fixed

Android 12 (API 31) pending intent mutability change as per Android 12's documentation.
Email keyboard not displaying on Android 5.1.
EOFException terminating the WebSocket connection.
Focus on first form field triggering keyboard for text or expanding dropdowns.

Changed

SDK initialization moved from the Messaging module to the Zendesk module to enable flexibility as more capabilities are made available alongside messaging. See Initialize the SDK for more details.
Initialization snippet to accept a factory implementation of messaging.
Initialization errors are returned as a Throwable object instead of ZendeskError object.

Deprecated

Messaging module public APIs are now deprecated. Use the Zendesk module public APIs instead. The Messaging SDK initialization will be removed in a future version of the SDK.

[1.2.0] - 2021-10-04

Added

The ability for the end user to send images and file messages. See File Validation for all the supported file types.

[1.1.0] - 2021-08-24

Added

HTTP response caching for REST clients.
Additional details were added to initialization flow errors to more easily diagnose issues.

Fixed

A logger issue when an exception message was null.

[1.0.2] - 2021-08-10

Added

FR-CA locale as a new language.

Fixed

Quick replies not sending metadata to enable CSAT rating and fix reopening ticket issue.
Internal concurrent safe access to event listeners.
Flickering of sent messages when re-opening the conversation.
Ordering quick replies in place as received.
Carousel not adhering to RTL specifications.
Updating failed messages when opening the conversation from a push notification.
(Forms) Text field vertical space not reclaimed when re-validated.
(Forms) Icon missing in form field validation.
(Forms) Keep form response in place (replace form), instead of adding as a new message.
Optimized GIF loading.
Added 1dp border to image messages for smoother rounded corners.
Conversation screen showing a blank in edge cases.
Messages in a blank Conversation should flow from the top of the screen.
(API 21) Failed messages not properly styled.
(API 21) Font size not increasing.

[1.0.1] - 2021-02-08

Fixed

Message content partially displaying offscreen due to a mismatching version of ConstraintLayout.

[1.0.0] - 2021-02-01

The initial public version of the Zendesk SDK for Android.

Added

The ability for the end-user to start a messaging conversation with your business.
Direct integration with Zendesk's Flow Builder for building automated conversations.
The ability for the end-user to receive text, image, quick reply and carousel messages.
The ability for the end-user to send text messages to your business.
The ability for your business to send a form to the end-user and have the completed form returned.
The ability to customize the SDK's user interface colors from Zendesk’s Admin Center.
Support for 33 languages, including right-to-left languages. For the full list, see Language codes for Zendesk supported languages.
Support for Dark theme.
Support for landscape mode.
Support for WCAG 2.1 accessibility.