--- "@context": https://schema.org "@type": TechArticle "@id": https://www.twilio.com/docs/conversations-classic/ios/migrate-your-chat-ios-sdk-conversations#article headline: Migrate your Chat iOS SDK to Conversations (classic) description: Learn how to migrate your Programmable Chat iOS SDK to Conversations (classic) with guides for renaming entities and refactoring method calls. url: https://www.twilio.com/docs/conversations-classic/ios/migrate-your-chat-ios-sdk-conversations inLanguage: en dateModified: 2026-07-17T03:37:23.000Z author: "@type": Organization name: Twilio Developer Education Team publisher: "@type": Organization name: Twilio --- # Migrate your Chat iOS SDK to Conversations (classic) > \[!NOTE] > > If you are not using >=4.0.0 of our Chat SDK (or later), please follow the appropriate migration guides to get to v4+ before following this guide. This guide walks you through migrating your Programmable Chat iOS SDK to Conversations (classic). The bulk of the work is renaming entities and refactoring method calls, which this guide covers. You should also review the [companion migration guide](/docs/conversations-classic/migrating-chat-conversations) that covers the high-level changes and new APIs in Conversations (classic). ## Update your CocoaPods or Carthage dependency ## CocoaPods ```ruby # Replace pod "TwilioChatClient" # with pod "TwilioConversationsClient" ``` ## Carthage ```ruby # Replace github "twilio/twilio-chat-ios" # with github "twilio/conversations-ios" ``` ## Rename project imports ## Swift ```swift import TwilioChatClient // becomes import TwilioConversationsClient ``` ## Objective-C ```bash # import "TwilioChatClient.h" // becomes # import "TwilioConversationsClient.h" ``` ## Rename entities * `TCHTwilioChatClient` becomes `TCHTwilioConversationsClient` * `TCHChannel` becomes `TCHConversation` * `TCHMember` becomes `TCHParticipant` * `TCHClientSynchronizationStatusChannelsListCompleted` becomes `TCHClientSynchronizationStatusConversationsListCompleted` ## Refactor method calls Intermediate accessor objects were removed so your code will look cleaner. ### Client ## Swift ```swift TwilioChatClient.chatClient(withToken:properties:delegate:completion:) // becomes TwilioConversationsClient.conversationsClient(withToken:properties:delegate:completion:) ``` ## Objective-C ```bash [TwilioChatClient chatClientWithToken:properties:delegate:completion:] // becomes [TwilioConversationsClient conversationsClientWithToken:properties:delegate:completion:] ``` ### Users ## Swift ```swift TwilioChatClient.users.subscribedUser(withIdentity:completion:) // becomes TwilioConversationsClient.subscribedUser(withIdentity:completion:) ``` ## Objective-C ```bash [TwilioChatClient.users subscribedUserWithIdentity:completion:] // becomes [TwilioConversationsClient.subscribedUserWithIdentity:completion:] ``` ### Channel ## Swift ```swift Channel.member(withIdentity:) // becomes Conversation.participant(withIdentity:) ``` ## Objective-C ```bash [Channel memberWithIdentity:] // becomes [Channel participantWithIdentity:] ``` ### Channels ## Swift ```swift TwilioChatClient.channels.subscribedChannels() // becomes TwilioConversationsClient.myConversations() //------------------------------------------------------------- TwilioChatClient.channels.createChannel(options:completion:) // becomes TwilioConversationsClient.createConversation(options:completion:) //------------------------------------------------------------- TwilioChatClient.channels.channel(withSidOrUniqueName:completion:) // becomes TwilioConversationsClient.conversation(withSidOrUniqueName:completion:) ``` ## Objective-C ```bash [TwilioChatClient.channels subscribedChannels] // becomes [TwilioConversationsClient myConversations] //------------------------------------------------------------- [TwilioChatClient.channels createChannelWithOptions:completion] // becomes [TwilioConversationsClient createConversationWithOptions:completion:] //------------------------------------------------------------- [TwilioChatClient.channels channelWithSidOrUniqueName:completion] // becomes [TwilioConversationsClient conversationsWithSidOrUniqueName:completion:] ``` ### Members ## Swift ```swift Channel.members.members(completion:) // becomes Conversation.participants() //------------------------------------------------------------- Channel.members.add(byIdentity:completion:) // becomes Conversation.addParticipant(byIdentity:attributes:completion:) //------------------------------------------------------------- Channel.members.remove(_:completion:) // becomes Conversation.removeParticipant(_:completion:) ``` ## Objective-C ```bash [Channel.members membersList] // becomes [Conversation participants] //------------------------------------------------------------- [Channel.members addByIdentity:completion:] // becomes [Conversation addParticipantByIdentity:attributes:completion:] //------------------------------------------------------------- [Channel.members removeMember:completion:] // becomes [Conversation removeParticipant:completion:] ``` ### Messages ## Swift ```swift Channel.messages. sendMessage(with:completion:) // becomes Conversation.sendMessage(with:completion:) //------------------------------------------------------------- Channel.messages.removeMessage(_:completion:) // becomes Conversation.removeMessage(_:completion:) //------------------------------------------------------------- Channel.messages.getLastMessages(withCount:completion:) // becomes Conversation.getLastMessages(withCount:completion:) //------------------------------------------------------------- Channel.messages.getMessagesBefore(_:withCount:completion:) // becomes Conversation.getMessagesBefore(_:withCount:completion:) //------------------------------------------------------------- Channel.messages.getMessagesAfter(_:withCount:completion:) // becomes Conversation.getMessagesAfter(_:withCount:completion:) //------------------------------------------------------------- Channel.messages.message(withIndex:completion:) // becomes Conversation.message(withIndex:completion:) //------------------------------------------------------------- Channel.messages.message(forConsumptionIndex:completion:) // becomes Conversation.message(forReadIndex:completion:) //------------------------------------------------------------- Channel.messages.lastConsumedMessageIndex // becomes Channel.lastReadMessageIndex //------------------------------------------------------------- Channel.messages.setLastConsumedMessageIndex(_:completion:) // becomes Conversation.setLastReadMessageIndex(_:completion:) //------------------------------------------------------------- Channel.messages.advanceLastConsumedMessageIndex(_:completion:) // becomes Conversation.advanceLastReadMessageIndex(_:completion:) //------------------------------------------------------------- Channel.messages.setAllMessagesConsumedWithCompletion(_:) // becomes Conversation.setAllMessagesReadWithCompletion(_:) //------------------------------------------------------------- Channel.messages.setNoMessagesConsumedWithCompletion(_:) // becomes Conversation.setAllMessagesUnreadWithCompletion(_:) ``` ## Objective-C ```bash [Channel.messages sendMessageWithOptions:completion:] // becomes [Conversation sendMessageWithOptions:completion:] //------------------------------------------------------------- [Channel.messages removeMessage:completion:] // becomes [Conversation removeMessage:completion:] //------------------------------------------------------------- [Channel.messages getLastMessagesWithCount:completion:] // becomes [Conversation getLastMessagesWithCount:completion:] //------------------------------------------------------------- [Channel.messages getMessagesBefore:withCount:completion:] // becomes [Conversation getMessagesBefore:withCount:completion:] //------------------------------------------------------------- [Channel.messages getMessagesAfter:withCount:completion:] // becomes [Conversation getMessagesAfter:withCount:completion:] //------------------------------------------------------------- [Channel.messages messageWithIndex:completion:] // becomes [Conversation messageWithIndex:completion:] //------------------------------------------------------------- [Channel.messages messageForConsumptionIndex:completion] // becomes [Conversation messageForReadIndex:completion:] //------------------------------------------------------------- Channel.messages.lastConsumedMessageIndex // becomes Conversation.lastReadMessageIndex //------------------------------------------------------------- [Channel.messages setLastConsumedMessageIndex:completion:] // becomes [Conversation setLastReadMessageIndex:completion:] //------------------------------------------------------------- [Channel.messages advanceLastConsumedMessageIndex:completion:] // becomes [Conversation advanceLastReadMessageIndex:completion:] //------------------------------------------------------------- [Channel.messages setAllMessagesConsumedWithCompletion:] // becomes [Conversation setAllMessagesReadWithCompletion:] //------------------------------------------------------------- [Channel.messages setNoMessagesConsumedWithCompletion:] // becomes [Conversation setAllMessagesUnreadWithCompletion:] ``` ## Remove or replace unsupported methods * `Channels subscribedChannelsSortedBy` * `Channels userChannelDescriptorsWithCompletion` * `Channels publicChannelDescriptorsWithCompletion` * `Members inviteByIdentity:completion:` ## New APIs ## Swift ```swift // added Conversation.addParticipant(byAddress:proxyAddress:attributes:completion:) // added Conversation.removeParticipant(byIdentity:completion:) ``` ## Objective-C ```bash // added [Conversation addParticipantByAddress:proxyAddress:attributes:completion:] // added [Conversation removeParticipantByIdentity:completion:] ``` ## Added aggregated delivery receipts * You can get delivery receipts for each SMS or WhatsApp message to understand the current status of delivery. ## Added conversation state Conversations (classic) have state. * Added update reason `TCHConversationUpdateState`. * Get the current state of a conversation by calling `Conversation.state()` ## Rename consumptionHorizon to readHorizon * Update reasons * `TCHChannelUpdateLastConsumedMessageIndex` becomes `TCHConversationUpdateLastReadMessageIndex` * `TCHParticipantUpdateLastConsumedMessageIndex` becomes `TCHParticipantUpdateLastReadMessageIndex` * `TCHParticipantUpdateLastConsumedTimestamp` becomes `TCHParticipantUpdateLastReadTimestamp` * `Channel.getUnconsumedMessagesCountWithCompletion` becomes `Conversation.getUnreadMessagesCountWithCompletion` * `Member.lastConsumedMessageIndex` becomes `Participant.lastReadMessageIndex` * `Member.lastConsumptionTimestamp` becomes `Participant.lastReadTimestamp` * `Member.lastConsumptionTimestampAsDate` becomes `Participant.lastReadTimestampAsDate` ## Media changes There are no more streams used to download media. Instead, you'll retrieve a temporary data URL to download it. ## Swift ```swift getMediaContentTemporaryUrl(completion:) ``` ## Objective-C ```bash getMediaContentTemporaryUrlWithCompletion: ``` ## Other changes * Public conversations are unavailable for Conversations (classic) SDK, `conversationWithSidOrUniqueName` returns an error if the conversation is public. * `TCHChannelType` is removed. * Instead of removed `subscribedChannelsSortedBy` method, sort the list returned from `myConversations`. * `TCHChannelDescriptor`, `TCHUserDescriptor` were removed. Use `TCHConversation` and `TCHUser` objects instead. * Paginators were removed * Invites are not supported by Conversations (classic) SDK. Use `addParticipantByIdentity` and `addParticipantByAddress` instead. * `TCHConversationStatus` could be now either `joined` or `notParticipating`.