Customization

Theme Customization

In this section we have explained about the configuration options present in the SDK to modify color, font etc.

You can override any of the properties from the default configuration. Doing it in your AppDelegate is preferred.

Conversation Screen Background Color

Background color of the Conversation screen

Kommunicate.defaultConfiguration.backgroundColor = UIColor.white

Received Message Background Color

The background color of the received message bubble.

KMMessageStyle.receivedBubble.color = UIColor.lightGray

Sent Message Background Color

The background color of the sent message bubble.

KMMessageStyle.sentBubble.color = UIColor.lightGray

Message Text Font and Color

Use this for changing message text font and color in the Conversation screen.

KMMessageStyle.message = Style(font: UIFont.systemFont(ofSize: 14), text: UIColor.black)

Navigation Bar's Background Color

The navigation bar's background color in all the screens.

Kommunicate.defaultConfiguration.navigationBarBackgroundColor = UIColor.navigationOceanBlue()

Navigation Bar's Tint color

Use this for changing colors of buttons on navigation bar like back button.

Kommunicate.defaultConfiguration.navigationBarItemColor = UIColor.navigationTextOceanBlue()

Navigation Bar's Title color

The navigation bar's title color.

Kommunicate.defaultConfiguration.navigationBarTitleColor = UIColor.black

FAQ Button

To hide the FAQ button in Conversation List or Conversation screen, use below setting

Kommunicate.defaultConfiguration.hideFaqButtonInConversationList = true // Hide from Conversation List screen
Kommunicate.defaultConfiguration.hideFaqButtonInConversationView = true // Hide from Conversation screen

Attachment Options

To hide all the attachment options(gallery, camera, video and location), use optionsToShow config as shown below. All will be shown by default.

// To hide all the attachment options
Kommunicate.defaultConfiguration.chatBar.optionsToShow = .none

// If you want to show just two attachment options
Kommunicate.defaultConfiguration.chatBar.optionsToShow = .some(options: [.camera, .location])

// If you want to show all attachment options then use this
Kommunicate.defaultConfiguration.chatBar.optionsToShow = .all

We also have the option to record and send an audio message. To hide this option use hideAudioOptionInChatBar config.

Kommunicate.defaultConfiguration.hideAudioOptionInChatBar = true

Sending additional metadata with messages

If you want to send additional metadata with all the messages(sent from a device) then use messageMetadata config in your AppDelegate like this:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    let messageInfo = ["custom-key": "value"]
    do {
        let messageInfoData = try JSONSerialization.data(withJSONObject: messageInfo, options: .prettyPrinted)
        let messageInfoString = String(data: messageInfoData, encoding: .utf8) ?? ""

        Kommunicate.defaultConfiguration.messageMetadata = ["info": messageInfoString]
    } catch {
        print(error)
    }
    return true
}

Pass custom data to bot platform

To pass custom data with all the messages to the bot platform, use updateChatContext config as shown below:

let messageInfo = ["custom-key": "value"]
do {
    try Kommunicate.defaultConfiguration.updateChatContext(with: messageInfo)
} catch {
    print("Failed to update chat context: ", error)
}

Make your bot multilingual

If you want to set a user's language(to get bot replies in that language), then use updateUserLanguage config as shown below:

do {
    try Kommunicate.defaultConfiguration.updateUserLanguage(tag: "fr")
} catch {
    print("Failed to update user language: ", error)
}