Menu

Expand
Rate this page:

Changelog: Twilio Conversations iOS SDK

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.

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. Support for 3.x will cease on June 6, 2024. Please upgrade to the latest version.

Changelog

Conversations 4.0.2 (August 3, 2023)

  • Archive
  • 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
  • Docs
  • SHA-256: abb2f5cecade556ba73b8c1b2a944b6e04bb248d532263e1984988fe5158735a
Сhanges
  • Fixed an issue when a client could hang during the initialization

Conversations 4.0.0 (June 6, 2023)

  • Archive
  • Docs
  • SHA-256: d5b8364c50f647f5317c27c0b193a42e7f88d54972cb6d49a1fc756abcb0351d
Braking 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
  • Docs
  • SHA-256: 5a0c42f098d897d350e01869888b77561d4ae20e31d055879580e6300b583b0e

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

  • Archive
  • 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
  • Docs
  • SHA-256: 740d8093d2c70d68be4acc1533e2d2a28f4ffbd445017c2ee83d9027d964b4a0
Changes
  • Fixed an issue with accessing temporary media urls

Conversations 2.2.7 (January 30, 2022)

  • Archive
  • Docs
  • SHA-256: 349fc438f3e3700168df7644fdd0384fb6743b71da32cafa8736485434391738
Changes
  • Fixed a crash which could occur on setting delegate of 'TwilioConversationsClient' to 'nil'.

Conversations 2.2.6 (November 4, 2022)

  • Archive
  • 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
  • Docs
  • SHA-256: 2266164130e69bc3a7a4a99403302c449d86a3b02d291b92396738f36eabe604
Changes
  • Fixed duplicate completion execution on client initialization with invalid token.

Conversations 2.2.4 (July 25, 2022)

  • Archive
  • Docs
  • SHA-256: 5c1a79ee70b1848b00db2308ab7df4706cbe3c5cf172b64f6e4739eb09670d9a
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 on nil conversations limits.

Conversations 2.2.3 (June 16, 2022)

  • Archive
  • 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
  • Docs
  • SHA-256: 7f36b67c052b79d29fb62b2baf73a8be596f748049bd88c87e3227a356d8a54c
Changes
  • Fixed an issue causing the SDK to crash on assertions.

Conversations 2.2.1 (March 14, 2022)

  • Archive
  • 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
  • Docs
  • SHA-256: b7812b0c61b141d27d5e92885f98fc84c1ab31c652b82088e6d30953ba655f2e
Changes
  • Improved client synchronization time for users with many Conversations and Participants.

Conversations 2.1.0 (January 4, 2022)

  • Archive
  • 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 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
  • Docs
  • SHA-256: 59c2be6a849153b4815b498eab62c8f5980045f068820485ddcc44ca9e5399ee
Changes
  • Improved internal stability.

Conversations 2.0.2 (December 10, 2021) deprecated

  • Archive
  • Docs
  • SHA-256: c5b5a081f79fd8672597c319c916e9a98e14f88ce7b00e81718cb04c950ff66d
Changes
  • Fixed a crash triggered by network unavailability.

Conversations 2.0.1 (November 25, 2021)

  • Archive
  • Docs
  • SHA-256: d4c5f52072edcbb0e6f1b96c946c565b8196d669a60703da6763bf299957d8eb
Changes
  • Dropped support for iOS 11.
  • Reduced the SDK footprint.

Conversations 2.0.0 (October 19, 2021)

  • Archive
  • 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
  • Docs
  • SHA-256: 9173516f6158c2a4009956cc1f680cc99bb4c3f3160ac52fd513023f762bf6f1
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)

  • Archive
  • Docs
  • SHA-256: 49a32dc1a28a1701279f82c2d60878d5b51c3cb31340f23708a2fa217c9e8746
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)

  • Archive
  • 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
  • Docs
  • SHA-256: 09f63c1562eb63c84c456dfc77df46648bcc00f1fbf97b8dd19cfe72cab53998
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)

  • Archive
  • Docs
  • SHA-256: c6643e75f9f594bfad54a414649c878b30023194a732b9f1e1dbf965d47ab338
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.

  • Archive
  • Docs
  • SHA-256: 1b3e842beff47716c9e959c87dc9958a314b75d7b0c98b48da58657df37a79eb
Rate this page:

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.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

thanks-feedback-gif