Chat with app users, integrate your favorite tools, and deliver a great customer experience.

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate Crisp into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'Crisp'
end

Then, run the following command:

$ pod install

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Crisp into your Xcode project using Carthage, specify it in your Cartfile:

github "crisp-im/crisp-sdk-ios"

Run carthage update to build the framework and drag the built Crisp.framework into your Xcode project.

⚠️ Adding Camera and Photo permissions is mandatory, NSCameraUsageDescription and NSPhotoLibraryUsageDescription in Info.plist, to inform your users that you need to access to the Camera and Photo Library. You also have to enable "iCloud Documents" capability

Start using Crisp by adding the following code on your AppDelegate :

import Crisp
Crisp.initialize(websiteId: "YOUR_WEBSITE_ID")

You can add the Crisp bubble by adding in your view CrispButton() :

import UIKit
import Crisp

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let crispButton = CrispButton()
        view.addSubview(crispButton)
        crispButton.bottomAnchor.constraint(equalTo: view.bottomAnchor, constant: -20).isActive = true
        crispButton.rightAnchor.constraint(equalTo: view.rightAnchor, constant: -20).isActive = true
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

You can change the main Crisp's color and texts :

Crisp.preference.setColor(.red)
Crisp.preference.setColor(def: .blue)
Crisp.preference.setColor(hex: "000000")

Enum ThemeColors :

• blue
• amber
• black
• blueGrey
• blueLight
• brown
• cyan
• green
• greenLight
• grey
• indigo
• orange
• orangeDeep
• pink
• purple
• purpleDeep
• red
• teal

Crisp.preference.setThemeText(.defaultChat)
Crisp.preference.setThemeText(string: "LOCALIZED_STRING")

Enum ThemeText :

• defaultChat
• oneChat
• twoChat
• threeChat
• fourChat

Crisp.preference.setThemeWelcome(.defaultChat)
Crisp.preference.setThemeWelcome(string: "LOCALIZED_STRING")

Enum ThemeWelcome :

• defaultChat
• oneChat
• twoChat
• threeChat
• fourChat
• fiveChat

• Setters

Crisp.user.set(email: "[email protected]")
Crisp.user.set(avatar: "http://your.website.com/user_id/size")
Crisp.user.set(nickname: "Quentin de Quelen")
Crisp.user.set(phone: "+33645XXXXXX")

• Getters

let email = Crisp.user.email
let avatar = Crisp.user.avatar
let nickname = Crisp.user.nickname
let phone = Crisp.user.phone

Open the chatbox with :

Crisp.chat.open()

Close the chatbox with :

Crisp.chat.close()

You can also check out our API Reference for more detailed information about our this SDK.

Crisp iOS SDk is owned and maintained by Crisp IM, inc. You can chat with us on crisp or follow us on Twitter at Crisp_im

Crisp iOS SDk is under Copyright license. see LICENSE for more details.