CHANGELOG.md

# Changelog

## 18.0.0
###### Release Date: 31-03-2026

### ⚡ Important Changes

**Minimum SDK version raised to 23 (Android 6.0)**<br>
The SDK now requires `minSdk 23`, aligning with AndroidX Compose library requirements and modern Android development practices. Apps targeting API levels 21-22 must remain on version 17.x.

**Target SDK version raised to 36 (Android 16)**<br>
The SDK now targets Android 16, ensuring compliance with the latest Google Play requirements and enabling support for new platform features including improved edge-to-edge display behavior. Your project must use `compileSdk 36` or higher. If you are not ready to use API level 36, please stay on version 17.x.

**Internal storage migrated from SharedPreferences to AndroidX DataStore**<br>
All internal SDK data storage has been migrated from SharedPreferences to AndroidX DataStore, bringing significant improvements to reliability, thread safety, and performance. Sensitive data is now protected with AES-256-GCM encryption via Android Keystore. Existing SDK data is automatically migrated on first launch with no action required from developers. This migration is one-way — downgrading to a previous SDK version after upgrading will result in loss of local SDK state.

**Removed deprecated `handlePushMessage` APIs**<br>
The `handlePushMessage()` and `handlePushMessage(TaskStackBuilder)` methods have been removed. These APIs were no longer required — the SDK now directly opens the chat screen when a push notification is tapped. No replacement is needed.

### 🐛 Bug Fixes
* Fixed English missing from the supported languages header
* Fixed in-app notification disappearance in certain cases
* Fixed overlays rendering behind navigation bar on `AppCompatActivity` with edge-to-edge

### 👉 Dependency updates
* Compose BOM: Updated to 2026.03.01
* AndroidX Core KTX: Updated to 1.18.0
* Ably: Updated to 1.7.1

## 17.4.7
###### Release Date: 11-03-2026

### 🐛 Bug Fixes
* Fixed push notifications not displaying in certain cases
* Fixed unread badge counter not updating in certain cases
* Fixed attachment upload issues
* Fixed various UI issues

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.4.6
###### Release Date: 03-03-2026

### 🐛 Bug Fixes
* Fixed a crash that could occur when handling push notifications
* Fixed push notification images not loading correctly in some cases
* Fixed AI agent name and avatar not appearing correctly in in-app notifications

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.4.5
###### Release Date: 25-02-2026

### 🐛 Bug Fixes
* Fixed various in-app notification UI issues
* Fixed workflows not triggering in certain cases

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.4.4
###### Release Date: 11-02-2026

### 🐛 Bug Fixes
* Fixed carousels not showing up in certain cases

### 👉 Dependency updates
* Ably: Updated to 1.6.1

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.4.3
###### Release Date: 09-02-2026

### 🐛 Bug Fixes
* Fixed discrepancy between sent and completed metrics for single-screen carousel
* Fixed carousels orientation restriction causing Google Play Store compliance warning for Android 16

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.4.2
###### Release Date: 23-01-2026

### 🐛 Bug Fixes
* Fixed an issue where two articles were opened instead of one
* Fixed crash when previewing password-protected PDFs

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.4.1
###### Release Date: 15-01-2026

### 🐛 Bug Fixes
* Fixed `MalformedURLException` crash when opening preview for an uploading file in conversation
* Fixed various in-app notification UI issues

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.4.0
###### Release Date: 23-12-2025

### 🚀 Enhancements
* Added titles to the Messages screen to help users differentiate between their conversations.

### 🐛 Bug Fixes
* Fixed an issue where in-app notification text was not visible when displaying the latest message in a conversation.
* Fixed `setBottomPadding` API not working correctly, which caused improper positioning of the launcher and in-app notifications.
* Fixed a privacy issue where teammate surnames were being displayed in in-app notifications.

### 👉 Dependency updates
* Compose Navigation: Updated to 2.9.6
* AndroidX ExifInterface: Updated to 1.4.2
* Ably: Updated to 1.5.0
* Kotlin: Updated to 2.0.20
* Compose BOM: Updated to 2025.11.01

### 👉 Note
* The next major version of the Android SDK will require `minSdk 23` (Android 6.0) due to AndroidX Compose library requirements.

## 17.3.1
###### Release Date: 11-11-2025

### 🐛 Bug Fixes
* Fixed ClassNotFoundException crash related to Ably integration

### 👉 Dependency updates
* Compose BOM: Updated to 2025.10.01

## 17.3.0
###### Release Date: 17-10-2025

### 🐛 Bug Fixes
* SDK now uses Ably as a source for websocket events
* Fixed LazyColumn duplicate key crash in AI answer sources bottom sheet
* Fixed R8 compilation error caused by missing Lombok classes from Ably library dependency

### 👉 Dependency updates
* Fragment Kotlin Extensions: Updated to 1.8.9
* Compose Navigation: Updated to 2.9.5

## 17.2.0
###### Release Date: 03-10-2025

### 🚀 Enhancements
* Added Voice Notes to the conversation composer. Users can now record voice messages that are automatically transcribed to text and can be sent in conversations.

### 🐛 Bug Fixes
* Fixed an issue where in-app notifications were not showing up in certain cases
* Fixed an issue where in-app notifications display underneath system navigation buttons
* Fixed `NullPointerException` crash caused by unsuccessful authorization response

### 👉 Dependency updates
* Compose BOM: Updated to 1.9.2 (via BOM 2025.09.01)
* Gson: Updated to 2.13.2
* Lifecycle Components: Updated to 2.9.4

## 17.1.1
###### Release Date: 11-09-2025

### 🐛 Bug Fixes
* Fixed errors introduced in older version of androidx.navigation:navigation-* by bumping to version 2.9.3

## 17.1.0
###### Release Date: 18-08-2025

### 🚀 Enhancements
* Added a new contextual push notification reminder. An in-conversation banner can appear inside conversations that nudge users to enable push notifications at the most relevant moments.
* UI Improvements for events in conversations.

### 🐛 Bug Fixes
* Fixed an issue where unnecessary reconnections occurred when the app is backgrounded on Android 15 and later.

## 17.0.4
###### Release Date: 11-08-2025

* Bug fixes and performance improvements
* Improvements to metadata when images are sent in a conversation
* Fixed issue where emojis were missing in conversation rating card

## 17.0.3
###### Release Date: 23-07-2025

* Improved dark mode support

### 🐛 Bug Fixes
* Fixed issue where audio was missing in certain videos

## 17.0.2
###### Release Date: 11-07-2025

### 🐛 Bug Fixes
* Fixed `ClassNotFoundException: androidx.compose.material.icons.Icons` crash

## 17.0.1
###### Release Date: 11-07-2025

### 🐛 Bug Fixes
* Fixed `NoSuchMethodError: No virtual method getParcelableArrayExtra` crash happening on lower Android versions
* Fixed `IllegalStateException: The specified child already has a parent` crash
* Fix in-app notification crash in Unity projects by improving legacy activity detection

### 👉 Dependency updates
* `com.google.firebase:firebase-messaging` to `24.1.2`

## 17.0.0
###### Release Date: 26-06-2025

### 🚀 Enhancements
* Added support for Dark Mode. This feature is currently in beta, and will be enabled for all customers in a future release.

### 👉 Dependency updates
* Removed `io.sentry:sentry-bom` dependency

## 16.3.0
###### Release Date: 05-06-2025

### 📱 New Feature: Conversational Fin
We’re making conversations more natural and reducing the need for escalations.

- **More human, less rigid**: We’ve removed quick reply buttons so Fin can respond fluidly—no decision trees, just natural conversation.

- **Sources, now inline**: Fin now includes source links directly in replies, so customers can verify info at a glance.

## 16.2.1
###### Release Date: 30-05-2025

### 🐛 Bug Fixes
* Fixed a deadlock issue in `changeWorkspace` API that could occur when login API was called right after `changeWorkspace` API, causing the application to hang indefinitely while waiting for authentication.

### 👉 Dependency updates
* Sentry: Updated to 8.13.2

## 16.2.0
###### Release Date: 28-05-2025

### 🚀 Enhancements
* Added new API `handlePushWithCustomStack` in `IntercomPushClient`. Use this to handle Intercom push messages with a custom backstack. Implement your custom push integration by extending `FirebaseMessagingService` and call `handlePushWithCustomStack` in the `onMessageReceived` method as shown in the example below.

```
public void onMessageReceived(RemoteMessage remoteMessage) {
    String message = remoteMessage.getData();
    if (intercomPushClient.isIntercomPush(message)) {
        TaskStackBuilder customStack = TaskStackBuilder.create(this);
        customStack.addNextIntent(new Intent(this, CustomActivity.class));
        intercomPushClient.handlePushWithCustomStack(getApplication(), message, customStack);
    } else {
        //DO HOST LOGIC HERE
    }
}
```

### 🐛 Bug Fixes
* Fixed `IllegalArgumentException: Missing keys: [timestamp]` crash
* Fixed `NullPointerException: Parameter specified as non-null is null` crash happening in in-app notifications

### 👉 Dependency updates
* Sentry: Updated to 8.13.1
* Fragment Kotlin Extensions: Updated to 1.8.7
* Compose BOM: Updated to 1.8.2 (via BOM 2025.05.01)

## 16.1.0
###### Release Date: 20-05-2025

### 🚀 Enhancements
* Added new API `changeWorkspace`. Use this to change the workspace that the SDK is connected to.

### 👉 Dependency updates
* Sentry: Updated to 8.12.0
* Lifecycle Components: Updated to 2.9.0
* Compose Navigation: Updated to 2.9.0

### 👉 Note
* `registerForLaterInitialisation` and `unregisterForLateInitialisation` are now deprecated. Use `initialize()` instead. SDK will not communicate with Intercom until a user registration is made.

## 16.0.0
###### Release Date: 09-05-2025

* Bug fixes and performance improvements

### 👉 Dependency updates
* Compose BOM: Updated to 1.8.1 (via BOM 2025.05.00)
* Gson: Updated to 2.13.1

### 👉 Note
* This version requires `compileSdk` version to be at least **35**. If you are not ready to use API level 35, please stay on the Intercom version 15.16.1

## 15.16.1
###### Release Date: 02-05-2025

### 🚀 Enhancements
* Added support for conversations merged across channels and users

### 🐛 Bug Fixes
* Fixed an issue where Notes and Posts weren't showing in full
* Fixed IllegalArgumentException: Max number of dynamic shortcuts exceeded
* Fixed crashes on push notifications

### 👉 Dependency updates
* Compose BOM: Updated to 1.8.0 (via BOM 2025.04.00)
* Sentry: Updated to 8.11.1
* Gson: Updated to 2.13.0
* AndroidX ExifInterface: Updated to 1.4.1

## 15.16.0
###### Release Date: 11-04-2025

### 🚀 Enhancements
* We've added a new API to enable setting JWTs in the Messenger. This should be called before any user login. To learn more go [here](https://www.intercom.com/help/en/articles/10589769-authenticating-users-in-the-messenger-with-json-web-tokens-jwts).
* Resolved some differences between the registration of unidentified and identified users of iOS and Android. Both platforms now have matching implementations.

## 15.15.2
###### Release Date: 04-04-2025

### 🐛 Bug Fixes
* Various bug fixes and performance improvements
* This release does not enforce apps to target API level 35
* The minimum Kotlin version needed to use this version of Intercom SDK is now 1.8.22

### Dependency updates
* `androidx.navigation:navigation-compose` to `2.8.9`
* `androidx.compose:compose-bom` to `2025.03.01`
* `io.sentry:sentry-bom` to `8.5.0`
* `com.google.firebase:firebase-messaging` to `24.1.1`

## 15.15.0
###### Release Date: 11-03-2025
### 🚀 Enhancements
* This release now supports opening directly to the conversation screen/recent conversation

### 🐛 Bug Fixes
* Fixed issues with attribute collectors

### Dependency updates
* androidx.compose.animation:animation-graphics-android to 1.7.8
* androidx.navigation:navigation-compose to 2.8.7
* androidx.compose:compose-bom to 2025.02.00
* androidx.activity:activity-compose to 1.10.1
* androidx.fragment:fragment-ktx to 1.8.6
* paging_version to 3.3.6
* androidx.constraintlayout:constraintlayout to 2.2.1
* androidx.exifinterface:exifinterface to 1.4.0

## 15.14.0
###### Release Date: 13-02-2025

### 📱 New Features
* This release supports conditionally displaying attributes when filling out ticket forms.

### 🚀 Enhancements
* Improved scrolling performance on the conversation screen
* Added dynamic Fin thinking states

### 🐛 Bug Fixes
* Clicking a chat push notification now opens the Intercom conversation directly instead of first launching the launcher activity of your app.
* Fixed infinite loading in the conversation screen if a workflow contains an article

## 15.13.0
###### Release Date: 27-01-2025

### 🚀 Enhancements
* Improved delineation between AI Agents and bots.
* New handover experience from AI Agents to teammates.
* Added Privacy Policy in the conversation screen
* Special notice now supports multiple languages.
* Intercom SDK now targets Android 15 (API level 35).
* Added edge-to-edge support

### 🐛 Bug Fixes
* Fixed the issue with new conversation workflow doesn’t trigger

## 15.12.0
###### Release Date: 15-01-2025

### 🚀 Enhancements
* Added support for Fin for Platforms.
* Special notice view now supports links.

### 👉 Note
* This release contains some beta features.

## 15.11.5
###### Release Date: 10-01-2025

### 🚀 Enhancements
* Revamped the “More” menu when launching directly into a conversation.
* Updates to the Powered By Intercom badge in conversations.

### 🐛 Bug Fixes
* Fixed a crash occurring when sending attachments.
* Fixed an issue where tapping push notifications wouldn’t open the conversation

### 👉 Dependency updates
* Firebase Messaging: Updated to 24.1.0

### 👉 Note
* This release contains some beta features.

## 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](https://developers.intercom.com/installing-intercom/android/fcm-migration-guide/).

👉 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](https://github.com/intercom/intercom-android/assets/3718984/7bce28c5-9fa7-415a-a27a-f93cef3f2887)
**📱 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](https://user-images.githubusercontent.com/10852539/237055121-cef234ba-7130-45ec-96cc-7f4b3a5f420b.png)|![Fin-Intro](https://user-images.githubusercontent.com/10852539/237054858-81dd271a-419b-4192-afa2-2b24ccdcec93.png)|![Fin-Answer](https://user-images.githubusercontent.com/94445025/236837489-31cd957d-dd99-49bf-83e0-d7afe4ab8c91.png)|

**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]([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.](https://www.intercom.com/help/en/articles/6612589-set-up-the-fully-customizable-messenger)


![Image](https://user-images.githubusercontent.com/101131135/199487389-9100911a-192d-4b02-a1b4-232d22769408.jpeg)




* **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](https://www.intercom.com/help/en/articles/6436600-tickets-explained) 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](https://www.intercom.com/messenger)

[Learn more about Intercom Tickets](https://www.intercom.com/help/en/articles/6436600-tickets-explained)

👉  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](https://developers.intercom.com/installing-intercom/docs/migrating-to-14-0-0-android)

## 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](https://developers.intercom.com/installing-intercom/docs/rich-push-notifications).


![teammate-rich-push](https://user-images.githubusercontent.com/3718984/168879258-10e42f34-c7b1-4f57-8649-a73da30d3b69.gif)


![PHOTO-2022-05-17-12-42-30](https://user-images.githubusercontent.com/3718984/168879759-8d656c5e-a89e-4c3f-a625-d109674158a8.jpg)


## 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](https://developers.intercom.com/installing-intercom/docs/android-configuration#present-a-survey-programmatically).

## 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](https://developers.intercom.com/installing-intercom/docs/intercom-for-android) and our [sample apps](https://github.com/intercom/intercom-android/tree/master/sample) for further details on these API changes.

Check out [release v12.0.0](https://github.com/intercom/intercom-android/releases/tag/12.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](https://user-images.githubusercontent.com/6392766/159682454-25995724-68f7-4201-a6c2-5b1bffe11ed1.png)

**📱 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](https://user-images.githubusercontent.com/92860980/159684905-ba031ac0-2bb8-4ec3-bdb0-2232a641b180.gif) | ![surveys gif 2](https://user-images.githubusercontent.com/92860980/159684922-dc4432f3-f245-4a49-a258-e6da612d818a.gif) |

👉  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](https://www.intercom.com/surveys)

https://user-images.githubusercontent.com/3718984/159649798-a255ab7a-df79-4015-875c-399872e6186c.mp4

https://user-images.githubusercontent.com/6392766/159682983-e13d3080-8025-4f90-9a75-14f41b81a5bc.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.
  <img src="https://user-images.githubusercontent.com/5046761/134326966-f1b08bbc-da9d-46ee-b1c8-2e1afd00c836.png" width="350px"/>

## 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](https://user-images.githubusercontent.com/3718984/122231184-2c707480-ceb2-11eb-8178-6d0aaab34713.gif)

### 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
* Intercom no longer depends on Glide and now uses Coil to load images.
* Intercom no longer requires the Jcenter repository.
  https://developers.intercom.com/installing-intercom/docs/android-installation#section-maven-central
* Bug fixes and performance improvements.

## 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](https://www.intercom.com/help/en/articles/4704414-enable-looping-and-let-resolution-bot-answer-multiple-questions-in-a-conversation), which allows Resolution Bot to answer multiple questions in a conversation.
* Both features can be enabled in [Operator settings](https://app.intercom.com/a/apps/_/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](https://developers.intercom.com/installing-intercom/docs/android-configuration#section-present-an-article-programmatically) and [displayCarousel](https://developers.intercom.com/installing-intercom/docs/android-configuration#section-present-a-carousel-programmatically).
* 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](https://www.intercom.com/help/en/articles/3822642-tips-for-using-intercom-to-help-with-your-covid-19-response).
  ![Special notice message](https://user-images.githubusercontent.com/3718984/98683858-6ea26800-235d-11eb-9bb3-4dc3a89eaf6d.png)

* 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](https://www.intercom.com/mobile-carousels)

<a href="https://product-education.wistia.com/medias/4y7for3aya " target="_blank"><img  src="https://user-images.githubusercontent.com/3185423/84791321-5581cf00-afea-11ea-848e-d29fbd657e10.png"></a>

![Carousel - Made for mobile - Red](https://user-images.githubusercontent.com/5046761/84787741-439e2d00-afe6-11ea-9ff8-a1ed7c4850d7.png)

![anrdroid_standard](https://user-images.githubusercontent.com/3185423/84802829-0b541a00-aff9-11ea-9e7f-1613e8d7d369.gif)

![Carousel - Permissions - Android - Yellow](https://user-images.githubusercontent.com/5046761/84787743-439e2d00-afe6-11ea-96fd-9aebd745fa18.png)


### 📱 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](https://user-images.githubusercontent.com/5046761/84785550-8579a400-afe3-11ea-978d-49cba15cf54c.gif)

### 📱 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
* We've implemented the abilty to disable the composer for [inbound conversations that use Custom Bots](https://www.intercom.com/help/en/articles/3118298-triage-inbound-conversations-with-custom-bots).

## 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](https://community.intercom.com/t/intercom-android-sdk-crashing-with-android-appcompat-1-1-0-alpha03/1095/28) 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](https://user-images.githubusercontent.com/5109304/60926201-a45faa00-a25a-11e9-9f96-2915541a55b7.png)

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](https://user-images.githubusercontent.com/5046761/56959018-f772fd80-6b43-11e9-88e1-1f42e32a0d26.png)

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](https://www.intercom.com/help/faqs-and-troubleshooting/custom-bots/do-custom-bots-work-on-mobile).

## 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](https://developers.google.com/cloud-messaging/faq) 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](https://developers.google.com/cloud-messaging/android/android-migrate-fcm) and then [migrating from Intercom GCM to Intercom FCM library](https://developers.intercom.com/installing-intercom/docs/android-fcm-push-notifications)

## 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

- [AnswerBot](https://www.intercom.com/bots-for-support) support.

**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](https://user-images.githubusercontent.com/2615468/42951497-316de29a-8b6e-11e8-8ed8-a0a3a93f6f4f.png)

**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

- Removed all code that used a persistent device identifier to adhere to [Android Advertising ID policy](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en)

## 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](https://user-images.githubusercontent.com/2615468/39157445-befb7196-4752-11e8-8a33-57636975ecec.png)

## 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

* Fix webview crash: https://github.com/intercom/intercom-android/issues/456
* Fix broken lightbox transitions: https://github.com/intercom/intercom-android/issues/464
* Fix launcher and in-app notifications showing on Intercom Messenger screens
* Update Play Services & Firebase libraries to 11.8.0
* Update Glide to 4.4.0
* Updated Okio & OkHttp to latest versions

## 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](https://www.intercom.com/customer-support-software/knowledge-base). Details on how to setup the experimental API can be found [here](https://developers.intercom.com/docs/android-configuration#section-educate-help-center)
* 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

* Fixed https://github.com/intercom/intercom-android/issues/452
* Fixed https://github.com/intercom/intercom-android/issues/451
* Fixed https://github.com/intercom/intercom-android/issues/449

## Version 4.1.4

15-11-2017

* Fix OOM error https://github.com/intercom/intercom-android/issues/422
* Updated Gson to 2.8.2

## Version 4.1.3

08-11-2017

* Fixed an issue with the keyboard not closing on toolbar back pressed https://github.com/intercom/intercom-android/issues/435
* Fixed a RuntimeException with UploadEvent https://github.com/intercom/intercom-android/issues/439
* Fixed a NullPointerException in the PushPayload https://github.com/intercom/intercom-android/issues/442

**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](https://www.intercom.com/customer-support-software/knowledge-base). Details on how to setup the experimental API can be found [here](https://developers.intercom.com/v2.0/docs/experimental-api)

## 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

* Fix NullPointerException: https://github.com/intercom/intercom-android/issues/423
* Update Support Library to 26.1.0
* Update FCM and GCM libraries to 11.4.0
* Fix crash when host app has Glide modules in its Manifest: https://github.com/intercom/intercom-android/issues/429
* Fix Intercom notification channels appearing when not using push notifications
* Improved image loading stability

## 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

* Update Support Library to 26.0.1
* Fix GCM issue on Android Oreo: https://github.com/intercom/intercom-android/issues/406
* Improve logging around `displayMessageComposer()`

## 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](https://github.com/intercom/intercom-android#dependency-graph)
* 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](https://github.com/intercom/intercom-android/issues/371)

## Version 3.2.10

04-08-2017
* Added native support for conversation ratings. You can read more about conversation ratings [here](https://docs.intercom.com/responding-to-users-and-visitors/see-your-team-s-progress/measure-customer-satisfaction-with-conversation-ratings).

## Version 3.2.9

04-08-2017
* Fixed NullPointerException: https://github.com/intercom/intercom-android/issues/381
* Fixed UI issues in teammate profile: https://github.com/intercom/intercom-android/issues/378
* Fixed scrolling behaviour in conversation
* Fixed unread count being incorrect after a new conversation was started
* Fixed duplicate resources: https://github.com/intercom/intercom-android/issues/385

## 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
* Support AAPT2 in Android Gradle plugin 3.0-alpha2: https://github.com/intercom/intercom-android/issues/354
* Fix full in-app messages showing twice: https://github.com/intercom/intercom-android/issues/352
* Fix NPE: https://github.com/intercom/intercom-android/issues/351
* Fix IllegalStateException: https://github.com/intercom/intercom-android/issues/347
* Improved UI performance

## 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](https://github.com/intercom/intercom-android/issues/342)
* Fixed IllegalArgumentException [#344](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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
* Updates to the active/away UI
* Fixes https://github.com/intercom/intercom-android/issues/332

## Version 3.1.2

29-03-2017
* Fixes [#325](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://developers.intercom.com/docs/android-configuration#section-update-a-user)
* 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
* Fixed NPE on some devices (https://github.com/intercom/intercom-android/issues/304)
* Fixed aliasing in some Drawables (https://github.com/intercom/intercom-android/issues/303)
* Fixed crash caused by permission issues in other apps (https://github.com/intercom/intercom-android/issues/302)
* Fixed temporary memory leak (https://github.com/intercom/intercom-android/issues/297)
* Fixed messages showing after a conversation has been read (https://github.com/intercom/intercom-android/issues/243)
* Fixed sounds playing multiple times for the same notification
* Fixed attachment upload icon being incorrectly hidden
* Improved logging for developers
* Better support for `singleTask` and `singleInstance` Activities
* Fixed incorrect delays when changing visibility of in-app notifications and launcher
* Optimised networking code
* Updated localisation

## Version 3.0.18

09-01-2017
* Fixed a warning when updating the RecyclerView data in a scroll callback https://github.com/intercom/intercom-android/issues/301
* Fixed a handler that was blocking initialization off the main thread https://github.com/intercom/intercom-android/issues/299
* Fixed an issue with a handler causing a background failure in the push service.
* Fixed showing the attachment button if the device requires the manifest permission https://github.com/intercom/intercom-android/issues/296
* Fixed an issue where not having access to the cache directory produced an NPE
* Added sample code for company custom attributes https://github.com/intercom/intercom-android/issues/293
* Added an xml public padding field to allow users to alter the position of the Intercom FAB and in-apps if it is blocking host app FABs https://github.com/intercom/intercom-android/issues/231 To update the position simply add this to your dimens.xml with the value you want to move up by `<dimen name="intercom_bottom_padding">74dp</dimen>`
* Added functionality to make sure that if the user has scrolled to the bottom of the conversation then opens the compsoer we will not hide that message

## 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
* Now supports Intercom Educate. Learn more [here](https://www.intercom.com/customer-support-software/knowledge-base)
* Networking optimisations
* Fix https://github.com/intercom/intercom-android/issues/291

## Version 3.0.14

24-11-2016
* Reduced method count by eliminating synthetic methods
* Networking optimisations

## Version 3.0.13

18-11-2016
* Updated Android Support Library to 25.0.1
* The SDK now throws a more specific exception when it is incorrectly initialised
* Fixed log message incorrectly appearing (https://github.com/intercom/intercom-android/issues/289)
* Fixed crash in some initialisation situations (https://github.com/intercom/intercom-android/issues/288)
* Fixed crash when permissions request is cancelled (https://github.com/intercom/intercom-android/issues/285)
* Fixed missing translations for the inbox empty state
* Fixed duplicate push notifications appearing (https://github.com/intercom/intercom-android/issues/261)
* Fixed crash when opening a photo attachment
* Fixed Parcelable crash

## Version 3.0.12

10-11-2016
* Fixed https://github.com/intercom/intercom-android/issues/282
* Fixed https://github.com/intercom/intercom-android/issues/281
* Fixed https://github.com/intercom/intercom-android/issues/280
* Fixed https://github.com/intercom/intercom-android/issues/279

## 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
* Fixed crash on OPPO devices https://github.com/intercom/intercom-android/issues/263
* Better logging when we can't find a launch intent for the host application
* Update translations

## 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

* Hide the soft keyboard when we open a Post message.
* Default to the host app launch activity if no URI is set in a push message.
* Fix newer API method being called on all OS versions - https://github.com/intercom/intercom-android/issues/252
* Ensure that view operations in `Intercom.client().reset()` are called on the main thread - https://github.com/intercom/intercom-android/issues/251
* Improved performance when the Messenger opens for the first time
* Fix images with links not following their link when tapped

## Version 3.0.5

01-09-2016

* Fixed an issue with GCM and FCM conflicting with other receivers [issue#246](https://github.com/intercom/intercom-android/issues/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](https://www.intercom.io/in-app-messaging).
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](https://docs.intercom.io/messenger-v3/upgrade-to-the-new-messenger-android).
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](https://github.com/intercom/intercom-android/issues/197) and [issue#136](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://www.ietf.org/rfc/rfc1123.txt) for a small number of people, more context in [issue#186](https://github.com/intercom/intercom-android/issues/186)

## Version 1.1.17

01-04-2016

* Update to fix remaining issues with registration [issue#181](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/181)
* Fixed an issue where a loading dialog could get into a state where it stayed on screen incorrectly, [issue#183](https://github.com/intercom/intercom-android/issues/183)
* Fixed an issue with the keyboard not dismissing while viewing an image, [issue#184](https://github.com/intercom/intercom-android/issues/184)

## Version 1.1.15

12-02-2016

* Fixed IndexOutOfBounds exception, [issue#176](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/164)
* Removed the remaining hard coded strings in the client, [issue#156](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/119)
* New public method setLogLevel that allows developers to control the level of logging they want and to fully disable logging [issue#112](https://github.com/intercom/intercom-android/issues/112)
* New implementation for openGCMMessage that takes the a TaskStackBuilder allowign developers to provide a backstack before we open the in-app messenger[issue#110](https://github.com/intercom/intercom-android/issues/110)
* New implementation for openGCMMessage that takes the intent and only open the in-app messenger once per push [issue#105](https://github.com/intercom/intercom-android/issues/105)

## Version 1.1.4

18-09-2015
* Updated to support Android M preview [issue#116](https://github.com/intercom/intercom-android/issues/116)
* Swallow AssertionError in AppConfig caused by GSON [issue#120](https://github.com/intercom/intercom-android/issues/120)
* Protect against NPE in CallbackHolder [issue#122](https://github.com/intercom/intercom-android/issues/122)
* Fixed an index out of bound exception [issue#113](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/109)
* Lowercased font assets names and added some better error handling for when fonts can't be made, fixes [issue#107](https://github.com/intercom/intercom-android/issues/107)
* Repackaged all of our dependencies _except_ the play services library, resolves [issue#50](https://github.com/intercom/intercom-android/issues/50)
* Fixed crash in preview service where the rootview was sometimes not inflating [issue#108](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/95)
* Fixed [issue#98](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/83)
* Fixed [issue#88](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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
  * &lt;!-- GCM REQUIRED PERMISSIONS --&gt;
  * &lt;uses-permission android:name="android.permission.WAKE_LOCK" /&gt;
  * &lt;uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" /&gt;
  * &lt;uses-permission android:name="android.permission.VIBRATE"/>
  *
  * &lt;!-- GCM Optional PERMISSIONS --&gt;
  * &lt;uses-permission android:name="android.permission.READ_PHONE_STATE"/&gt;
  * &lt;uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/&gt;
* Added audio cues to received and sent messages
* Fixed [issue#54](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/58)
* Fixed [issue#59](https://github.com/intercom/intercom-android/issues/59)
* Fixed [issue#60](https://github.com/intercom/intercom-android/issues/60)
* Fixed [issue#65](https://github.com/intercom/intercom-android/issues/65) which was causing a crash
* Fixed [issue#67](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/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](https://github.com/intercom/intercom-android/issues/55), deep links work now.
* Fixed [issue#57](https://github.com/intercom/intercom-android/issues/57) which caused a new message to never be correctly updated from the sending state to sent state.
* Fixed [issue#60](https://github.com/intercom/intercom-android/issues/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