Kommunicate iOS SDK for customer support

What's Changed

• Form template Issue on Smaller devices
• Fixed Generic Card issue for button
• Added Card Template Customisations
• Upgraded conversation list api to v5

What's Changed

• Clicking Notification Does not open conversation
• Added Support for Embedding Chat Widget inside a view
• Upgraded KommunicateChatUI-iOS-SDK to 0.2.6

What's Changed

• Upgraded KommunicateChatUI-iOS-SDK to 0.2.5
• Added Text To Speech Support for messages .by default TTS(Text To Speech) is disabled. You can enable it by using the below line.

Kommunicate.defaultConfiguration.enableTextToSpeechInConversation = true

What's Changed

• updated KM Chat UI to 0.2.4
• Fixed Topbar showing blank when opened from notification
• Fixed Bot typing Indicator for older conversation bug
• Fixed Rich Message Button getting cut bug

What's Changed

• Upgraded KM Chat UI to 0.2.3
• Fixed Blank message comes if handover option is added in welcome message
• Added support for setting default BotID, agentID, assignee and TeamID.Whenever customer creates a new conversation from Conversation List Screen by clicking Create new Conversation button , Conversation will be created based on this default settings. Sample Code Snippet

   Kommunicate.defaultConfiguration.defaultAssignee = "your assignee id" 
   Kommunicate.defaultConfiguration.defaultTeamId = "your team id" 
   Kommunicate.defaultConfiguration.defaultBotIds = ["botid"] // replace it with your bot Id list
   Kommunicate.defaultConfiguration.defaultAgentIds = ["agent ids"] //replace it with your assignee id list
   Kommunicate.defaultConfiguration.defaultSkipRouting = false

• Optimized Customisation -> Change message background color based on Primary color Selection on Dashboard
• Added OneTime Rating Feature
• Added Bot Typing Indicator Feature.You can delay your bot response in the conversation from here : https://dashboard.kommunicate.io/settings/chat-widget-configuration#bot-typing-indicator
• Show rating same as web chat widget.
• Added Localisation Support for the Last message of conversation which will be shown on ConversationList Screeen
• Added a function to update conversation properties: team ID, assignee and metadata. Sample Code Snippet:

Use this method to update assignee or teamId & metadata. Don't try to update assignee & teamId at the same time.
  let conversationId = "your_conversation_id"
  let assigneeId = "your_assignee_id"
  let metaData = ["key1":"value1", "key2": "key2", "key3":"value3"]

If you want to update conversation assignee, then create conversation object like this:

let conversation = KMConversationBuilder().withClientConversationId(conversationId).withConversationAssignee(assigneeId).build() If you want to update teamId & conversation meta data, then create conversation object like this:

let conversation = KMConversationBuilder().withClientConversationId(conversationId).withMetaData(metaData).withTeamId(teamId).build()

If you want to update teamId only, then create conversation object like this:

let conversation = KMConversationBuilder().withClientConversationId(conversationId).withTeamId(teamId).build() If you want to update conversation meta data only, then create conversation object like this:

let conversation = KMConversationBuilder().withClientConversationId(conversationId).withMetaData(metaData).build() after that call the updateConversation by passing above created conversation

Kommunicate.updateConversation(conversation: conversation) {response in
   switch response {
      case .success(let clientConversationId):
         print("conversation is updated successfully")
// To launch the conversation
         Kommunicate.showConversationWith(groupId: clientConversationId, from: self, completionHandler: {response in
            if response {
                print("conversation is shown")
            } else {
                print("conversation is not shown")
             }
          })
         break
      case .failure(let error):
         print("failed to update conversation")
         break
   }
}

• Deprecated Kommunicate.UpdateTeamId() function.

What's Changed

• Enable Custom Payload(through code)configuration for Prechat screen
• Realtime user Away Online status update
• Add Conversation Resolve Event Listener
• Set s3 service as the default service for upload/download images
• Update to KM Chat UI 0.2.0

What's Changed

• Added Support for PreChatLeadCollection
• Added iOS Event Listeners to watch chat widget's events
• Fixed Dynamic ReplyMeta Data issue
• Updated API endpoints
• Add support to update Team ID after conversation created
• Replaced Applozic Pods with KM Chat UI & KM Core Pods

Update SDK version to 6.3.1

Enhancements

• Update ApplozicSwift to 6.4.0
• Added support for Xcode 13 and iOS 15
• Added a password field to PreChat Form View.
• Add support to update team for existing conversation

Enhancements

• Added support to post rich message button notifications. An observer can be added for 'RichMessageButtonSelected notification as follows:

NotificationCenter.default.addObserver(self, selector: #selector(tappedButton), name: NSNotification.Name("RichMessageButtonSelected"), object: nil)```

Fixes

• Fix for launch conversation error

Enhancements

• Updated bot detail API

Enhancements

• Support for passing custom data to bot platform

Enhancements

• Moved Kommunicate folder under Sources for SPM support.
• Added support to update metadata while creating a conversation.

Enhancements

• Added Swift Package Manager support for Kommunicate.
• Added a configuration option that prevents the user from sending a message when a conversation is assigned to a bot.

  Kommunicate.kmConversationViewConfiguration.restrictMessageTypingWithBots = true
  

• Now, the conversation assignee can be updated in an existing conversation using Kommunicate.createConversation() method.
• Feedback input option will be shown every time when a conversation is resolved.

Enhancements

• Now, we'll show/hide away message on agent change.
• Message style options like font will be applied to HTML messages as well.

Fixes

• Fixed an issue where character limit was not shown when a conversation is assigned to a Dialogflow bot.

Enhancements

• Added an option to set the regex for validating phone number in the pre-chat view.

• Added config options to show and make certain fields mandatory in the pre-chat view.

  let preChatVC = KMPreChatFormViewController(configuration: Kommunicate.defaultConfiguration)
  var preChatConfig = KMPreChatFormViewController.PreChatConfiguration()
  preChatConfig.optionsToShow = [.name, .phoneNumber] // Set all the fields that will be shown to the user
  preChatConfig.mandatoryOptions = [.phoneNumber] // Set all the fields that are mandatory
  preChatConfig.allowEmailOrPhoneNumber = false
  preChatConfig.phoneNumberRegexPattern = "\\d{2}" // Set phone number validation pattern
  preChatVC.preChatConfiguration = preChatConfig
  preChatVC.delegate = self // set the delegate to self to receive callbacks
  self.present(preChatVC, animated: false, completion: nil) // To present
  

• Added an option to change the number of lines of the card template's description label.

Enhancements

• Added an option to set the team ID when creating a new conversation.

   let kmConversation = KMConversationBuilder()
        .withTeamId("<pass a team ID>")
        .useLastConversation(false)
        .build()
  
    Kommunicate.createConversation(conversation: kmConversation) { result in
        switch result {
        case .success(let conversationId):
            print("Conversation id: ",conversationId)
            // Launch conversation
        case .failure(let kmConversationError):
            print("Failed to create a conversation: ", kmConversationError)
        }
    }
  

• Now, images in image rich message(template ID = 9) can be tapped and previewed just like normal attachment messages.

Enhancements

• Updated default value of primary color and sent message's text color to match the web plugin colors.

Fixes

• Fixed an issue where message part of the quick reply and form template was getting truncated from the bottom.

Enhancements

• Added a check for whitespace and newline characters in the user ID.
• Added an option to show/hide different message menu options. [ALS]

  Kommunicate.defaultConfiguration.messageMenuOptions = [.copy]
  

• Now, chat bar's attachment color config will be applied to the bottom part of the chat bar as well. [ALS]

  Kommunicate.defaultConfiguration.chatBarAttachmentViewBackgroundColor = .cyan
  

Enhancements

• Added an option to launch a conversation with conversation list in the background.
• Added message character limit to limit the number of characters in a message.
• Now, conversation feedback from the SDK will be shown in the Dashboard.
• Now, time and state will be shown in the 'all buttons' rich message template.
• Enabled screen transition animations in all the screens.

Fixes

• Fixed an issue where the back button in Conversation screen was not updating in RTL.

Enhancements

• Added support for setting a pre-filled message before launching a chat.
• Added support for language change rich message.
• Enabled document sharing in the default configuration.
• Added send message API for sending text and rich messages.
• Added config options for changing text view’s text and placeholder style. [ALS]
• Added date picker and text validation support in form template. [ALS]
• New Photos UI for iOS 14+ devices to send images/videos without giving full access to the library. [ALS]

Fixes

• Fixed an issue where button tap in form template was not working in iOS 14. [ALS]
• Now, sender's profile image and name will be shown in all buttons rich message template. [ALS]
• Fixed an issue where the empty chat list screen was half white and half gray in iOS 14. [ALS]

Enhancements

• Now, you can enable/disable CSAT from the Dashboard, and it will reflect in your App.
• Support for sharing photos saved on iCloud. [ALS]

Enhancements

• Added a message character limit that will be shown if the conversation is assigned to a Dialogflow bot.

Enhancements

• Added support for showing Agent's away status.
• Added document sharing support. [ALS]

Fixes

• In createConversation() method, clientConversationId will be used even when the single thread option is enabled.
• Fixed an issue where only dashboard option for single thread conversation was used, not the one that was passed locally.
• Now, if agentIds are passed in the createConversation() method, then the default agent won't be added.

Fixes:

• Fixed an issue related to attachment download failing in some cases. [ALS]
• Fixed an issue where incorrect form data was sent when multiple form(filled) messages are in same thread. [ALS]

Enhancements

• Added form template support in the rich messages.

Fixes

• Fixed audio play issue that occurred when conversation threads were switched via a notification.

Enhancements

• Migrated to Swift 5.

Fixes

• Fixed an issue where, in some cases, conversation did not switch correctly when we opened it through a notification.
• Fixed an issue where changing tint color through UIAppearance was not working in case of directly launching a conversation thread.
• Fixed JSON parsing error in app settings response.

Enhancements

• A single conversation thread will be created if it's enabled in the dashboard.
• The primary color can now be changed from the dashboard settings.