# Changelog: Twilio Conversations iOS SDK

* Latest release [documentation](https://sdk.twilio.com/ios/conversations/latest/docs/).
* All releases are also available through [GitHub Releases](https://github.com/twilio/conversations-ios/releases).
* [Versioning and Support Lifecycle](/docs/conversations/versioning-and-support-lifecycle).

> \[!NOTE]
>
> If you are interested in Mac Catalyst support, it will be enabled for iOS SDKs starting with 4.1.0. You can then build Mac Catalyst applications using this SDK.

## Changelog

### Conversations 4.0.5 *(August 11, 2025)*

* [Archive](https://github.com/twilio/conversations-ios/releases/download/v4.0.5/twilio-conversations-ios-4.0.5.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/4.0.5/docs/)
* SHA-256: `3a6f6060bd362f2a4590eb7b0b0910e2a54138321234cd25b33547dcca6c2bfc`

**Changes:**

* Added privacy manifest files

**Fixes:**

* Improved `updateToken` implementation to prevent crashes.

***

### Conversations 4.0.4 *(June 28, 2024)*

* [Archive](https://github.com/twilio/conversations-ios/releases/download/v4.0.4/twilio-conversations-ios-4.0.4.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/4.0.4/docs/)
* SHA-256: `1618f23905fa14a6e028e86b3521d0537a91af7664efc2061d8ea536c80154dd`

**Changes:**

* Added the `synchronizeOnStartup` client option (defaults to `true`) and the `synchronizeConversations()` method to let you manually synchronize conversations after the SDK starts.

**Fixes:**

* Fixed race conditions and enhanced memory management.

***

### Conversations 4.0.3 *(December 7, 2023)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/4.0.3/twilio-conversations-ios-4.0.3.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/4.0.3/docs/)
* SHA-256: `967e76057156e512a73a3eea8b50f24a1989ae41fd3b0294f9710c317270714e`

**Fixes:**

* Fix one of the crashes on shutdown.
* Fix ordering when processing incoming messages, should make shutdown more reliable, also fix other races.
* Misc bugfixes.

***

### Conversations 4.0.2 *(August 3, 2023)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/4.0.2/twilio-conversations-ios-4.0.2.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/4.0.2/docs/)
* SHA-256: `98985d967aeaa1cb1fbe26562e478e63aba62fce0afd22f73803d7ad1892c915`

**Fixes:**

* Fixed an issue when debugging with LLDB would become impossible after depending on the Conversations SDK.

***

### Conversations 4.0.1 *(June 20, 2023)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/4.0.1/twilio-conversations-ios-4.0.1.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/4.0.1/docs/)
* SHA-256: `abb2f5cecade556ba73b8c1b2a944b6e04bb248d532263e1984988fe5158735a`

**Changes:**

* Fixed an issue when a client could hang during the initialization

***

### Conversations 4.0.0 *(June 6, 2023)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/4.0.0/twilio-conversations-ios-4.0.0.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/4.0.0/docs/)
* SHA-256: `d5b8364c50f647f5317c27c0b193a42e7f88d54972cb6d49a1fc756abcb0351d`

**Breaking changes**

* Participant channel type is refactored to include the actual value of `other` channel type.

**Changes:**

* Fixed a crash which could happen during de-initialization.
* Fixed a problem with reconnection after restoring an app from background.

***

### Conversations 3.1.0 *(May 4, 2023)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/3.1.0/twilio-conversations-ios-3.1.0.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/3.1.0/docs/)
* SHA-256: `5a0c42f098d897d350e01869888b77561d4ae20e31d055879580e6300b583b0e`

**Changes:**

* Added support for [Content API](/docs/content)

**Fixes:**

* Fixed an issue when an event about a token expiration could come twice

***

### Conversations 3.0.0 *(April 3, 2023)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/3.0.0/twilio-conversations-ios-3.0.0.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/3.0.0/docs/)
* SHA-256: `4daf448d037eb2e3765016d066618d9d43259e297203bb79ee472d36d9519ef3`

**Changes:**

* Reduced the SDK footprint by \~75%
* Significantly improved stability by refactoring the transport layer

**Breaking changes**

* Dropped support for iOS 12

***

### Conversations 2.2.8 *(February 15, 2023)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.8/twilio-conversations-ios-2.2.8.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.8/docs/)
* SHA-256: `740d8093d2c70d68be4acc1533e2d2a28f4ffbd445017c2ee83d9027d964b4a0`

**Changes:**

* Fixed an issue with accessing temporary media URLs

***

### Conversations 2.2.7 *(January 30, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.7/twilio-conversations-ios-2.2.7.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.7/docs/)
* SHA-256: `349fc438f3e3700168df7644fdd0384fb6743b71da32cafa8736485434391738`

**Changes:**

* Fixed a crash that could occur on setting the delegate of 'TwilioConversationsClient' to 'nil'.

***

### Conversations 2.2.6 *(November 4, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.6/twilio-conversations-ios-2.2.6.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2./docs/)
* SHA-256: `e9fb471aeb874236f4e08f54e2d393f8dd01746226e2d9dc9e7e9124de648c03`

**Changes:**

* Fixed a rare crash caused by adding a `nil` key to a dictionary.

***

### Conversations 2.2.5 *(September 2, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.5/twilio-conversations-ios-2.2.5.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.5/docs/)
* SHA-256: `2266164130e69bc3a7a4a99403302c449d86a3b02d291b92396738f36eabe604`

**Changes:**

* Fixed duplicate completion execution on client initialization with an invalid token.

***

### Conversations 2.2.4 *(July 25, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.4/twilio-conversations-ios-2.2.4.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.4/docs/)
* SHA-256: `5c1a79ee70b1848b00db2308ab7df4706cbe3c5cf172b64f6e4739eb09670d9a`

**Changes:**

* Fixed handling of URL-unsafe symbols for setting attributes and friendly names.
* Fixed a rare issue when, on destruction of the client, the `sendAndBuild` command could crash on `nil` conversations limits.

***

### Conversations 2.2.3 *(June 16, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.3/twilio-conversations-ios-2.2.3.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.3/docs/)
* SHA-256: `a3ce80c009f1391cd9dc92dbe0733d89c44a9bf5e6efe1ee2f65ba39a973560b`

**Changes:**

* Improved connection recovery on network failures.
* Fixed the ability to get legacy media attachments using the new multiple media API.

***

### Conversations 2.2.2 *(April 4, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.2/twilio-conversations-ios-2.2.2.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.2/docs/)
* SHA-256: `7f36b67c052b79d29fb62b2baf73a8be596f748049bd88c87e3227a356d8a54c`

**Changes:**

* Fixed an issue causing the SDK to crash on assertions.

***

### Conversations 2.2.1 *(March 14, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.1/twilio-conversations-ios-2.2.1.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.1/docs/)
* SHA-256: `5bec7f7f1785427d2db5eb14d6fad1c9397ec38e032e87dfd243d2d2fc4f87bf`

**Changes:**

* Fixed a crash that occurred when a token was updated while the network was unavailable.

***

### Conversations 2.2.0 *(March 3, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.2.0/twilio-conversations-ios-2.2.0.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.2.0/docs/)
* SHA-256: `b7812b0c61b141d27d5e92885f98fc84c1ab31c652b82088e6d30953ba655f2e`

**Changes:**

* Improved client synchronization time for users with many Conversations and Participants.

***

### Conversations 2.1.0 *(January 4, 2022)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.1.0/twilio-conversations-ios-2.1.0.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.1.0/docs/)
* SHA-256: `23698b743b7325b58c50f98dd8b3aed7bab432ec3dfa72b5bd695992a90f90e5`

**Changes:**

* Added multiple media support. From now on a message can contain both text and media, and have more than one media. See [`TCHConversation.limits`](https://sdk.twilio.com/ios/conversations/releases/2.1.0/docs/Classes/TCHConversation.html#//api/name/limits) in the docs.
* New method to build a message: `[TCHConversation prepareMessage]`.
* New property to get all media attachments from the message: `attachedMedia`.
* New methods in `TwilioConversationsClient` to get temporary content URLs from media and media SIDs.
* Deprecated `TCHMessageOptions`, `TCHMessageType`, and all the methods and properties related to them.
* Reduced the SDK footprint.

***

### Conversations 2.0.3 *(December 14, 2021)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.0.3/twilio-conversations-ios-2.0.3.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.0.3/docs/)
* SHA-256: `59c2be6a849153b4815b498eab62c8f5980045f068820485ddcc44ca9e5399ee`

**Changes:**

* Improved internal stability.

***

### Conversations 2.0.2 *(December 10, 2021)* **deprecated**

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.0.2/twilio-conversations-ios-2.0.2.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.0.2/docs/)
* SHA-256: `c5b5a081f79fd8672597c319c916e9a98e14f88ce7b00e81718cb04c950ff66d`

**Changes:**

* Fixed a crash triggered by network unavailability.

***

### Conversations 2.0.1 *(November 25, 2021)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.0.1/twilio-conversations-ios-2.0.1.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.0.1/docs/)
* SHA-256: `d4c5f52072edcbb0e6f1b96c946c565b8196d669a60703da6763bf299957d8eb`

**Changes:**

* Dropped support for iOS 11.
* Reduced the SDK footprint.

***

### Conversations 2.0.0 *(October 19, 2021)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/2.0.0/twilio-conversations-ios-2.0.0.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/2.0.0/docs/)
* SHA-256: `5becd6a60b0c8a3cccfff015a12b44dee66096a075c7c213ff3968cebc60b462`

**Breaking changes**

* **Major under-the-hood improvement** (the "Sessionless" protocol). This improvement is designed primarily for improved reliability. While this is not a breaking code change, it does carry a meaningful impact on timing:
  * SDK commands will return success or failure up to \~10% more quickly than before.
  * **Real-time updates of data are now likely to arrive after the command completes**. For example, `[TCHConversation setAttributes]` will invoke completion (i.e., success) while `[TCHConversation attributes]` still returns the old value.
    To see the new value, we recommend waiting for an update event, e.g., in the `conversationsClient:conversation:updated:``TCHConversationUpdateAttributes` delegate.
* Some error messages have changed. For example, trying to leave a conversation you're not part of will return error `50432, Participant not found` instead of `50400, User not member of channel`.
* `[TCHMessageOptions withAttributes]` is simplified. It does not take a completion callback anymore, and returns an error if it failed to set any attributes.

***

### Conversations 1.3.1 *(April 29, 2021)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/1.3.1/twilio-conversations-ios-1.3.1.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/1.3.1/docs/)
* SHA-256: `9173516f6158c2a4009956cc1f680cc99bb4c3f3160ac52fd513023f762bf6f1`

**Changes:**

* Fixed reconnection after restoring the application from background. The issue was introduced in 1.2.0, and users are highly encouraged to upgrade to this version to avoid experiencing disconnection problems.

***

### Conversations 1.3.0 *(March 26, 2021)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/1.3.0/twilio-conversations-ios-1.3.0.zip)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/1.3.0/docs/)
* SHA-256: `49a32dc1a28a1701279f82c2d60878d5b51c3cb31340f23708a2fa217c9e8746`

**Changes:**

* Added the possibility to set dispatch queue to get reports not from the main queue, but from the selected one.
* Added support of XCFramework with arm64 simulator.
* Added support for SPM.
* Removed support of Carthage until it supports binary XCFrameworks.
* Fixed an issue when a connection could be not established after returning from background.

***

### Conversations 1.2.0 *(January 19, 2021)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/1.2.0/twilio-conversations-ios-1.2.0.tar.bz2)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/1.2.0/docs/)
* SHA-256: `2d779f576b9cbdf032bc6438bfa7087c4918882085540744de0f665ffc842389`

**Changes:**

* The SDK now supports HTTP proxy. Proxy could be enabled by using a new flag `useProxy` passed to client properties on a client creation. Settings read from the system configuration.
* Added ability to defer certificates check to the OS (disable pinning) using new flag `deferCertificateTrustToPlatform` passed to client properties on a client creation.

***

### Conversations 1.1.1 *(November 25, 2020)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/1.1.1/twilio-conversations-ios-1.1.1.tar.bz2)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/1.1.1/docs/)
* SHA-256: `09f63c1562eb63c84c456dfc77df46648bcc00f1fbf97b8dd19cfe72cab53998`

**Changes:**

* Fixed a bug when `conversationDeleted` doesn't come when the Participant is removed by another user.
* Fixed a bug that could lead to client synchronization stuck.
* Fixed a crash on accessing `participantWithIdentity` from multiple threads.

***

### Conversations 1.1.0 *(October 27, 2020)*

* [Archive](https://sdk.twilio.com/ios/conversations/releases/1.1.0/twilio-conversations-ios-1.1.0.tar.bz2)
* [Docs](https://sdk.twilio.com/ios/conversations/releases/1.1.0/docs/)
* SHA-256: `c6643e75f9f594bfad54a414649c878b30023194a732b9f1e1dbf965d47ab338`

**Changes:**

* Added support for detailed delivery receipts. See `[Message getDetailedDeliveryReceiptsWithCompletion:]`

***

### Conversations 1.0.0 *(September 28, 2020)*

The first public release for the new [Conversations](https://www.twilio.com/en-us/messaging/conversations-api) product.

* [Archive](https://sdk.twilio.com/ios/convo/releases/1.0.0/twilio-convo-ios-1.0.0.tar.bz2)
* [Docs](https://sdk.twilio.com/ios/convo/releases/1.0.0/docs/)
* SHA-256: `1b3e842beff47716c9e959c87dc9958a314b75d7b0c98b48da58657df37a79eb`
