How to Build an E-commerce Chat for iOS App with Swift

Rajeshwari Published On December 17th, 2024 Tech Talks

In this article, you’ll learn how to build an ecommerce chat app for iOS using MirrorFly’s swift chat SDKs. At the end of this guide, you will be able to connect the sellers, buyers, and other stakeholders in your online marketplace business via in-app chat.

n completing the steps instructed, you will now have a completely built iOS chat app for Ecommerce that is similar to the below screenshot:

Prerequisites

To create an ecommerce app in iOS using swift, you will need, you will need 

• Development Environment: Xcode 13+
• Programming Language: Swift 5.0+
• Platform: iOS 13+
• In App SDKs: MirrorFly Video SDKs

Note: If you’d like to build the swift ecommerce chat on our sample app, you can check out our GitHub repositories.

Steps to integrate MirrorFly chat SDKs for e-commerce apps in iOS with Swift

Step 1: Create a New Xcode Project

• Launch Xcode on your device
• Create a new project or open an existing project
• From the Template grids, choose SingleView App

• A form page will open. Fill in all the required fields and configure your project. 

Step 2: Get the MirrorFly License Key

A license key is needed for the server to authenticate your SDK. To acquire one, you’ll need an account with MirrorFly

• Signup with MirrorFly and complete the account setup process
• After verification, log in to your MirrorFly Account
• From the Account Overview page, download the iOS SDK file

Step 3: MirrorFly SDK Integration

1. Add the following ChatSDK pod to your Podfile. If the pod hasn’t been initialized yet, create a Podfile by executing the pod init command.

pod 'MirrorFlySDK', '5.12.0'

2. Add the below-given pod hook code block at the end of the pod file and thus, finally install the pods by executing the pod install command.

post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.1'
config.build_settings['ENABLE_BITCODE'] = 'NO'
config.build_settings['APPLICATION_EXTENSION_API_ONLY'] = 'No'
config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulators*]'] = 'arm64'
config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
end
end
end

3. Now, disable the bitcode for your project

Goto Project -> Build Settings -> Filter the term `Bitcode` -> and select No from the dropdown

4. Initiate and add the pod hook block at the end of the pod file as mentioned below. And then, continue to install the pods.

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.1'
      config.build_settings['ENABLE_BITCODE'] = 'NO'
      config.build_settings['APPLICATION_EXTENSION_API_ONLY'] = 'No'
      config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
    end
  end
end

5.  Configure The Capabilities For Your E-commerce Chat App 

• Go to Project
• Click on Target  
• Choose Signing & Capabilities
• Click ‘+’ at the top left corner 
• Search for the capabilities: App groups and Background Mode
• Right under Background Mode, you need to enable the below capabilities:
  • Audio, Airplay, and Picture in Picture
  • Remote notifications
  • Background fetch

Step 4: Configure the MirrorFly SDK Server & Data 

• In this step, you need to add the details including the License key (downloaded in Step 1), and configure the server. This action will take you a step closer to adding chat functionality for user messaging in your ecommerce app. 
• Add the necessary server information to the AppDelegate class.

let LICENSE_KEY = "xxxxxxxxxxxxxxxxxxxxxx"

Step 5: Initialization of Chat SDK

• Provide the basic data needed to build the messaging SDK

• Further, use the AppDelegate class within the didFinishLaunchingWithOptions method.

ChatSDK.Builder.setAppGroupContainerID(containerID: CONTAINER_ID)

      .setLicenseKey(key: LICENSE_KEY)
      .isTrialLicense(isTrial: true)
      .setDomainBaseUrl(baseUrl: BASE_URL)
      .buildAndInitialize()

Step 6: User Registration

To register a user in the sandbox mode or in the live mode, use the below method in the ChatSDK.Builder class

try! ChatManager.registerApiService(for:  USER_IDENTIFIER ) { isSuccess, flyError, flyData in
        var data = flyData
        if isSuccess {
         // This is your Password
           guard let password = data["password"] as? String else{
               return
           }
           // This is your Username
           guard let username = data["username"] as? String else{
               return
           }
        }else{
            let error = data.getMessage()
            print("#chatSDK \(error)")
        }
    }

Step 7: Connect the Chat SDK to the MirrorFly Server

A server connection is needed to send or receive messages within your Ecommerce Chat App. To establish the connection, use the below method:

ChatManager.connect()

Step 8: Disconnect the Chat Server

To disconnect the connection between the chat server and the SDK, you need to call the below method:

ChatManager.disconnect()

Step 9: Add One-to-One Chat 

Send one-to-one Chat:

You need to use the below method to send one-to-one messages:

FlyMessenger.sendTextMessage(TO_JID, TEXT) { isSuccess,error,chatMessage in
     if isSuccess {
        // Update the UI
     }else{
        // Handle the error
     }
 }

Receive One-to-one Messages

To see other incoming messages, you need to set the delegate in your ViewController’s viewDidAppear method and confirm the MessageEventsDelegate class.

  ChatManager.shared.messageEventsDelegate = self

After setting up the delegate, you will start receiving incoming messages from other SDK users.

func onMessageReceived(message: ChatMessage, chatJid: String) {
      // Message received from chatJid, content is message.messageTextContent
}

Step 10: Add Group Chat Feature For Messaging On Your E-commerce Chat App

You can create groups for the stakeholders in your business to drive more engagement and transactions. The following steps will guide you through. 

Prepare the Group Chat jid

To prepare the group JID. FlyUtils.getGroupJid(groupId : String), the SDK provides the below utility method.

FlyUtils.getGroupJid(groupId : String)

Group Creation

In order to create a group, you need to call the below method

GroupManager.shared.createGroup(groupName: "ABCXYZ", participantJidList: [jids], groupImageFileUrl: "", completionHandler: { [self] isSuccess, flyError, flyData in
    if isSuccess {
        // Update the UI
    } else{
        // failure case of the group creation
    }
})

Create the Group Profile

From the server or local, you need to get a group profile using the below method.

GroupManager.shared.getGroupProfile(groupJid: groupId, fetchFromServer: fromServer, completionHandler: { isSuccess, flyError, flyData in
    if isSuccess {
        let data =  (flyData.getData() as?
        ProfileDetails)
        // Update the UI
    } else{
        // failure case of get group profile
    }
})

Get the Participants List

You need to call the below method to get the group members from the server

GroupManager.shared.getParticipants(groupJID: groupId)

Add Participants to a Group

You need to call the below method to add new particpants to a group in your eCommerce chat app. 

GroupManager.shared.addParticipantToGroup(groupId: groupId, newUserJidList: selectedItemArray) { isSuccess, flyError, flyData in
    if isSuccess {
       // Update the UI
    } else{
       // failure cases
    }

Remove Participants from a Group 

Call the below method to remove a participant from your ecommerce chat app group

GroupManager.shared.removeParticipantFromGroup(groupId: groupId, removeGroupMemberJid: userJid) { isSuccess, flyError, flyData in
    if isSuccess {
        // Update UI
    } else{
        // failure cases
    }
}

Get Groups 

In order to get the groups from local or server, you need to call the below method

GroupManager.shared.getGroups(fetchFromServer: true) { isSuccess, flyError, flyData in
    var data  = flyData
    if isSuccess {
        // Update UI
    } else{
        // failure cases
    }
}

Call the below method to add or update the group image

GroupManager.shared.updateGroupProfileImage(groupJid: groupId, groupProfileImageUrl: selectPath, completionHandler: { isSuccess, flyError, flyData in
    if isSuccess {
       // Update UI
    } else{
       // failure case
    }
})

Removal of Group Image

Call the below method to remove the group image using swift in your ecommerce app

GroupManager.shared.removeGroupProfileImage(groupJid: groupId, completionHandler: { isSuccess, flyError, flyData in
    if isSuccess {
        // Updat UI in success case
    } else{
        // failure case
    }
})

Group Name Update

In order to update a group image, you need to call the below method

GroupManager.shared.updateGroupName(groupJid: groupId, groupName: "Changing Group Name wXyZ 123", completionHandler: { isSuccess, flyError, flyData in
    if isSuccess {
        // Update UI
    } else{
        // failure case
    }
})

Give Admin Control to a Participant in your eCommerce Chat App 

Call the below method to make a participant an admin.

GroupManager.shared.makeAdmin(groupJid: groupId, userJid: userJid, completionHandler: { isSuccess, flyError, flyData in
    if isSuccess {
        // update UI
    } else{
        // failure case
    }
})

Exit from Group

For a participant to exit from a group, you need to call the below method:

GroupManager.shared.leaveFromGroup(groupJid: groupId, userJid: userJid, completionHandler: { isSuccess, flyError, flyData in
    if isSuccess {
        // update UI
    } else{
        // failure case
    }
})

Delete a Group 

To delete a group in your Ecommerce Chat App, call the below method.

GroupManager.shared.deleteGroup(groupJid: groupId, completionHandler: { isSuccess, flyError, flyData in
    if isSuccess {
        // update UI
    } else{
        // failure case
    }
})

Congratulations!

You’ve successfully built an iOS ecommerce chat app using MirrorFly’s SDKs. Your app is now capable of connecting people across your marketplace business via instant group messages. 

To learn more about personalizing the theme, color, style, and fonts of your in-app chat, you can check out our guide to customizing in-app chat with MirrorFly UI Kit. Besides this, if you are interested in building a self-managed chat solution, talk to our experts.

Comment below what other features you’d like to add to your app. My team and I will work on it shortly and get back to you with interesting in-app chat guides. Until then, happy coding!

Frequently Asked Questions (FAQ)