Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Changelog: Twilio Conversations iOS SDK



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 page anchor

Conversations 4.0.3 (December 7, 2023)

conversations-403-december-7-2023 page anchor
  • Archive(link takes you to an external page)
  • Docs(link takes you to an external page)
  • SHA-256: 967e76057156e512a73a3eea8b50f24a1989ae41fd3b0294f9710c317270714e


  • 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)

conversations-402-august-3-2023 page anchor


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

Conversations 4.0.1 (June 20, 2023)

conversations-401-june-20-2023 page anchor


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

Conversations 4.0.0 (June 6, 2023)

conversations-400-june-6-2023 page anchor

Breaking changes

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


  • 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)

conversations-310-may-4-2023 page anchor



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

Conversations 3.0.0 (April 3, 2023)

conversations-300-april-3-2023 page anchor


  • 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)

conversations-228-february-15-2023 page anchor


  • Fixed an issue with accessing temporary media URLs

Conversations 2.2.7 (January 30, 2022)

conversations-227-january-30-2022 page anchor


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

Conversations 2.2.6 (November 4, 2022)

conversations-226-november-4-2022 page anchor


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

Conversations 2.2.5 (September 2, 2022)

conversations-225-september-2-2022 page anchor


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

Conversations 2.2.4 (July 25, 2022)

conversations-224-july-25-2022 page anchor


  • 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)

conversations-223-june-16-2022 page anchor


  • 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)

conversations-222-april-4-2022 page anchor


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

Conversations 2.2.1 (March 14, 2022)

conversations-221-march-14-2022 page anchor


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

Conversations 2.2.0 (March 3, 2022)

conversations-220-march-3-2022 page anchor


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

Conversations 2.1.0 (January 4, 2022)

conversations-210-january-4-2022 page anchor


  • Added multiple media support. From now on a message can contain both text and media, and have more than one media. See TCHConversation.limits(link takes you to an external page) 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)

conversations-203-december-14-2021 page anchor


  • Improved internal stability.

Conversations 2.0.2 (December 10, 2021) deprecated

conversations-202-december-10-2021-deprecated page anchor


  • Fixed a crash triggered by network unavailability.

Conversations 2.0.1 (November 25, 2021)

conversations-201-november-25-2021 page anchor


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

Conversations 2.0.0 (October 19, 2021)

conversations-200-october-19-2021 page anchor

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)

conversations-131-april-29-2021 page anchor


  • 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)

conversations-130-march-26-2021 page anchor


  • 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)

conversations-120-january-19-2021 page anchor


  • 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)

conversations-111-november-25-2020 page anchor


  • 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)

conversations-110-october-27-2020 page anchor


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

Conversations 1.0.0 (September 28, 2020)

conversations-100-september-28-2020 page anchor

The first public release for the new Conversations(link takes you to an external page) product.

Rate this page: