Always access the latest documentation.
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.
Twilio Conversations SDKs use Semantic Versioning. Twilio supports version N-1 for 12 months after the first GA release of version N. We recommend that you upgrade to the latest version as soon as possible to avoid any breaking changes.
Support for 1.x ceased on October 19, 2022. Please upgrade to the latest version. Support for 2.x will cease on April 3, 2024. Please upgrade to the latest version. Support for 3.x will cease on June 6, 2024. Please upgrade to the latest version.
- Fixed an issue when debugging with LLDB would become impossible after depending on the Conversations SDK.
- Fixed an issue when a client could hang during the initialization
- Participant channel type is refactored to include the actual value of
- Fixed a crash which could happen during de-initialization.
- Fixed a problem with reconnection after restoring an app from background.
Added support for Content API
- Fixed an issue when an event about a token expiration could come twice
• Reduced the SDK footprint by ~75% • Significantly improved stability by refactoring the transport layer
• Dropped support for iOS 12
- Fixed an issue with accessing temporary media urls
- Fixed a crash which could occur on setting delegate of 'TwilioConversationsClient' to 'nil'.
- Fixed a rare crash caused by adding a
nilkey to a dictionary.
- Fixed duplicate completion execution on client initialization with invalid token.
- Fixed handling of URL-unsafe symbols for setting attributes and friendly name.
- Fixed a rare issue when, on destruction of the client, the
sendAndBuildcommand could crash on
- Improved connection recovery on network failures.
- Fixed the ability to get legacy media attachments using the new multiple media API.
- Fixed an issue causing the SDK to crash on assertions.
- Fixed a crash that occurred when a token was updated while the network was unavailable.
- Improved client synchronization time for users with many Conversations and Participants.
- Added multiple media support. From now on a message can contain both text and media, and have more than one media. See
TCHConversation.limitsin the docs.
- New method to build a message:
- New property to get all media attachments from the message:
- New methods in
TwilioConversationsClientto get temporary content URLs from media and media SIDs.
TCHMessageType, and all the methods and properties related to them.
- Reduced the SDK footprint.
- Improved internal stability.
- Fixed a crash triggered by network unavailability.
- Dropped support for iOS 11.
- Reduced the SDK footprint.
- 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.
[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
- Some error messages have changed. For example, trying to leave a conversation you’re not part of will return error
50432, Participant not foundinstead 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.
- Fixed reconnection after restoring 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.
- Added possibility to set dispatch queue to get reports not from main queue, but from 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 connection could be not established after returning from background.
- The SDK now supports HTTP proxy. Proxy could be enabled by using a new flag
useProxypassed 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
deferCertificateTrustToPlatformpassed to client properties on a client creation.
- Fixed a bug when
conversationDeleteddoesn't come when Participant removed by other user.
- Fixed a bug which could lead to client synchronisation stuck.
- Fixed a crash on accessing
participantWithIdentityfrom multiple threads.
- Added support for detailed delivery receipts. See
First public release for the new Conversations product.