Changelog: Twilio Conversations iOS SDK
Always access the latest documentation.
If you are interested in Mac Catalyst support, please contact support to get hands-on experience with it.
Support for previous versions of the Conversations SDKs
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.
Changelog
Conversations 3.1.0 (May 4, 2023)
Changes
- Added support for Content API
- Fixed an issue when an event about a token expiration could come twice
Conversations 3.0.0 (April 3, 2023)
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)
Changes
- Fixed an issue with accessing temporary media urls
Conversations 2.2.7 (January 30, 2022)
Changes
- Fixed a crash which could occur on setting delegate of 'TwilioConversationsClient' to 'nil'.
Conversations 2.2.6 (November 4, 2022)
Changes
- Fixed a rare crash caused by adding a
nil
key to a dictionary.
Conversations 2.2.5 (September 2, 2022)
Changes
- Fixed duplicate completion execution on client initialization with invalid token.
Conversations 2.2.4 (July 25, 2022)
Changes
- Fixed handling of URL-unsafe symbols for setting attributes and friendly name.
- Fixed a rare issue when, on destruction of the client, the
sendAndBuild
command could crash onnil
conversations limits.
Conversations 2.2.3 (June 16, 2022)
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)
Changes
- Fixed an issue causing the SDK to crash on assertions.
Conversations 2.2.1 (March 14, 2022)
Changes
- Fixed a crash that occurred when a token was updated while the network was unavailable.
Conversations 2.2.0 (March 3, 2022)
Changes
- Improved client synchronization time for users with many Conversations and Participants.
Conversations 2.1.0 (January 4, 2022)
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
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)
Changes
- Improved internal stability.
Conversations 2.0.2 (December 10, 2021) deprecated
Changes
- Fixed a crash triggered by network unavailability.
Conversations 2.0.1 (November 25, 2021)
Changes
- Dropped support for iOS 11.
- Reduced the SDK footprint.
Conversations 2.0.0 (October 19, 2021)
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 theconversationsClient: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 of50400, 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)
Changes
- 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.
Conversations 1.3.0 (March 26, 2021)
Changes
- 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.
Conversations 1.2.0 (January 19, 2021)
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)
Changes
- Fixed a bug when
conversationDeleted
doesn't come when Participant removed by other user. - Fixed a bug which could lead to client synchronisation stuck.
- Fixed a crash on accessing
participantWithIdentity
from multiple threads.
Conversations 1.1.0 (October 27, 2020)
Changes
- Added support for detailed delivery receipts. See
[Message getDetailedDeliveryReceiptsWithCompletion:]
Conversations 1.0.0 (September 28, 2020)
First public release for the new Conversations product.
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.