freshchat_sdk

Bug fix :

• Fixed an Android-only regression (introduced in 6.4.2) where HTML markup typed by an end user in the chat input rendered as a live, clickable link instead of plain text — reopening a previously fixed HTML injection issue. Free-typed message text is now escaped exactly once (on send) and decoded exactly once (on render), while trusted, business-configured content (quick-reply/flow-layout button labels, date/time picker selections) continues to render its intended HTML formatting in Android.
• Fixed the same HTML injection issue in the CSAT/bot free-text comment feedback flow, which shared the same untrusted input source but was not covered by the original fix in Android.
• Fixed the message composer showing a numeric keyboard for free-text bot replies after an earlier step in the same conversation had requested a phone/number/email/OTP input in Android.

Enhancement :

• Replaced deprecated edge-to-edge APIs to clear Play Console warning in Android.

Bug fix :

• Resolved an issue causing occasional crashes during Freshchat deep link handling on select Android devices in Android.

Enhancement :

• Optimized the handling for the bot re-trigger issue.
• Dependencies Updated for libraries in Android.
• Increased Target SDK version to 36 in Android.
• Increased MinSDK version to 23 in Android.
• Migrated LocalBroadcastManager dependency from the deprecated Android Support Library to the AndroidX.
• Added support for iOS 26 with better support for modern UI frameworks in iOS.

Bug fix :

• Reverted bot specific code changes introduced in version 6.5.4 in Android.
• Fixed an issue in the “Browse from Files” upload screen where the keyboard was not dismissed when tapping outside the input area.
• Fixed the auto-scroll to cursor position issue in the reply editor, allowing users to scroll through the message content while typing.

Bug Fixes:

• Included Custom styles with state_focused support in Android.
• Fixed re-occurring toolbar overlapping issue in Android.
• Fixed Bot-retriggering in the middle of an agent conversation in Android.

Enhancements

• Added support for the new EUN data center to ensure improved infrastructure compatibility and better service availability.

Bug fix :

• Fixed an issue where the reply text field was incorrectly visible for bot response feedback messages in iOS.
• Fixed display of internal model ID instead of model name for 17e device in iOS.

Bug Fixes

• Fixed a namespace collision issue between FreshchatSDK and the NewsCore framework in iOS.
• Fixed a rare issue where initial AI agent or bot messages were repeated and getting grouped (clumped) together in iOS.
• Fixed an issue where the keyboard was being dismissed automatically while the user was typing when an AI agent or bot responding to chat conversation in iOS.

Fixed an issue where the getSDKVersion API was returning an older version

Bug Fixes

• Fixed the issue where Edittext is not expanding to Multiline in Android.
• Fixed an issue where welcome msgs content is not clickable in Android.
• Handled statusbar color in Android 15 gracefully in Android.
• Fixed an account migration failure in the deactive state in Android.
• Bug fixes for null pointer exceptions when bundle is null in Android
• Fixed an issue where the text field would not appear for up to 10 seconds when the first bot message included an assignment action in IOS
• Added exception handling to HTML parsing to prevent crash in Channels List screen in IOS.
• Fixed app stop responding to swipe gestures while opening a topic in a parallel conversation in IOS.
• Fixed an issue where messages sent after the post-resolution feedback survey did not start a new conversation in IOS.

Enhancements

• Updated gradle-properties(8.2 to 8.7), build.gradle classpath( 8.2.0 - 8.6.0), kotlin version(1.8.22 - 2.1.0) in Android
• Removed jcenter() in Android
• UnReadCountWithReferenceID() is included for both IOS and Android.
• Keychain items now use WhenUnlockedThisDeviceOnly for improved security in IOS
• Improved app stability by moving heavy startup tasks to the background and making SDK initialization checks safer in IOS
• Ensured correct date display in bot flows when a non-Gregorian calendar is selected in the device settings in IOS
• Channel fetching is now performed safely after the completion of pending tasks, and only when the account is confirmed to be active in IOS

Bug Fixes

• Fixed an ANR while inserting a message in Android
• Fixed an issue where a bot fails to trigger during a chat in Android.
• Fixed an issue where HTML tags appeared as plain text in chats in Android.
• Fixed vote button misplacement in Android
• Fixed a crash occurring during SDK initialization in Android
• Fixed a CursorIndexOutOfBoundsException observed in logs in Android
• Fixed an issue where the FAQ category list screen remained stuck in an infinite loading state in Android
• Crash in SDK for StitchFix while fetching messages during launch in iOS
• Fixed Intermittent Crash in restUser API in iOS
• Fixed multi-select bottom sheet reset count and display incorrect value in iOS
• Fixed Scroll not visible and keyboard not dismissing in iOS
• Start rating in consecutive feedback messages not working in iOS
• Fixed issue When bot conversation is assigned to agent the textfield is not displayed in iOS
• Fixed a crash with Coredata in iOS

Bug Fixes

• Fixed an issue with incorrect chat status that may cause the bot to restart during a chat in iOS.

Bug Fixes

• Fixed an issue where the vote button was not displayed on the FAQ screen for non-scrollable pages in Android.
• Fixed an issue where the UI did not respect system insets in Android 15.
• Fixed an issue where the infinite loader appeared when the bot feedback button was accidentally clicked multiple times on the Conversation Detail Screen in Android.
• Fixed an crash during scrolling on the Conversation Detail Screen in Android.
• Fixed an issue where the chat auto-scrolled when carousels were visible in Android.
• Fixed a memory leak in ConversationDetailActivity in Android.
• Fixed an issue with edge-to-edge displays on devices with Android 15.
• Config session variables updated on remote config API calls during account switching in iOS.
• Fix an issue ensuring message content is in the correct order in iOS.
• Fix UI issue when feedback bot message was the last node in iOS.
• Reduced SPM installation dependency size in iOS.
• Fix an alignment issue with HTML list content in messages in iOS
• Fixed an issue where the unread message count was not updating instantly when opening the app in iOS.
• Fixed an issue where pending messages were not fetched when reopening the chat after a period of time in iOS.
• Fixed an issue where welcome messages for custom bots were not displayed on the topic list screen in iOS.
• Fixed an isolated issue where the bot would trigger unexpectedly in the middle of a chat in iOS.
• Added a missing property option for the FCEventButtonSent event sent from the SDK in iOS.

Enhancement

• Added support for flutter sdk 3.29.0
• Upgraded targetSDKVersion to 35 in Android.

Bug Fixes

• Fixed an issue where the chat screen is not scrolling if carousel is present in the screen in Android.
• Fixed UI issue where extra space was added to carousel card with HTML content in iOS.

Enhancement

• Gradle 8.0 support in Android.

Features

• Exposed an FCEventAgentProfileClick event to retrieve agent details upon clicking the agent profile in Android and iOS.
• Added a public API to set and get the agent profile click redirection URI in Android.

Bug Fixes

• Fixed an issue where an extra space appeared in the carousel card of user messages in Android.
• Fixed an issue with carousel card selection in specific scenarios in Android.
• Fixed an issue where the chat failed to scroll to the latest message after multiple carousel items were selected in Android.
• Fixed an issue where the image caption was not removed after sending an image message in Android.
• Fix UI issue where bot nodes configured after feedback bot message were not displayed properly in iOS.
• Fix crash related to footer view when using multiselect buttons and dropdowns on apps built with Xcode 16 for iOS 18 users in iOS.

Features

• Added new SDK public API to dismiss FreshchatSDK screen if currently visible.

Bug Fixes

• Fixed an issue where links without descriptions were not working in the Bot Article flow in Android.
• Fixed an issue where quick actions were not hidden immediately after a conversation was resolved in Android.
• Fixed an issue where anonymous implementations of FreshchatWebListener were getting garbage collected after a locale change in Android.
• Fixed an issue where the country code was not retained in the view in Android.
• Fixed an issue where images captured with the camera were rotated 90 degrees to the left on some devices in Android.
• Fixed an issue where the file name preview was not consistent for images taken via the camera in Android.
• Fixed an issue with hyperlink breakage in Android.
• Fix for notification not working in iOS 18 sandbox environment.
• Fix occasional issues with the reply editor display in the dropdown, carousel and option selections in iOS.
• Fix for quick option selection menu buttons are not hidden after a conversation is resolved in iOS.
• Fix for bot articles flow where links without descriptions are not working in iOS.
• Fix rare crash during resetUser API call in iOS.
• Fix the image with text alignment issue in conversation message in iOS.
• Fix the issue where the “Was this answer helpful?” feedback options (Yes/No) were not displaying at the bottom of the article in iOS.
• Fix where we removed the 256-character limit for setting up the user properties in iOS.
• Fix added support for this year’s new devices in iOS.
• Fix the issue where the reply editor was visible when sending a carousel via the public API. Now, the reply editor will not appear for carousels sent through the public API in iOS.
• Fix an issue where the “Select All” button was not displayed in the multi-select carousel in some edge cases in iOS.

Enhancement

• Removed the character count limitation for setting user properties

Bug fixes

• Fixed orientations of quick reply option for RTL users in iOS.
• Fixed missing underlines in phone numbers within chat messages in iOS.
• Fixed missing separator line between the reply editor and footer branding view in iOS.
• Fixed display of file extension and size on the chat preview screen when the file name is long in iOS.
• Fixed text and image position swapping in chat messages after restoring the user in iOS.
• Optimised message rendering in the chat detail view in iOS.
• Fixed a rare crash linked with keychain storage component in iOS.
• Fixed an occasional crash when searching for support articles in iOS.
• Fixed auto-scrolling not work correctly after selecting carousel and dropdown messages in iOS.
• Fixed an issue for keyboard automatically dismiss after user sent a message in non-bot conversation in iOS.
• Fix for Customer chat history not getting restored above a few messages in Android.
• Fix for FAQ article message is not taking up the screen space and looks squished/Compressed in Android.

Bug fixes

• Fix for Window Manager Bad Token Exception when attaching pictures in Android.
• Fix for issue with custom link handler not working in conversation in Android.
• Fixed the issue where the conversation list was loading for a long time if the token status was expired after reset user in iOS.
• Fixed the ‘Token not processed’ status displayed when the user restored with an invalid token in specific scenarios in iOS.
• Fixed the phone number validation issue where the bot flow did not proceed to the next step when an Arabic phone number was entered in iOS.
• Fixed the issue where after closing a conversation screen, another or the same conversation screen would pop up in iOS.
• Fixed an intermittent crash in React Native when tapping on a user message in iOS.
• Resolved the issue where the keyboard is dismissed after opening the country code view in iOS.
• Fixed issue where chatbot flows were not triggering properly, including instances where users were able to type and send replies initially in iOS.
• Fixed the looping of input messages sent by the user, which was causing issues in the production conversation in iOS.

Enhancement

• Updated SDK to target Android 14 to comply with Google Play Store policies.

Bug fixes

• Fix for bot quick actions display once a conversation is resolved in iOS.
• Added support for html content in carousels and fix for hyperlink redirection in carousel's secorndary button and description content in iOS.
• Fix for chat history restoration issue with pagination in iOS.
• Fix for bot specific variables not updating in bot flows in iOS.
• Fix correct display of search options in the searchable list for Slash command quick actions in iOS.
• Fix security issue where HTML injection is allowed through the chat input field in iOS.
• Fix crash in bot articles feedback option when sent in languages other than English in iOS.
• Fix for the SDK text input field type being set up for OTP autofilling by default in Android.
• Fix for the possibility of HTML injection through the SDK's chat input field in Android.
• Fix for the alignment issue in the categories listing screen in Android.
• Fix for the chat reply window starting with a lowercase letter in Android.
• Fix for the agent response expectation time taking a few seconds to update after a locale change in Android.
• Fix for incorrect Preview messages being shown in Channels list in Android.
• Fix for failing read receipts in conversations in Android.

Enhancement

• Upgraded min SDK to 21 in Android.

Bug fixes

• Fix for the faq search based on the tag filter by category or article in Android.
• Fix for the Crash on updating to SDK v0.10.14(or above) from v0.10.10 (or below) in Android.
• Fix for Search results not filtered by tags in Android.
• Fix for links in Description are not redirected to the respected page in Android.
• Fix for HTML tags not allowing the hyperlinks to redirect to a web-page displayed on carousels in Android.
• Fix for OTP SMS not received for given mobile number while initiating the OTP from the Android SDK in Android.
• Fix for Faq not opening with correct filter tags on initialisation time in Android.
• Fix for Issues with bullet points displaying in Mobile SDK in Android.
• Fix to prevent the bot from looping when the device time is incorrect in Android.
• Fix occasional crashes in the setUser and identifyUser APIs in iOS.
• Fix crash in the JWT restore API when using invalid tokens in iOS.

Enhancement

• Added support for the Middle East data center in iOS.

Bug fixes

• Fix reply editor missing for optional text replies with third-party bot quick selection option message in iOS.
• Fix for articles search with Group or Category filtering in Freshdesk knowledge base in iOS.
• Fix handling of anchor links for FAQ articles in iOS.
• Fix branding view overlapping with the home slider button on iPad devices in iOS.
• Fix for missing device models to track user devices in iOS.
• Fix for bot variables not updating since release 0.10.14 in iOS.
• Fix for missing assets when using an old theme customization file in iOS.
• Fix to block users from messaging in disabled private topics when opened using tags in iOS.

Enhancement

• Added support for the Middle East data center in iOS.

Bug fixes

• Fix to block users from messaging in disabled private topics when opened using tags in iOS.

Features

• Added support for Parallel conversations.

Enhancement

• Updated the minimum supported iOS version to 12.
• We have integrated Apple’s Required Reason API, ensuring compliance with App Store guidelines.
• Added code signing for the SDK to enhance security and mitigate potential risks associated with unverified code.

Bug fixes

• Fix crash in JWT user restore caused by the use of numbers for user referenceID values in iOS.
• Fix incorrect token status when expired tokens were added during the user restoration process for JWT users in iOS.
• Eliminated deprecated code warnings and deprecated code for serialization/deserialization of data in iOS.
• Fix intermittent issue related to user creation occurring without user properties in iOS.
• Fix for the unable to load topic list page due Canvas: trying to draw too large bitmap issue in Android.
• Fix for the issue in navigating to sections in FAQs page in Android.
• Fix for the click on search from virtual keyboard and virtual keyboard is not closing in the FAQs page in Android.

Bug fixes

• Fix for potential ANR during app update in Android.
• Fix for bot not re-triggering after resolving bot conversations in Android.
• Fix for a crash happening while loading conversations in Android.
• Fix for agent name is not updated when any bot conversations are assigned to any agent in Android.
• Fix for Agent first name display issue when bot conversations are assigned to an agent.
• Addressed crashes affecting users running iOS versions prior to 13.
• Fixed compromised visibility of the date picker view in dark mode in iOS.
• Fix display of team member information in chat messages.
• Fix infinite loading issue for users with expired JWT authentication.

Bug fixes

• Fix to enable text input editor when using Freshchat Public APIs to send messages on behalf of an agent/bot in Android.

Features

• Support for multi-select Carousel as a new input type for your customers. Customers will now be able to pick and choose multiple choices that appears as a series of options with a horizontal scroll (carousel) on the screen. The options list can also contain images in Android.

Bug fixes

• Fix for hyper links not scrolling to the desired index in FAQ webview in omni account in Android.
• Fix for HTML code is being displayed in carousels primary & secondary buttons in Android.
• Fix for conversation is not loading for Android Gradle Plugin 8.0 consumers in Android.
• UI fixes for API generated proactive reply suggestions in iOS.
• Fix intermittent delays in updating team member information when a conversation is assigned from the bot flow in iOS

Enhancement

• Improvements in user experience when loading messages in a conversation in Android.

Bug fixes

• Fix for bot variables not being set for resolved conversations in Android.

Bug fixes

• Fix for a crash that occurs during "postback" flow in a bot conversation in Android.

Enhancement

• Handle disabling of reply editor when bot response is pending in Android.

Bug fixes

• Fix file attachment not opening in Android.

Features

• Say hi to bot actions! Certain actions may need to be performed before or after the execution of a response in a bot conversation to complete the process. These changes can be anything in the chat screen, API triggers, pop-up feedbacks or articles, handover to agents, stop/Minimize conversations etc. You will be able to configure this via the bot builder using actions in iOS.
• We are adding support for multi-select as a new input type for your customers. Customers will now be able to pick and choose multiple choices that appears as buttons in Android.

Enhancement

• Handle disabling of reply editor when bot response is pending in iOS.
• Improved displaying of last message in topic list with multiline text in iOS.
• Update UI for single select button in Android.

Bug fixes

• Fix sporadic crash while setting user properties in iOS
• Fix triggering bot flow messages even when bot is unpublished in iOS.

Features

• Support for multi-select Carousel as a new input type for your customers. Customers will now be able to pick and choose multiple choices that appears as a series of options with a horizontal scroll (carousel) on the screen. The options list can also contain images in iOS.
• Support for Phone number and OTP as a new input type for your customers. Customers will now be able to enter their phone numbers with country code to generate an OTP which is then entered by user and is accepted by the SDK to process user information.
• You will now be able to pass custom user properties related to a user conversation from the mobile app to the bots via the SDK in Android.
• We are adding support for multi-select as a new input type for your customers. Customers will now be able to pick and choose multiple choices that appears as list and dropdown.
• We are adding support for Date and time as a new input type for your customers. Customers will now be able to pick a date and pick a time within the bot flow.
• Update UI for single select button and dropdown options.
• This version will now let you receive feedback from your customers in the form of a text. Customers will be able to type their feedback if configured in the bot flow in Android.
• This version will now let you receive feedback from your customers in the form of a preset choices. Customers will be able to choose their feedback from a maximum 3 choices in Android.
• This version will now let you receive feedback from your customers in the form of a star. Customers will be able to select the rating feedback if configured in the bot flow in Android.

Bug Fixes :

• Fix for notifications not coming when an old user is restored over existing user in iOS.

Bug fixes

• Fix for app version not updating in device properties section (iOS)
• Fix profile image flickering for bot or agent message in chat (iOS)
• Fix for localization with country value (iOS)
• Fix display of CSAT title with theme color (iOS)
• Fix spaces in multiline bot messages with paragraph tag.

Feature

• Placeholder support for bot messages

Enhancements

• Display links configured for bot articles
• Improve conversation fetch when user comes to chat without notification click (iOS)
• Update invalid initialization experience with alert message (iOS)

Bug fixes

• Fix for displaying blank topic name in topic list screen (Android)
• Fix for multiple selection of quick reply buttons (Android)
• Fix for HTML tags not supported in carousel title and subtitle (Android)
• Fix for multiple selection of Dropdown options (Android)
• Fix for bot not being triggered when user responds to CSAT (Android)
• Fix for locale change not being reflected in topics screen (Android)
• Fix to show bot flow message instead of unsupported format error message (iOS)
• Fix to show HTML entities instead of entity names (iOS)
• Fix to allow attachments in the first message while talking to an agent. (iOS)
• Fix CFBundleSupportedPlatforms issue while submitting app to store (iOS)

Feature

• This version lets you receive star rate feedback from users during bot interactions (iOS)

Bug fixes

• Fix to initiate bot for resolved conversations when chat screen opens (Android)
• Fix for send button being enabled when only empty spaces are entered (Android)
• Fix for extra space being displayed below multiline bot messages (Android)
• Fix for a crash which occurs while attaching images (Android)
• Fix for updating user details along with user creation (iOS)
• Fix to stop auto scrolling of Carousel cards to initial card (iOS)
• Fix for overlapping new message indicator with reply editor (iOS)
• Fix to allow sending attachment only when bot requests an attachment (iOS)
• Fix for localisation of FAQ search bar cancel text (iOS)
• Fix to stop FAQ content from shaking while scrolling with less content (iOS)

Bug fix

• Fix for FAQ configurations not working when no tags are provided.

Enhancement

• Changes to support Push notifications with P8 certification (iOS)

Bug fix

• Fix for agent/bot message timestamp aligning to the right end of the message bubble (Android)

Feature

• This version lets you receive feedback (opinion polls & comments) from users during bot interactions (iOS)

Enhancements

• Updated targetSdkVersion to Android 12 (Android)
• Minor UI changes and improvements to accomodate for ios devices and versions (iOS)

Bug fixes

• Fix for Quick Action Pre-defined buttons (iOS)
• Fix impacting CSAT users for RTL users (iOS)
• Fix for the next bot flow to trigger on selecting carousel (Android)
• Fix for clearing error message for invalid input in bot flow (Android)
• Fix for handling empty messages (Android)
• Fix for handling quick actions menu overlapping in landscape mode (Android)
• Fix for custom attachment icons appearing too large in v0.9.9 (Android)

Features

• Bot will now be able to validate text in Mobile number, Email-ID and Number input types from customer in the conversation.
• Customer can upload file for bot flows and attachment option.

Bug fixes

• Better handling of HTML content in messages (iOS)
• Allow encoded strings with quick actions and replies in messages (iOS)

Feature

• Support for read-only and single select carousel in bots flow (iOS)
• Support for quick options in bot flow

Enhancements

• New device models added to track user devices (iOS)
• Redesign of "Powered by Freshworks" banner

Bug fixes

• Theme fix for CSAT prompt (iOS)
• Display missing suggested article(s) in initial bot flow (iOS)
• Incorrect display of messages in a botflow (iOS)
• CFBundleExecutable error while uploading to AppStore (iOS)
• Display timestamp value for bot messages (iOS)
• Support for <li>,<ol> and <ul> html tags in messages (iOS)
• Update custom response expectation message with locale change (iOS)
• Add TOKEN_NOT_PROCESSED state for JWT auth users (iOS)
• Fix for ConnectivityManager leak (Android)

Enhancements

• Support for Dynamic Framework (iOS)

Bug fixes

• Fixed unread message count listener (iOS)
• Package update for SPM (iOS)
• Fixed notification not being shown in the notification tray, when the app is in the background (Android)
• Fixed an issue with restoring a user using JWT (Android)
• Fixed an issue with sending APNS device token to Freshchat from Flutter
• Fixed an issue with toast message appearing when launching FAQs with options (Android)

Bug fixes

• Fix for dismissing keyboard when moving from Chat screen to App screen (Android)
• Fix for handing empty CSAT (Android)
• Fix FAQ article title override in search flow (iOS)
• Unread count overlap for topic list (iOS)
• Black navigation bar appearance on navigating via push notification (iOS)
• Rare invalid domain prompt during sdk initialization (iOS)
• Quick replies options support only for last message in a conversation (iOS)
• Sporadic crash while opening a chat when translation enabled (iOS)
• Crash on showFaq when either title or tags are null (iOS)
• Minor bug fixes (iOS)

Enhancement

• Ability to intercept notification clicks in Android
• Ability to listen to user interactions

Bug fix

• Fix for displaying notifications in Android 12

Enhancement

• Optimise user create flow (iOS)

Bug fix

• Fix for Topic name and image being empty

Enhancements

• Display complete name for messages created using API
• Support for fetching unread count for a specific channel using tags
• Resources path update and minor changes for other framework bundle (iOS)

Bug Fix

• FAQ contactUs tags filter (iOS)

Bug Fix

• Fix CFBundleSupportedPlatforms issue while submitting app to store.

Bug Fix

• Fixed showConversations() crash in iOS

Enhancements

• Introducing self-service via bots on the SDK. Bots built using the Unified Bot Builder will now be accessible on the SDK too. Learn more about the capability here.
• Toggle in init method for show/hide notification banner when app is in foreground - iOS

Bug Fix

• Fixed getUser() crash in iOS

Enhancements

• Added support for null safety
• Upgraded Freshchat iOS SDK version to 4.2.0

Enhancements

• Upgraded Freshchat Android SDK version to 4.3.5
• Upgraded Freshchat iOS SDK version to 4.1.8

Breaking Change

• Changed getUserAlias method name to getFreshchatUserId

Bug Fix

• Fixed "Stream has already been listened to" error

Enhancements

• Android - Open Freshchat deeplink
• Android - Register for webview listener
• Android - Linkify for custom patterns
• Android - Runtime locale change support
• iOS - Config to enable/disable logging

Bug Fix

• iOS - Made changes to support transitive dependencies

Enhancements

• Upgraded Freshchat Android SDK version to 4.3.3
• Upgraded Freshchat iOS SDK version to 4.1.6

Bug Fix

• Handled null parameters in FreshchatUser object

• Added missing changelogs

Enhancements

• iOS Theme specific config
• iOS localisation specific config

Enhancements

• Added external link handler
• Added unread message count change listener

• Initial beta release of the Freshchat flutter SDK