Skip to content

Latest commit

 

History

History
1875 lines (1340 loc) · 85.1 KB

CHANGELOG.md

File metadata and controls

1875 lines (1340 loc) · 85.1 KB
Raw

Changelog

15.11.4

Release Date: 17-12-2024

🐛 Bug Fixes

  • Resolves an issue with Fin streaming replies.

👉 Dependency updates

  • Compose BOM: Updated to 2024.12.01
  • AndroidX Paging: Updated to 3.3.5

👉 Note

  • This release contains some beta features.

15.11.3

Release Date: 11-12-2024

🐛 Bug Fixes

  • Fixed the bug where users were unable to add a phone number in the attribute collector
  • Fixed a crash caused by IllegalArgumentException: y must be < bitmap.height()

👉 Dependency updates

  • Compose BOM: Updated to 2024.11.00
  • AndroidX ConstraintLayout: Updated to 2.2.0

👉 Note

  • This release contains some beta features.

15.11.2

Release Date: 22-11-2024

🐛 Bug Fixes

  • Prevented ProGuard from removing critical classes during build time
  • Resolved issues with downloading images in the app
  • Bumped androidx.compose:compose-bom from 2024.10.00 to 2024.10.01.
  • Bumped androidx.compose.animation:animation-graphics-android from 1.6.8 to 1.7.5.

15.11.1

Release Date: 08-11-2024

🐛 Bug Fixes

  • Fixed an issue causing conflicts when the host application integrates with Sentry
  • Addressed a MalformedURLException that occurred during file downloads
  • Fixed crash IllegalArgumentException: Cannot have an empty start destination route
  • Fixed a bug where the device's language settings would override Messenger default language settings

15.11.0

Release Date: 31-10-2024

📱 New Features

  • Added the ability to upload files to a conversation

🚀 Enhancements

  • Added new API isUserLoggedIn. This enables developers to determine if a user is currently logged in to Intercom.
  • Added new API fetchLoggedInUserAttributes. This enables developers to retrieve the details of the currently logged in user.

🐛 Bug Fixes

  • Fixed some small UI bugs
  • Fixed a crash with the following stacktrace:
at dalvik.system.VMStack.getThreadStackTrace(VMStack.java)
at java.lang.Thread.getStackTrace(Thread.java:1736)
at d00.d.e0
at d00.d.v
at io.intercom.android.sdk.m5.errorReporter.SentryErrorReporter.trackActiveUser

15.10.3

Release Date: 18-09-2024
  • Bug fixes and performance improvements
  • Bumped the Compose BOM to 2024.09.00

15.10.2

Release Date: 23-08-2024

🐛 Bug Fixes

  • Fixed an issue where image and gif preview's send and close button were missing in Android 15
  • Updated androidx.media3:media3-exoplayer from 1.3.1 to 1.4.0.

15.10.1

Release Date: 30-07-2024

🐛 Bug Fixes

  • Fixed attaching photos and videos from gallery
  • Fixed IndexOutOfBoundsException crash
  • Fixed IllegalArgumentException crash caused by non-negative bottom padding

👉 Dependency updates

  • Coil: Updated from 2.6.0 to 2.7.0
  • MP4 Parser: Migrated from com.googlecode.mp4parser:isoparser to org.mp4parser:isoparser

15.10.0

Release Date: 18-07-2024

🚀 Enhancements

  • A newly designed composer for the messenger.

🐛 Bug Fixes

  • Fixes an issue with text fields in surveys.
  • Fixed issue allowing customers to start a conversation after reacting to an article.
  • Fixes an issue to handle empty message parts for bot introductions.

👉 Note

  • This release contains some beta features.

15.9.1

Release Date: 14-06-2024

🐛 Bug Fixes

  • Fixed the issue where push open stats weren’t tracked correctly.
  • Fixed the issue where deep links in push message doesn’t work for React Native.
  • Attribute collectors are now disabled now if the conversation is closed.

👉 Dependency updates

  • Kotlin Coroutines: Updated from version 1.8.0 to 1.8.1
  • AndroidX Paging: Updated from version 3.2.1 to 3.3.0
  • Lifecycle: Updated from version 2.6.2 to 2.8.1
  • Gson: Updated from 2.10.1 to 2.11.0

15.9.0

Release Date: 16-05-2024

🐛 Bug Fixes

  • Fixed attaching photos from camera.

👉 Note

  • This release contains some beta features.

15.8.3

Release Date: 25-04-2024

🐛 Bug Fixes

  • Fixed issue where end users are able to click the same reply button multiple times in a workflow.
  • Handled caching of Push Notification FF.

15.8.2

Release Date: 18-04-2024

🐛 Bug Fixes

  • Added better error messages for login failures.
  • Fixed bugs around Push Notifications.

15.8.1

Release Date: 11-04-2024
  • Fixed the issue with overlapped headings in the Messenger
  • Fixed the issue where the Android SDK doesn't track unengaged bot workflow correctly
  • Bumped the Compose BOM to 2024.04.00

15.8.0

Release Date: 08-04-2024
  • UI improvements in the Messenger

🐛 Bug Fixes

  • Smoothened the animations and fixed jankiness in the Messenger
  • Fixed upload size limit error when uploading images

15.7.1

Release Date: 20-03-2024
  • Added video and image compression

15.7.0

Release Date: 08-03-2024

📱 New Feature

  • Messenger now supports voice to text input

⚡️ We’ve now added support for the new FCM HTTP v1 API migration for push notifications. You can follow the migration guide here.

👉 This update also reduces the size Intercom SDK adds to apps by around 1.3 MB

15.6.4

Release Date: 06-03-2024

🐛 Bug Fixes

  • RTL improvements on the loading screen
  • Fixed an issue with push notifications with attachment not working correctly on Android 14
  • Fixed issue with message composer when dealing with large messages

👉 Dependency updates

  • Kotlin Coroutines: Updated from version 1.6.4 to 1.8.0
  • Compose Accompanist: Updated from 0.30.1 to 0.34.0
  • Compose: Bumped the Compose BOM from 2024.02.00 to 2024.02.01
  • Coil: Updated the image loading library from version 2.3.0 to 2.6.0

15.6.3

Release Date: 21-02-2024
  • Added support for custom ticket states external labelling
  • It is now possible to configure whether users are able to start a new conversation when they tap the 😔 reaction on an Article

🐛 Bug Fixes

  • Fixed NoSuchMethodError crash caused by Jetpack Compose 1.6 compatibility issue
  • Fixed NoSuchFieldError crash occurring on API < 24

15.6.2

Release Date: 2-02-2024
  • Bumped Jetpack Compose version to 1.6

🐛 Bug Fixes

  • Added missing translations
  • Fixed janky performance on programmatically launched conversation screen

15.6.1

Release Date: 29-01-2024

📱 New Features

  • End users can now take videos from the camera in the Messenger
  • Added the ability to save images from the conversation

🐛 Bug Fixes

  • Fixed the crash while taking a photo from the camera

15.6.0

Release Date: 4-01-2024

📱 New Features

  • Added camera input type
  • Added a button to open previous messages in programmatically launched conversations

🐛 Bug Fixes

  • Fixed a crash where Instant class was not found on pre API level 26 devices

👉 This update also removes Lottie as a dependency to the Intercom SDK

15.5.1

Release Date: 1-12-2023

🚀 Enhancements

  • SDK now depends on Media3 instead of Exoplayer

🐛 Bug fixes

  • Fixed a missing Hebrew translation in tickets
  • Fixed issue with quick reply
  • Fixed issue where logging in with same user twice triggers the error callback

15.5.0

Release Date: 15-11-2023

🚀 Enhancements

  • Ticket details can now be launched programatically
  • Bot speed improvements

🐛 Bug fixes

  • Added a missing Hebrew translation
  • Fixed an issue where message content was shown in the composer after it was sent

15.4.0

Release Date: 19-10-2023

🚀 Enhancements

  • Intercom SDK now targets Android 14 (API level 34).

📱 New Feature: Fin is now streaming AI answers! This means customers don't have to wait for the whole AI answer to generate before getting the support they need. Instead, Fin starts displaying a response the moment the first word comes in.

🐛 Bug Fixes

  • Fixed issue where anchor links articles didn't scroll to the right sections of the article

15.3.0

Release Date: 10-10-2023

image 📱 New feature: Set better expectations with your customers by customising the Start Conversation button in your Messenger

👋 With this release, you can select from a list of options to customize the Start Conversation button in the Messenger. This can be changed in Messenger settings under the "Conversations" section and will affect the Start Conversation button on Messenger Home and in spaces Iike Messages and Help

🚀 Enhancements

  • Links to create tickets can now be added as a home screen card

🐛 Bug Fixes

  • Disables inserting webp images in conversations

15.2.3

Release Date: 29-09-2023
  • Fixed date and time picker issue.
  • This version requires compileSdkVersion to be at least 34. If you are not ready to use API level 34, please stay on the Intercom version 15.2.0.

15.2.2

Release Date: 22-09-2023
  • Fixed crash due to concurrent modification exception.
  • Fixed issue with device token removal after user identity reset.
  • Fixed crash related to locale settings on older OS versions.
  • This version requires compileSdkVersion to be at least 34. If you are not ready to use API level 34, please stay on the Intercom version 15.2.0.

15.2.1

Release Date: 07-09-2023
  • Bumped Jetpack Compose version to 1.5.
  • This version requires compileSdkVersion to be at least 34. If you are not ready to use API level 34, please stay on the previous version of Intercom.

15.2.0

Release Date: 30-08-2023

📱 New Feature : Tickets Space in Messenger

👋 Introducing the new tickets space in Messenger. Enabling the ticket space lets end users submit, view, and get updates on all of their tickets from one centralized place in the Messenger.

🐛 Bug Fixes

  • Fixes crash due to notification bubbles on older Android versions.
  • Fixes NullPointerException that might have occurred when sending a message.
  • Fixes Manifest merger failed error when using a FileProvider.
  • Enable editing on Attribute Collectors if the value already exists.

15.1.6

Release Date: 11-08-2023
  • Bug fixes
    • Fix crash when composer is opened with a initial message containing \n
    • Fix bug where home screen did not update when a new conversation is opened or a reply is received
  • Clean up unused dependencies
  • Bump dependency versions

15.1.5

Release Date: 31-07-2023
  • New API to programmatically open a conversation with ID
  • New ability to interact with conversations through bubbles in devices running Android 11+

Bug fixes

  • Fixes issue with push not sending because of invalid device tokens

15.1.4

Release Date: 17-07-2023
  • Chat based notification are treated as “Conversation” from Android 12+
  • Added Inline reply and smart suggestions to chat notification
  • Bug fixes

15.1.3

Release Date: 07-07-2023
  • Replaced “Ask our a bot question” with “Ask a question”

15.1.2

Release Date: 27-06-2023
  • Intercom now supports Hindi and Swahili as languages in the Messenger.
  • Fixed an issue that forced dark theme on devices running MIUI

15.1.1

Release Date: 19-06-2023
  • Fixed an issue that causes image upload to fail when Identity Verification is turned on.

15.1.0

Release Date: 29-05-2023
  • Improvements to the core conversation screen user experience, better RTL support, bug fixes and performance improvements.

15.0.0

Release Date: 09-05-2023

Meet Fin 👋 a breakthrough AI bot powered by GPT-4, OpenAI's most advanced AI model. Fin solves complex problems and provides safer, more accurate answers than any AI bot on the market.
Home Fin-Intro Fin-Answer

Fin...

  • Holds complete support conversations in plain English, powered by GPT-4 and Intercom’s proprietary ML technology.
  • Requires zero setup. Just point it at your help center and turn it on.
  • Provides trustworthy, accurate answers based on your existing support content.
  • Seamlessly passes more complex questions directly to your human support team.

Learn more 👉 www.intercom.com/fin

Bug Fixes

  • Intercom SDK now uses Jetpack Compose v1.4.2

14.2.0

Release Date: 03-04-2023

Help Center Enhancements to Support Multilevel Collections

  • Help Center home screen and collections screen have been redesigned to support navigating through collections and nested collections up to 3 level deep
  • The Intercom.client.fetchCollection API response body now includes a list of collections within the collection response body. sections will be deprecated in the next major release.

🐛 Bug Fixes

  • Fixed an issue that caused a crash when opening the Help Centre
  • Fixed a crash with displaying full chat notifications
  • Fixed the issue where it reloads the app after viewing in-app notifications

14.1.0

Release Date: 13-03-2023

Enhancements: Attach Files to Tickets

  • End users can now upload files when submitting Tickets in the Messenger

👉 Upgrade to the latest version of the mobile SDK today to use the feature on mobile.

14.0.6

Release Date: 02-03-2023
  • Fixed an issue where messenger crashes when a conversation with an attribute collector is loaded.

14.0.5

Release Date: 10-02-2023
  • Fixed an issue that caused a Survey to be triggered twice
  • Fixed an issue that caused a crash when opening in-app notifications
  • Updated dependencies to newer versions:
    • Updated Compose to 1.3.3
    • Updated AppCompat to 1.6.1

14.0.4

Release Date: 19-12-2022
  • Added support for Bengali, Persian, Malay and Thai
  • Fixed the issue where quick replies re-open closed conversations with composer disabled
  • Fixed the crash with missing drawable resources
  • Fixed the crash when sending an image
  • Fixed the issue with uploading image from Typeform app
  • Fixed the bug where attachments disappearing in conversation view

14.0.3

Release Date: 28-11-2022

🐛 Bug Fixes

  • Made some UI improvements.
  • Minor bug fixes

14.0.2

Release Date: 22-11-2022

🐛 Bug Fixes

  • Made some UI improvements.
  • Minor bug fixes

14.0.1

Release Date: 16-11-2022

🐛 Bug Fixes

  • Made some UI improvements.

🚀 Enhancements

  • Added the ability to automatically show a Survey when it is set live.

14.0.0

Release Date: 04-11-2022

🚀 Enhancements

In v14.0.0 of the Intercom mobile SDK!! Say hello to the most customizable Messenger. Ever. 👋

📱 New feature: Messenger

👋🏼 Introducing the fully customizable Messenger that provides customers with in-context engagement throughout their journey.

  • Customization Now you can update and style your Messenger just the way you want it and enable a consistent brand experience with a fully customizable Messenger. Learn more and get started here.

Image

  • Spaces You’ll have increased product flexibility and versatility with Messenger ‘spaces’ that provide intuitive navigation for your customers. Let’s go through each of the 3 new spaces you can add to your Messenger.

  • Home Space A redesigned Home screen that’s highly configurable and supports multiple use cases with new capabilities.

  • Messages Space Messages is a dedicated space for conversation management. Both inbound and outbound conversations and conversations which contain tickets will live here.

  • Help Space Enable customers to better self-serve with a more intuitive and personalized support experience. Customers can access a full, in-context help center from anywhere in your product with the dedicated Help Space.

📱 New feature: Tickets

Go beyond simple live chat – handle complex customer requests asynchronously.

  • As you scale, so does your conversation volume and not every customer request can be handled in a live chat. That’s where tickets come in.
  • Let customers submit tickets directly from your app for async resolution

Learn more about Intercom Messenger

Learn more about Intercom Tickets

👉 Upgrade to the latest version of the mobile SDK today to use the feature on mobile.

As this is a major update, there are few API changes which are listed below:

Method Description
fun present(space: IntercomSpace) Open a specific space in intercom. (Home, Messages, HelpCenter)
fun present() Open Intercom - defaults to the Home space
fun presentContent(content: IntercomContent) Present Intercom content. Valid content types are Article, Carousel, HelpCenter Collections

You can find more information about migrating to v14.0.0 here

12.5.3

Release Date: 17-10-2022
  • Added support for Android 13 gallery permission
  • Fixed a bug when sending metrics

12.5.2

Release Date: 11-10-2022
  • Added support for Android 13 gallery permission

12.5.1

Release Date: 12-09-2022
  • Bumped Android Compose version to 1.2.1

12.5.0

Release Date: 19-8-2022
  • Added support for Android 13

12.4.3

Release Date: 28-7-2022
  • Fixed a bug where the background colour was using default theme colour in Surveys
  • Fixed issue where the content overlaps the header in launcher.

12.4.2

Release Date: 22-6-2022
  • Fixed a bug that showed the wrong labels under Numeric scale questions in Surveys
  • Fixed crash caused due to bad JSON
  • Fixed bug that prevented push notification body from expanding

12.4.1

Release Date: 01-6-2022
  • Fixed an issue where server region did not default to US when no meta-data was provided in the manifest

12.4.0

Release Date: 27-5-2022
  • You can now customize submit button text for surveys sent on your mobile app

12.3.0

Release Date: 17-5-2022

📱 New Feature : Rich Push Messages 🖼️
A picture speaks a thousand words. You can now add rich media (i.e. images) to your mobile push messages. Grab your user’s attention by adding attractive and contextual images and increase click-through rate of your push message. 👉 Upgrade to the latest version of the mobile SDK today to use this feature. Additionally, to set rich push messages on iOS, follow the instructions here.

teammate-rich-push

PHOTO-2022-05-17-12-42-30

12.2.3

Release Date: 17-5-2022
  • Fixed issue in help center where it did not obey the setting to have at most one open conversation.
  • Fixed issues with status bar height on Android 12.
  • Fixed issue with truncating expected time on the home screen.
  • Improved performance of push notifications
  • Intercom now uses Coil 2.0

12.2.2

Release Date: 5-5-2022

Minor bug fixes

12.2.1

Release Date: 26-4-2022

Minor bug fixes

12.2.0

Release Date: 26-4-2022
  • New feature: You can now open a Survey programmatically in your app. We have added a new method to our API to enable this, displaySurvey.

12.1.1

Release Date: 8-4-2022
  • Fixed an issue where push notification was not opening the app when tapped on latest Android OS versions

12.1.0

Release Date: 31-3-2022

🚀 Enhancements

  • We've renamed some of our API methods. The term register has been replaced with login. As part of this change, we've also added success and failure callbacks to the updated login methods.

    This means that the following old register methods are now deprecated

    • registerUnidentifiedUser()
    • registerIdentifiedUser(registration)
    • updateUser(userAttributes)

    We've replaced them with

    • loginUnidentifiedUser(statusCallback)
    • loginIdentifiedUser(registration, statusCallback)
    • updateUser(userAttributes, statusCallback)

  • Added support to connect to Intercom workspaces that are hosted on servers in our Australian region

NOTE

  • The status callbacks are optional when invoking these methods using Kotlin as they already have a default implementation. We recommend calling these APIs using named parameters.
  • The underlaying functionality behind these new methods remains the same as the deprecated ones, but now you can take optionally action on success or failure.
  • These deprecated methods will still work, but will be removed in a future release. See our developer docs and our sample apps for further details on these API changes.

Check out release v12.0.0 for details about Intercom's great new Surveys feature

Version 12.0.0

23-03-2022

In v12.0.0 of the Intercom mobile SDK, we’re introducing Intercom Surveys — beautiful native in-product surveys to bring all your customer communication to one platform!!

Intercom Surveys Introduction

📱 New feature: Intercom Surveys

👋🏼 Meet Intercom Surveys - Don’t just ask their opinion, act on it. Now, you can seamlessly capture and act on customer feedback and needs, all within Intercom. Intercom Surveys makes it quick and easy to create and send highly targeted, easily customisable in-product native survey - across web and mobile.

  • Choose the relevant question type from multitude of question types available like rating scales (NPS, emoji, star), multiple-choice, dropdown and more
  • Customise the colour of your survey’s background and buttons
  • Target the right survey to the right audience at the right time
  • Save survey responses as user attributes to drive follow up actions
  • Add a customisable intro and thank you message
  • Decide whether or not users should be able to dismiss the survey
  • Encourage further user actions by inserting a call-to-action button in the thank you message with a link (external URL or deep link)
  • Leverage email and mobile push as fallback channels if in-product doesn’t get you a response
  • Many more ways to customise your survey — show or hide avatar of survey sender, format survey text and insert user or company attributes in text
  • Use the power of Intercom platform — A/B testing and control groups, goal tracking, orchestrating surveys as a part of series, analysing and exporting results as CSV
surveys gif 1 surveys gif 2

👉 You will need to start a 14 day free trial or purchase the Surveys Add-On starting from $49 per month in order to set a survey live 👉 Upgrade to the latest version of the mobile SDK today to use the feature on mobile. No additional integration work required.

Learn more about Intercom Surveys

Intercom_Surveys_Hype_Final.mp4
0110_Surveys-ProductFeedback-Engage-1x1_0322.mp4

Version 10.7.0

04-03-2022

🚀 Enhancements

  • We've added Suggested Articles to your Homescreen! Provide a better self-serve experience to your users by enabling them to answer their question before they reach out to a teammate.

Version 10.6.1

18-01-2022

  • Fixed issue where app freezes when push notification is received.

Version 10.6.0

16-12-2021

  • Introduced new messenger settings which will prevent the same user/visitor from having more than 1 open inbound conversation at any given time.

Version 10.5.0

24-11-2021

  • Improvements to Articles in search, and ability to start conversations beyond home screen
  • Improvements for RTL (Right to Left languages) on the homescreen
  • Fixed the issue where reactions don’t show up in Posts
  • Added Jetpack Compose dependencies

Version 10.4.2

04-11-2021

  • Added the ability to upload a video to a conversation
  • Fixed an issue with push notifications on Android 12
  • Improved accuracy of inbound custom bot triggering (particularly ones using time based predicates)

Version 10.4.1

02-11-2021

  • Fixed an issue where the homescreen was not close-able after accessibility changes

Version 10.4.0

29-10-2021

  • A number of improvements for accessibility features in the Messenger, with more coming in future updates.

Version 10.3.0

13-10-2021

  • Added Android 12 support.

Version 10.2.0

22-09-2021

Reduce customer inquiries for your team and provide faster resolutions for your customers – without sacrificing a great experience. We’ve redesigned our Messenger with an integrated help center experience that increases customer engagement by up to 3x to help you deliver the best self-serve support.

New features in this update:

  • A new article search card on your Messenger’s home screen.
  • There are now two conversation cards, just as with our web Messenger; one for existing and one for new conversations. This gives more emphasis to existing conversations, reducing the chance of duplicates being created.
  • Optionally require specific customers to attempt to self-serve to answer their question before they can reach out to a teammate.
  • Place the article search card at the top of the Messenger home screen to give your self-serve content more prominence.
  • Uncover insights and opportunities to optimize your self-serve support by using our updated Articles reporting.
  • If you’ve set a custom icon for the Intercom launcher, that icon will now be used in your app as well.

Version 10.1.1

26-08-2021

  • Removed the deprecated package intercom-sdk-base-transitive from v10.1.1 onwards. If you are still using intercom-sdk-base-transitive, please update to use intercom-sdk-base instead.

Version 10.1.0

20-08-2021

  • If you’re enrolled in our Messenger early access programme, this upgrade will display the newly designed article search card on the Messenger home screen. This change won’t affect you if your workspace doesn’t have early access to these features.
  • Fixed an issue where hyperlinked images in Mobile Carousels did not open the URL when tapped.

Version 10.0.2

16-07-2021

  • Fixed an issue where article viewed stats were not updating correctly.
  • Updated dependencies to newer versions.

Version 10.0.1

23-06-2021

  • Fixed a couple of bugs and made some performance improvements

Version 10.0.0

16-06-2021

Enhancements

  • We have redesigned the Help Center for mobile apps. ✨
  • New UI, optimized specifically for mobile apps and small screens
  • Type-ahead search to help users find answers quicker than ever
  • Control whether users open up a specific collection of articles, a group of collections, or specific search results
  • Localization - with right to left language display
  • Accessibility support: screen readers, dynamic font sizes, and keyboard navigation - to support all end users
  • New Help Center Data API that enables you to build your own help center UI, enabling a much deeper and custom integration into your app. Help center

Improvements and bug fixes

  • Fixed an issue where the special notice message would not display.
  • hideMessenger() has now been deprecated and removed. Please use hideIntercom() instead. This method will hide all Intercom UI in your app.

Version 9.2.0

26-05-2021

Version 9.1.2

26-04-2021

  • Bug fixes and performance improvements

Version 9.1.1

12-03-2021

  • Fixed the issue of unable to search for Gifs on Android 11
  • Fixed an issue with escaped HTML on buttons

Version 9.1.0

27-01-2021

  • Added support for bot intros, which allows Resolution Bot to introduce itself when your customers start a new conversation, making it clearer that they’re interacting with a bot.
  • Added support for looping bots, which allows Resolution Bot to answer multiple questions in a conversation.
  • Both features can be enabled in Operator settings in Intercom.

Version 9.0.3

19-01-2021

  • Added the ability to hide the New Conversation button in a bot-only conversation.

Version 9.0.2

11-01-2021

  • Fixed a couple of bugs and made some performance improvements

Version 9.0.1

05-01-2021

  • Fixed: An issue where the Inbound Bot doesn’t trigger for new conversations
  • Fixed the homescreen formatting issue on Android tablets and removed split view

Version 9.0.0

04-12-2020

  • Support for Android X : Added support for Android X without needing Jetifier
  • Intercom now depends on Glide 4.11.0, Gson 2.8.6, Otto 1.3.8, Okio 2.8.0, Okhttp 4.9.0 and Retrofit 2.9.0
  • Better RTL support : Improved support for RTL layouts

Version 8.3.0

10-11-2020

  • New feature: You can now open an article or Mobile Carousel programmatically in your app. We have added two new methods to our API to enable this, displayArticle and displayCarousel.

  • Improvement: Added an optional special notice message, that can be displayed at the top of a conversation. This has been commonly used to set expectations during COVID, find more details here. Special notice message

  • Fixed: An issue where the links would not open inside conversations on Android 11.

  • Fixed: An issue where we would display the wrong timezone in the conversation header.

Version 8.2.0

17-09-2020

  • We have rolled back Okio to version 1.17.4. We had previously upgraded to version 2.7.0 which caused conflicts for customers using okio/okhttp. If you are using version 8.0.0 or 8.1.0 and have encountered this issue you will need to update to a newer Intercom SDK version.

Version 8.1.0

09-09-2020

  • The SDK has been updated to support Android 11

Version 8.0.1

01-09-2020

  • Minor bug fixes and compatibility updates for future releases.

Version 8.0.0

25-08-2020

  • We've updated the version of third party dependencies such as Firebase Messaging, AndroidX, and internal repackaged libraries
  • We've added Kotlin as part of updating to the newest version of OkHttp
  • We've updated the minimum Java requirement to Java 8+ as part of updating to the newest version of OkHttp

Version 7.2.0

17-07-2020

  • The Android SDK now uses Android X.
  • We’ve updated the Gson and Firebase Messaging libraries that the SDK uses.
  • We recommend migrating to Android X to use this version of the Android SDK.

Version 7.1.2

13-07-2020

  • Bug fixes and performance improvements.

Version 7.1.1

07-07-2020

  • Fixed an issue where buttons on the Messenger conversation card were not fully visible on small devices.
  • Fixed an issue where the conversation header wasn't updates after a teammate reply.

Version 7.1.0

17-06-2020 In v7.1.0 of the Intercom mobile SDK, we’re introducing a fantastic new mobile engagement feature called Mobile Carousels. We’ve also added support for closed conversations, as well as a number of fixes and performance improvements.

📱 New Feature: Mobile Carousels

Bring your best features. We'll bring the spotlight. Use Mobile Carousels to connect with app users at every touchpoint—show them around, provide support, and highlight features you know they'll love.

Mobile Carousels are a multi-screen message designed to feel right at home in your mobile app.

  • Rich multi-screen messages.
  • Highly customizable, right inside Intercom.
  • Request device permissions like push notifications, camera, location and more.
  • Deep link into your app, open URLs, or start conversations in the Intercom Messenger.
  • Target the right message to the right audience.
  • A/B testing and control groups.
  • Goal tracking.
  • Schedule your Mobile Carousel with ease.

Upgrade to the latest version of the mobile SDK today to use the feature. No additional integration work required.

Learn more about Mobile Carousels

Carousel - Made for mobile - Red

anrdroid_standard

Carousel - Permissions - Android - Yellow

📱 Closed Conversations

The mobile SDK now respects the prevent replies to closed conversations setting if you have it enabled. The text composer will be disabled for closed conversations, and your users will be able to start a new conversation if they need to. The UI updates in real time as the conversation takes place.

closed convo android

📱 Improvements and bug fixes

We made a number of performance improvements and squashed a number of bugs in this release. This includes:

  • Improved: The mobile SDK and its features now initialize and open more quickly.
  • Improved: More elegant image loading states.
  • Fixed: An issue where the composer occasionally failed to respect the ‘disable composer for inbound bots’ setting.
  • Fixed: A crash associated with certain colour customization settings.
  • Fixed: A java.lang.OutOfMemoryError crash.
  • Fixed: A ReactionInputView.highlightSelectedReaction > IndexOutOfBoundsException crash.
  • Fixed: An issue where file extensions were sometimes removed when uploading them.
  • Fixed: An issue where emoji reactions were sometimes rendered twice.
  • Fixed: An issue with overlapping text in the ‘Your conversations’ list in the Messenger home.
  • Fixed: An issue where an outbound message didn’t appear in real-time after changing the device orientation.
  • Fixed: An issue where custom bot failed to save custom attributes
  • Fixed: A crash with error java.lang.ArithmeticException divide by zero
  • Removed: The experimental API is no longer available.

Version 6.1.0

18-03-2020

Enhancements

Version 6.0.1

10-01-2020

  • Performance improvements

Version 6.0.0

24-10-2019

  • Android API level 21 (v5 - Lollipop) is now the minimum version of Android that is supported by the Intercom Android SDK.
  • If your app still support API levels before 21 you'll need to bump minSdkVersion to 21 in order to use version 6+ of our SDK.

Version 5.5.1

03-10-2019

  • In this release we fixed a number of bugs:
    • Fixed an issue where some gallery images wouldn't load for apps targeting API level 29.
    • Fixed an issue where messages wouldn't show if inbound conversations were disabled.
    • Made improvements to button colours for apps using light themes.

Version 5.5.0

06-09-2019

  • The SDK has been updated to support Android 10

Version 5.4.1

08-08-2019

  • Fix for crash when integrating Intercom while using androidx.appcompat:appcompat:1.1.0-rc01.

Version 5.4.0

09-07-2019

Provide faster, more personal support at scale with Custom Bots for new conversations 🤖

When a customer starts a new conversation with you in the Messenger, they’ll be able to choose from suggested replies that you’ve defined. They can clarify why they’re getting in touch, and provide extra info without needing to wait for a response, or take up your team’s time.

android-5-4-0-release

With Custom Bots from new conversations, you can accelerate your support by automating these initial interactions, so your support team can focus on resolving important issues. To get started, bump your Intercom SDK version to 5.4.0 and go to the Operator tab in Intercom, then Custom Bots, and select From new conversations.

Version 5.3.2

17-05-2019

  • Revert to use okhttp version 3.11.0. There was a compatibility issue with 3.12.3, we'll hold off upgrading until it's fully tested.

Version 5.3.1

15-05-2019

  • Fixed the issue of unable to add images to conversation replies
  • Fixed a crash with InputFragment
  • Updated okhttp to use the latest version

Version 5.3.0

29-04-2019

Deliver Custom Bots to your mobile app users to unlock growth across all platforms

Custom Bots can now be targeted specifically to your mobile app users! Whether your users are on the web or mobile, Custom Bots now work cross-platform to automate and accelerate growth.

android-5-3-0-release

Use our bots to provide better personalization at scale during critical moments of the customer lifecycle like when users first sign up for your app, or when they want to upgrade to a paid plan.

For more details on how to use Custom Bots on mobile, see our docs here.

Version 5.2.1

01-03-2019

  • Fix for Vimeo thumbnails showing the wrong thumbnail preview

Version 5.2.0

04-12-2018

  • Removed GCM support as it is being deprecated.

Google is deprecating GCM on April 11, 2019. We are no longer updating our GCM library, 5.1.6 will be the last version of our messenger with GCM support. We strongly recommend migrating your app to FCM and then migrating from Intercom GCM to Intercom FCM library

Version 5.1.6

13-11-2018

  • Bug fix for fullscreen GIFs not animating
  • Updated Support Library and Build Target SDK versions
  • Added error reporting for SDK crashes
  • Updated GCM and FCM versions

Version 5.1.5

24-10-2018

  • Handled empty state in the home screen
  • Fixed a bug in messenger apps that broke input when some special characters were used

Version 5.1.4

02-10-2018

  • Added support for users to change a conversation rating
  • Added support for Vimeo video thumbnails
  • Fixed an issue with launcher positioning when bottom padding is set
  • Fixed a crash on a text input that occurred on Android devices running Android Version 5

Version 5.1.3

25-09-2018

  • Added DOM storage support in Sheets web view
  • We now provide support for Loom videos in Intercom

Version 5.1.2

17-09-2018

Bug Fixes

  • Add Android translations key for Help Center
  • Draw Help Center toolbar with dark text if the help center color is light.
  • Fix crash with missing string
  • Fix article cards on old devices

Version 5.1.1

17-08-2018

Bug Fixes

  • Fixed the crash while loading large images
  • Fixed the bug where keyboard covers composer on tablets
  • Fixed text overlap in the conversation list on tablets
  • Fixed an issue where teammate avatar flickers during UI updates
  • Bug fix for toolbar title doesn't show up in Messenger App sheets
  • Fixed a bug that was causing Messenger App sheet to open in browser
  • Reorder dependencies for failing PhoneGap build

Version 5.1.0

19-07-2018

Enable mobile users to help themselves with the new mobile SDK for iOS and Android 🎉 😃

The new Intercom mobile SDK brings the Messenger Home to your mobile applications. This means you can add messenger apps that allow your users to self-serve instead of starting a conversation. Users can now quickly access relevant help articles, review pinned content, and view product status in real time – all from the messenger home screen.

5-1-0-release-screens

Bug fixes and Changes

  • Deprecated Intercom.client().displayConversationsList(). Intercom.client().displayMessenger() should be used instead to open our Messenger Home screen.
  • Fixed issue with the header

Version 5.0.2

27-06-2018

Send apps in Messages ⚡📨⚡

Messages have always been a great way to welcome, onboard, and connect with people in your product and on your website. Now with apps in your messages, you can do even more. Embed apps right inside a message to drive actions, engage your audience, and grow your business.

Whether you need to gather customer feedback, schedule a sales call, or share your latest content, apps make it easy for people to take action within the message experience. And with the targeting capabilities of Intercom, you can make sure your message reaches the right person at the right time.

Version 5.0.1

27-04-2018

Version 5.0.0

24-04-2018

The Business Messenger reimagined.

Messenger apps

  • Complete actions beyond chat in the Messenger seamlessly with a growing library of apps. Messenger apps are being rolled out to all customers over the next 2 weeks.

Extendable platform

  • Create your own Messenger apps to suit your unique workflows – and enable entirely new ones.

Updated Design

  • Updated visual design with new wallpapers and expanded color settings.

Messenger settings

  • New wallpapers to customize your profile.
  • Set a background color for your profile and an action color for cards and chat bubbles.
  • Support light theme colors in your messenger.

5-0-0-release-screens

Version 4.1.9

20-04-2018

  • Fixed an issue where sending multiple messages before a conversation is created resulted in multiple conversations
  • Clearer GCM token upload error message
  • Add ProGuard rule for AutoValue
  • Update Support Library to 27.1.1

Version 4.1.8

19-02-2018

Version 4.1.7

25-01-2018

  • Released Help Center on Android. Added the method displayHelpCenter() to the main API. This opens up an Activity which displays your Educate Help Center. Learn more about Educate here. Details on how to setup the experimental API can be found here
  • Allow office hours banner to expand to two lines for languages where the string was truncating

Version 4.1.6

06-12-2017

  • Add support for API 27
  • Update Support Library to 27.0.2
  • Fix message composition issue on Samsung devices

Version 4.1.5

01-12-2017

Version 4.1.4

15-11-2017

Version 4.1.3

08-11-2017

Experimental API

  • The boot() method now takes a user hash in the IntercomSettings object. You can still update the user hash by calling setUserHash but if you have Identity Verification enabled and you are booting with an email and/or user ID then it is required to provide a user hash at that time.

Version 4.1.2

31-10-2017

  • Updated Play Services to 11.4.2

Experimental API

  • added the method displayHelpCenter() to the experimental API. This opens up an Activity which displays your Educate Help Center. Learn more about Educate here. Details on how to setup the experimental API can be found here

Version 4.1.1

25-10-2017

  • Add equals(), hashCode() and toString() implementations to UserAttributes, Company and Registration
  • Minor fixes

Version 4.1.0

10-10-2017

  • Fix StrictMode warnings in Android Oreo
  • Deprecated Intercom.client().reset() in favour of Intercom.client().logout()
  • Intercom now runs a ContentProvider which automatically calls registerForLaterInitialisation(). This means Intercom no longer requires you to make a custom Application class. Intercom.initialize can now be called from your Activity if you would prefer.

Experimental API

  • Added an experimental API. To use it please import io.intercom.android.sdk.experimental.Intercom. The changes to the new API are:
    • Replaced Intercom.initialize(Application, String, String) with Intercom.boot(Application, IntercomSettings) Unlike initialize, boot does not need to be called in a custom Application class. It also results in the creation/ logging in of a user.
    • The methods registerUnidentifiedUser() and registerIdentifiedUser(Registration) are removed. Calling boot now registers a user. The IntercomSettings object has an optional email and userId. If either of those was provided an identified user is registered, otherwise an unidentified user is created.
    • To migrate from an unidentified to an identified user you can simply call updateUser(UserAttributes) where the UserAttributes object contains an userId and/or email.
    • The method logout() has been replaced with shutdown().

Version 4.0.5

27-09-2017

Version 4.0.4

18-09-2017

  • Improved image performance and stability
  • Fix UI issues with teammate profile section
  • Updated translations

Version 4.0.3

08-09-2017

  • Improved image loading stability
  • Fix crashes related to in-app notifications
  • Update Support Library to 26.0.2
  • Update OkHttp to 3.9.0 and Gson to 2.8.1
  • Add support for article suggestions from Operator

Version 4.0.2

07-09-2017

Version 4.0.1

10-08-2017

  • Fix image loading issues

Version 4.0.0

10-08-2017

  • This version has issues with image loading, please use 4.0.1
  • Android O Support
  • Updated to 26.0.0 of the support library
  • Updated FCM and GCM play-services to 11.0.4
  • Updated third party dependencies, a list of the current library versions is provided in the github readme
  • Removed deprecated methods
  • Support for O Notification channels. The channels added by Intercom are:
    • Chat Replies (when you reply to a customer in Intercom)
    • New Chats (when you send an in-app message to a customer with send notification checked)
    • Actions (when you send a push message to a customer)
  • Fixed an OutOfMemoryError in the image gallery#371

Version 3.2.10

04-08-2017

  • Added native support for conversation ratings. You can read more about conversation ratings here.

Version 3.2.9

04-08-2017

Version 3.2.8

13-07-2017

  • Miscellaneous crash fixes

Version 3.2.7

30-06-2017

  • Fixed IndexOutOfBoundsException: https://github.com/intercom/intercom-android/issues/366
  • Fixed NPE when invalid data is passed to IntercomPushClient
  • Fixed logEvent() from affecting user data when called directly after a registration
  • Fixed JsonSyntaxException caused by loading persisted data
  • Fixed the profile not loading correctly when opening the Messenger just after the app starts
  • Optimised images

Version 3.2.6

21-06-2017

  • Minor translation updates

Version 3.2.5

08-06-2017

  • Fix potential crash when replying while uploading an image

Version 3.2.4

31-05-2017

Version 3.2.3

22-05-2017

  • Minor fixes

Version 3.2.2

11-05-2017

  • Added a new public API setBottomPadding() which takes a pixel value to add to the default bottom padding of the default launcher and in app messages.
  • Fixed typo in our IntercomFcmInstanceIdService class check #342
  • Fixed IllegalArgumentException #344
  • Fixed an issue with our real time system not trigger a UI update for a message received when the app is backgrounded and reopened in a short period of time.

Version 3.2.1

03-05-2017

  • Fixed issue causing session count to double increment #337

Version 3.2.0

21-04-2017

  • Updated support library to 25.3.1
  • Added new public API setUserHash(String userHash) which replaces the now deprecated setSecureMode(String hmac, String data)
  • Updated GCM and FCM to 10.2.1

Version 3.1.5

18-04-2017

  • Fixed issues when initialising Intercom outside of Application.onCreate()

Version 3.1.4

14-04-2017

  • Updates to the active/away UI
  • Initialisation fixes

Version 3.1.3

05-04-2017

Version 3.1.2

29-03-2017

  • Fixes #325
  • Translation fixes and improved logging

Version 3.1.1

20-03-2017

  • Add withLanguageOverride() method to the UserAttributes model
  • Display error to users before uploading files that are larger than we support
  • Fixed issue where the Intercom settings color was not applied to the the push icon and push title
  • Fixed localization issues with the composer
  • Fixed issue with applying a padding to in-app messages #311

Version 3.1.0

06-03-2017

  • Added new method to the API updateUser(UserAttributes). Docs on how to use this can be found here
  • Deprecated updateUser(Map<String, ?>) and updateUser(User) methods in favour of updateUser(UserAttributes)
  • Search and send GIFs from our new message composer
  • Dedicated image loader that allows you to preview and send images on your device
  • Fixed a FileNotFoundException in the Intercom SoundPlayer
  • Updated the Android Support Library to version 25.1.1
  • Update the Android GCM and FCM libraries to version 10.2.0

Version 3.0.21

08-02-2017

  • Translation fixes
  • Added withSignedUpAt(Date date) method to User
  • Improved unread conversation count updating when using multiple devices at once.

Version 3.0.20

25-01-2017

  • Re-introduces IntercomLogger that were incorrectly removed from the last release. They are now deprecated in favour of the constants in Intercom.LogLevel.
  • Fixes the conversation scrolling to the bottom incorrectly.

Version 3.0.19

23-01-2017

Version 3.0.18

09-01-2017

Version 3.0.17

16-12-2016

  • The SDK now targets API 25
  • UI fixes
  • Push notification fixes

Version 3.0.16

13-12-2016

  • Networking optimisations
  • UI fixes
  • Fix crash in conversations started from Acquire on web

Version 3.0.15

06-12-2016

Version 3.0.14

24-11-2016

  • Reduced method count by eliminating synthetic methods
  • Networking optimisations

Version 3.0.13

18-11-2016

Version 3.0.12

10-11-2016

Version 3.0.11

07-11-2016

  • Removed dependency on Rebound
  • Updated Android Support Library to 25.0.0
  • Updated Play Services and Firebase to 9.8.0
  • Performance improvements

Version 3.0.10

05-10-2016

Version 3.0.9

16-09-2016

  • Added a new method to the API, displayMessageComposer now accepts an optional String to pre-populate the composer.Intercom.client().displayMessageComposer(message);
  • Update Android Support Library to 24.2.1
  • Update translations
  • Reduced method count

Version 3.0.8

14-09-2016

  • Fixed issue where a long team intro couldn't be fully displayed on smaller devices.
  • Update appearance of code in messages.

Version 3.0.7

09-09-2016

  • Fixed an issue with GCM and FCM conflicting with other registration services.
  • Prevent real-time connections in background processes.

Version 3.0.6

06-09-2016

Version 3.0.5

01-09-2016

  • Fixed an issue with GCM and FCM conflicting with other receivers issue#246
  • Update Support Library to 24.2.0
  • Fix crash when tapping a message after it gets detached from the RecyclerView

Version 3.0.4

22-08-2016

  • Added two pane tablet support.
  • Fixed a bug with Android click tracking.
  • Fixed crash when loading a small subset of resources on older Android versions.
  • Fix app name overlapping with close button in toolbar.
  • Stopped sending a request to remove device token on reset if the user has no device token.

Version 3.0.3

16-08-2016

  • Added FCM support
  • Deprecated openGcmMessage() and openGcmMessage(TaskStackBuilder customStack) with handlePushMessage() and handlePushMessage(TaskStackBuilder customStack)
  • Fixed TCP connections not being fully killed when the application moves into the background
  • Unread count listeners will now receive the latest unread count when they are attached
  • Fixed an issue where the team profile could have an incorrect height after unlocking your device

Version 3.0.2

26-07-2016

  • Fixed an issue where Context objects could have their locale changed by the SDK
  • Fixed an issue where the Messenger could be opened more than once from a push notification
  • Update Support Library dependencies to 24.1.1

Version 3.0.1

22-07-2016

  • Fixed an issue with real time messaging.
  • Fixed an issue with launcher color being default color on first registration of a user on launch.
  • Fixed an issue with passing attributes to a user registration which resulted in not updating the user after the * very first registration.
  • Fixed an issue with failed text parts being treated like uploaded attachments.

Version 3.0.0

21-07-2016

Our new Messenger is out of beta! You can read all about the updated design and new functionality here. If you are upgrading from an older version of our Messenger you may need to change some of the methods you used to call. You can see any changes you may need to make here. Where is 2.x? We're skipping it. We did this to align the Android SDK with our iOS and web counter parts.

Version 3.0.0-beta5

08-07-2016

Changes in the API

How GCM is set up has been simplified. There is not longer a method Intercom.client().setupGcm(token) and Intercom.client().registerIdentifiedUser(Registration.create().withGcmRegistrationId(token));

Instead of the methods above, in your res/values/strings.xml add the following line replacing YOUR_SENDER_ID. The sender is is in your google-services.json file as "project_number": "YOUR_SENDER_ID"

<string name="intercom_gcm_sender_id">YOUR_SENDER_ID</string>

What's new

  • We have added localization to the SDK. This can be set in your app settings https://app.intercom.com/a/apps/<YOUR_APP_ID>/settings/messenger
  • We have updated our default launcher icon.

Issues and bug fixes

  • Fixed crashes in the photoviewer
  • UI bugs and tweaks

Version 3.0.0-beta4

14-06-2016

Changes in the API

We no longer take a resource ID for the push notification icon. To set a push notification icon simply add an image named intercom_push_icon.png to your apps resource drawable directory. Its important to add this for all of the densities you support for example: /res/drawable-xxhdpi/intercom_push_icon.png /res/drawable-xhdpi/intercom_push_icon.png /res/drawable-hdpi/intercom_push_icon.png /res/drawable-mdpi/intercom_push_icon.png

This changes a couple of the public APIs in Intercom:

Intercom.client().setupGcm(token, R.drawable.intercom_push_icon); becomes Intercom.client().setupGcm(token);

Intercom.client().registerIdentifiedUser(Registration.create().withGcmCredentials(token, R.drawable.intercom_push_icon)); becomes Intercom.client().registerIdentifiedUser(Registration.create().withGcmRegistrationId(token));

What's new

  • We added in a new message pill to let users know when they have recieved replies offscreen in the conversation thread they are viewing

Issues and bug fixes

  • We fixed an issue that could result in inflated session counts.

Version 3.0.0-beta3

27-05-2016

New methods in the API

The Registration object now has a withGcmCredentials(String token, int logo) that you can use to set a GCM token and push logo. withGCMRegistrationId(String token) has been removed in favour of this method. Setting a token without a logo is a poorer user experience as we'll have to use a generic default.

In the Intercom class we've introduced a new API method that intelligently opens the messenger to the correct location based on context the messenger is aware of and a users actions in your app. It can open to the conversations list, to an existing conversation, or to compose a new conversation, void displayMessenger().

We've also corrected all methods that used GCM to be Gcm. This is a breaking change.

  • Lazily instantiate much of the object graph the messenger needs to work. This will speed up your app startup time!
  • More improvements to reduce overdraw in the messenger
  • Performance improvements to how we were rendering messages. They render roughly 30-50% faster now.
  • Removed permissions READ_EXTERNAL_STORAGE and MANAGE_DOCUMENTS. These permissions are optional for attachments. In most cases they are not required but certain OS and file provider combinations may fail to send the attachment without.
  • Fixed a bug with push only messages not following an included URI correctly.
  • Fixed a bug that was causing images to be cropped slightly in a chat style messages
  • Fixed a memory leak that sometimes lead to threads not being garbage collected issue#197 and issue#136

Version 3.0.0-beta2

12-05-2016

  • Fixed a crash that would occur if you sent 3+ manual messages to a user, opened your app, then sent another
  • Hide the back arrow when coming from the conversation screen back to the conversations list
  • Fixed the sizing for our FAB asset on the conversations list screen. It's more crisp now
  • Removed a lot of overdraw from inside the conversations list
  • Made some performance improvements to how we're rending messages

Version 3.0.0-beta1

06-05-2016

We're skipping 2.x entirely. This is being done to align the iOS and Android versions of Intercom such that going forward we'll have similar major.minor patches for features. It's easier for all of us internally too if we can refer to something in a platform agnostic way (Messenger V3!) :)

What's new

We’ve updated every pixel of our Messenger. The UI feels a lot more native, fluid and is more visually appealing while fitting into the visual aesthetic of your app better too.

Part of this involves a new Intercom Launcher that you can show in your app to let your users instantly access the Messenger.

Dependencies

As part of the work to bring a better visual aesthetic to the Messenger we started using some new dependencies. Chief amongst these are the support libraries Google provides. This library now relies on:

  • com.android.support:appcompat-v7:23.3.0
  • com.android.support:recyclerview-v7:23.3.0
  • com.android.support:design:23.3.0

If you use these libraries in your project be aware that we plan to stay up to date with releases and this will, by default, transitively force your app to use these versions too.

We also added some dependencies that we're namespacing to avoid version conflicts and other conflicts:

  • com.facebook.rebound:rebound:0.3.8 for nice spring animations
  • com.github.bumptech.glide:glide:3.7.0 for gif support

And on top of that we've updated OkHttp and Retrofit to the 3.x and 2.x versions. These are also namespaced so that won't confict with anything in your code.

New methods on the public interface

  • void setLauncherVisibility(Visibility visibility) will toggle whether the new Intercom launcher appears in your app. Valid parameters are Intercom.Visibility.VISIBLE and Intercom.Visibility.GONE. The default is GONE.
  • void setInAppMessageVisibility(Visibility visibility) will toggle whether in-app messages appear in your app when sent to a user. Valid parameters are Intercom.VISIBLE and Intercom.GONE. The default is VISIBLE.
  • void hideMessenger() will close the Intercom Messenger if it's onscreen. The typical use case we've seen for something like this is that an important event has happened in the background of your app (eg a user has taken 10,000 steps) and you need to display something immediately. We'd advise normally using an Intent to start your activity if that's possible within your app's architecture; we're accounting for the possibility that it isn't always possible with this method.
  • int getUnreadConversationCount will return the last known number of unread conversations that a user has.
  • void addUnreadConversationCountListener(UnreadConversationCountListener listener) lets you set a listener that will be notified every time the known conversation count for this user changes. For example, you may want to display a badge somewhere in your app that exposes to a user the number of unread conversations they have. Multiple listeners can be registered at a time. A strong reference is kept to each listener.
  • void removeUnreadConversationCountListener(UnreadConversationCountListener listener) removes this listener from the list that will be notified of unread conversation count updates.

Removed methods from public interface

All deprecated methods have been dropped from Intercom, these include

  • setMessagesHidden(boolean visibility) in favour of two new visibility methods explained below
  • openGCMMessage(Uri data) in favour of openGCMMessage(Intent intent)

In addition some other methods have been dropped:

  • setPreviewPosition has been removed with no replacement
  • setVisibility has been removed in favour of setLauncherVisibility and setInAppMessageVisibility

Miscellaneous

  • We've hidden our resources so you won't see all our layouts, colours etc when you're trying to reference your own resources

Version 1.1.21

14-06-2016

Protect against crash if the image resource is not found issue#198.

Version 1.1.20

02-06-2016

  • Fixed an issue which can result in inflated session counts for both identified and unidentified users.

Version 1.1.19

17-05-2016

  • Removed permission VIBRATE. VIBRATE was used for push notifications. If it is included in the host app the push will still cause the default device vibration.
  • Removed permissions READ_EXTERNAL_STORAGE and MANAGE_DOCUMENTS. These permissions are optional for attachments. In most cases they are not required but certain OS and file provider combinations may fail to send the attachment without.
  • Fixed an issue with push only messages not following the URI correctly.

Version 1.1.18

18-04-2016

  • Checks that there are intents capable of opening links etc before opening them, fixes issue#190
  • Fixed an bug where apps running on Ice Cream Sandwich were unable to send attachments
  • Fixed a bug that was causing us to generate a URL to communicate with the Intercom servers that doesn't conform with rfc1123 for a small number of people, more context in issue#186

Version 1.1.17

01-04-2016

  • Update to fix remaining issues with registration issue#181
  • Made some permissions we use in the GCM module optional ("android.permission.READ_PHONE_STATE" and "android.permission.ACCESS_WIFI_STATE")
  • Removed some unnecessary noisy logging when calling reset, fixes issue#188
  • Fixed a bug where the empty inbox list does not update when the user starts a new conversation for the first time.

Version 1.1.16

04-03-2016

  • Updated to Okhttp 2.7.5 for improved reliability and bug fixes, fixes issue#181
  • Fixed an issue where a loading dialog could get into a state where it stayed on screen incorrectly, issue#183
  • Fixed an issue with the keyboard not dismissing while viewing an image, issue#184

Version 1.1.15

12-02-2016

  • Fixed IndexOutOfBounds exception, issue#176
  • Fixed a crash caused by BitmapFactory.decodeResource returning null.

Version 1.1.14

02-02-2016

  • Reduced the initialization time by 50%
  • Fixed an NPE in our ConversationAdapter, issue#164
  • Removed the remaining hard coded strings in the client, issue#156
  • Fixed a crash caused when a video failed to load. We now always show an error image for failed videos.

Version 1.1.13

22-01-2016

  • Fixed a crash with drawing the avatar in push notifcations, issue#163
  • Fixed a crash with websockets cleanup
  • Fixed a bug that prevented URLs from displaying in a conversation

Version 1.1.12

22-12-2015

  • Protected against a potential NPE in the networking layer.
  • Fixed an issue with the public reset call that resulted in the GCM device token not being removed from the server.
  • Small improvements to GCM notifications, including enabling notification lighting to use the host apps base color.

Version 1.1.11

04-12-2015

  • Fixed a crashing issue when you add an attachment to a conversation that is a contact from an Android device. We now also protect against other unexpected failed attachment types.
  • Fixed a bug with the unread count not being correctly maintained if you come and go from the Inbox and composer/conversation screen.

Version 1.1.10

27-11-2015

  • Tweaked some network settings for improved reliability
  • Improved logging messages for network request failures, in particular a 'canceled' request should give the reason why it was cancelled now and if you provide invalid credentials (app-id or api key) the library will fail faster with a better log message.
  • Fixed a bug that was causing the library to do work it didn't need to if an app became active in the background.
  • Fixed a bug where calling reset() wasn't removing on screen notifications.
  • Fixed a bug where push messages were still being sent after reset() was called.
  • Fixed a bug that caused a new message to duplicate the first part if it was replied to immediately

Version 1.1.9

03-11-2015

  • Fixed a bug that could cause the notification preview to display over the message composer or conversations list

Version 1.1.8

22-10-2015

  • We've made some significant changes to the notification preview and how it works.
    • It's no longer draggable, instead it will now reposition when the screen changes, eg. when the keyboard appears.
    • It's a lot more memory efficient.
    • Fixed some longstanding UI issues when the notification was right aligned, it now reliably shows the text preview.
    • We no longer use the SYSTEM_ALERT_WINDOW permission
  • Added better permission checking around attachments to handle cases where rooted phone are denying access, fixes issue#137

Version 1.1.7

01-10-2015

  • Updated play services to 8.1 ('com.google.android.gms:play-services-gcm:8.1.0'). 8.1 introduces some breaking changes, see here for change details (https://developers.google.com/android/guides/releases#september_2015)
  • Removed duplicate realtime requests
  • Calling logEvent(String, Map) with a null or empty Map no longer fails but instead calls logEvent(String)
  • Fixed an issue with HTC devices not being able to interact with the chathead from IceCreamSandwich to Jellybean.

Version 1.1.6

23-09-2015

  • Hot fix for a NoClassDefFound exception in the intercom-sdk-gcm, issue#134

Version 1.1.5

23-09-2015

  • Deprecated openGCMMessage(Uri) in favour of openGCMMessage(Intent) and openGCMMessage(Intent, TaskStackBuilder)
  • Fixed a crash for requesting permissions on pre Lolipop devices
  • Fixed ConcurrentModificationException issue#119
  • New public method setLogLevel that allows developers to control the level of logging they want and to fully disable logging issue#112
  • New implementation for openGCMMessage that takes the a TaskStackBuilder allowign developers to provide a backstack before we open the in-app messengerissue#110
  • New implementation for openGCMMessage that takes the intent and only open the in-app messenger once per push issue#105

Version 1.1.4

18-09-2015

  • Updated to support Android M preview issue#116
  • Swallow AssertionError in AppConfig caused by GSON issue#120
  • Protect against NPE in CallbackHolder issue#122
  • Fixed an index out of bound exception issue#113
  • Updated the signature for logEvent and updateUser to take maps of <String, ?>. Now you can pass in a Map<String, String> if that's what you happen to have instead of changing it to a Map<String, Object>. No changes are necessary to existing code. issue#121

Version 1.1.3

27-07-2015

  • Integrated a smarter system for retrieving and displaying new messages sent while an app is open, fixes issue#109
  • Lowercased font assets names and added some better error handling for when fonts can't be made, fixes issue#107
  • Repackaged all of our dependencies except the play services library, resolves issue#50
  • Fixed crash in preview service where the rootview was sometimes not inflating issue#108

Notes: When updating to this version from a previous version we recommend cleaning the project as you include the v1.1.3. If you're using eclipse make sure to include the new fonts and repackaged dependencies jar

Version 1.1.2

06-07-2015

  • Namespaced fonts and raw assets. Every asset should be prefixed with 'intercomsdk' to avoid conflicts, let us know if you see one that isn't
  • Fixed a crash when loading a conversation if a participant had a leading space in their name
  • Fixed issue#104, a memory leak
  • Fixed a GCM related issue. Some saw an error stacktrace caused by our broadcast receiver for gcm setting a result on on unordered broadcast. That broadcast was the OS pinging the broadcast receiver (typically on first install). This is a benign 'error' that doesn't cause any issues, but we're going to try to ignore it anyway. You shouldn't see that error in your logs any more.

Version 1.1.1

01-07-2015

  • Catching exeption that sometimes gets thrown when app is backgrounded

Version 1.1.0

01-07-2015

  • Users can now send attachments
  • Added new permissions for attachments: EAD_EXTERNAL_STORAGE and MANAGE_DOCUMENTS
  • Users can expand and zoom images without leaving your app
  • Improved performance in conversations with many images
  • Split GCM related code into a separate module that is included by default but can be excluded if you don't require GCM
  • Fixed issue#95
  • Fixed issue#98

Version 1.0.4

09-06-2015

  • Visual improvements for conversations that involve more than two people
  • Fixed a crash caused by the system passing null into our GcmIntentService
  • Fixed issue#83
  • Fixed issue#88

Version 1.0.3

03-06-2015

  • Updated dependencies in the library: okhttp, okhttp-ws, support and play services libraries
  • Namedspaced custom XML attributes

Version 1.0.2

26-05-2015

  • Fixed a crash caused by messages containing a list with some HTML content in the list items

Version 1.0.1

22-05-2015

  • You can now change the Android API key used in an app without having to clear the local cache of your app, eg switching between a test app and your real app. This doesn't allow changing of the API key dynamically as an app is running.
  • Fixed a bug where an avatar that was a gif would crash
  • Fixed a bug where we were being too agrgressive with user attribute validation and stopping some correct attributes from being sent to Intercom
  • Remade our assets for lower dpi phones, they look better now
  • Small UI improvements

Version 1.0.0

05-12-2015

  • Small UI and visual tweaks

Version 0.9.8

05-11-2015

  • Many small UI and visual tweaks
  • Fixed a bug that caused a converation loaded from a push notification to not display the unread conversations counter in the top left
  • Fixed a bug that could cause the loading progress dialog in the conversations list to not be correctly dismissed

Version 0.9.7

05-01-2015

  • The Intercom SDK no longer has any functionality on devices below API level 15
  • The Intercom SDK now supports real-time messaging
  • Many visual tweaks and improvements
  • Push notifications are now high priority on devices that support notification priority
  • Fixed some issues where push notifications would be rendered when the app was open
  • Resolved issue#69, a crash on Gingerbread devices

Version 0.9.6

04-29-2015

  • Removed GCM permissions so that now developers have the option of adding them only if you want to register for push notifications
    • <!-- GCM REQUIRED PERMISSIONS -->
    • <uses-permission android:name="android.permission.WAKE_LOCK" />
    • <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
    • <uses-permission android:name="android.permission.VIBRATE"/>
    • <!-- GCM Optional PERMISSIONS -->
    • <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    • <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
  • Added audio cues to received and sent messages
  • Fixed issue#54 Updated action bar visuals
  • Fixed a bug where a conversation replied to by a user would update it's summary in the inbox but not it's position, related to issue#58
  • Fixed issue#59
  • Fixed issue#60
  • Fixed issue#65 which was causing a crash
  • Fixed issue#67 by removing metadata from the offending PNGs

Version 0.9.5

04-15-2015

  • The SDK now logs any API errors as well as the HTTP response status code received for errors
  • Scrolling inside a conversation was a little janky, we've improved it. Specifically scrolling to the end of new replies and some general improvements
  • Fixed a crash when our service was restarted unexpectedly
  • Fixed an issue that could cause session counts to be incremented by one incorrectly in some cases

Version 0.9.4

04-08-2015

  • Deprecated 'setMessagedHidden' in the Intercom class in favour of 'setVisibility'. The 'setVisibility' method takes either Intercom.VISIBLE' or 'Intercom.GONE' as a parameter.
  • Timestamps periodically update within a conversation
  • Removed the 'GET_ACCOUNTS' permission issue#46. It's not necessary for GCM.
  • Fixed a gingerbread compatibility issue that was incorrectly letting it try to access anything visual in the SDK and subsequently crashing.
  • Fixed a bug with 'setMessagedHidden' where calling it with 'true.GONE' wouldn't dismiss the IAM if it was open.
  • Fixed issue#55, deep links work now.
  • Fixed issue#57 which caused a new message to never be correctly updated from the sending state to sent state.
  • Fixed issue#60 that let users send a message many times if it got stuck in a 'sending failed' state

Version 0.9.3

03-31-2015

  • Added the internet and access wifi state permissions to our Manifest
  • Validating the attributes map passed into the updateUser method and giving better error messages
  • Updated to v2.3.0 of Okhttp

Version 0.9.2

03-27-2015

  • Updated the sdk proguard rules to reflect the new package

Version 0.9.1

03-26-2015

  • Repackaged the SDK from 'intercom.intercomsdk' -> 'io.intercom.android.sdk'. This will cause all your imports to break
  • All network requests from the SDK are now SSL pinned
  • Fixed a bug where switching between conversations and new messages very quickly could cause a crash
  • Fixed a bug where a new messages created from the SDK wasn't displaying in the inbox
  • Fixed a bug where the SDK could crash if it was resumed after a long backgrounding
  • Updated to v7.0.0 of the Google Play Services Library
  • Updated to v2.5.2 of Picasso

Version 0.9.0

02-23-2015

  • adding CHANGELOG
  • adding samples/intercom-push-sample to help test push integration