Embed the Best-in-Class Live Chat for your iOS apps with Customerly Live Chat mobile SDK
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Customerly.xcodeproj
Customerly.xcworkspace
CustomerlyDemo
CustomerlyDemoUITests
CustomerlySDK
CustomerlySDKTests
Pods
.swift-version
CustomerlySDK.podspec
LICENSE
Podfile
Podfile.lock
README.md

README.md

Live Chat ios SDK Help Desk

Live Chat iOS SDK from Customerly

The Best-in-Class Live Chat for your mobile apps. Integrate painlessly the Live Chat for your customer support inside any iOS App with Customerly Live Chat SDK

Language Language License

Customerly is the most complete Live Chat solution with Help Desk for your mobile apps. Help them where they are with the customer support widget. Easy to integrate Live Chat, once integrated you can track user data and gather user feedback.

Run Surveys directly into your mobile apps and get the responses in one place.

The Customerly Live Chat iOS SDK is really simple to integrate in your apps, and allow your users to contact you via chat.

Live Chat Help Desk ios SDK

Features

  • Support via live chat in real time
  • Track your users
  • Set attributes
  • Set company attributes
  • Track events
  • Run Surveys
  • English, Spanish & Italian localizations
  • Objective-C compatibility
  • Many more is coming....

Requirements

  • iOS 9.0+
  • Xcode 9+
  • Swift 4 or Objective-C

CocoaPods

To use the Customerly SDK we recommend to use Cocoapods 1.5.0 or later

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

$ gem install cocoapods

To integrate the Customerly SDK into your Xcode project using CocoaPods, specify it in your Podfile:

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

pod 'CustomerlySDK'

Then, run the following command:

$ pod install

Usage

If you are setting up a new project, you need to install the SDK. You may have already completed this as part of creating a Customerly account. We recommend using CocoaPods 1.3.1 or later to install the SDK.

First of all, if you don't have an Xcode project yet, create one, then install the SDK following the paragraph Cocoapods.

1) Import the Customerly iOS SDK module in your UIApplicationDelegate subclass:

import CustomerlySDK

2) Configure a Customerly iOS SDK shared instance, in your App Delegate, inside application:didFinishLaunchingWithOptions: method:

Customerly.sharedInstance.configure(appId: "YOUR_CUSTOMERLY_APP_ID")

also add inside applicationDidBecomeActive:

Customerly.sharedInstance.activateApp()

If you want to enable the logging in console, you can set verboseLogging variable to true. By default verbose logging is disabled.

Customerly.sharedInstance.verboseLogging = true

3) From iOS 10, you'll need to make sure that you add NSPhotoLibraryUsageDescription & NSCameraUsageDescription to your Info.plist so that your users have the ability to upload photos in Customerly's chat. Furthermore remember to set the NSAppTransportSecurity to NSAllowsArbitraryLoads.

If in doubt, you can look at the examples in the demo application.

User registration

You can register logged in users of your app into Customerly calling the method registerUser:. You’ll also need to register your user anywhere they log in.

Example:

Customerly.sharedInstance.registerUser(email: "axlrose@example.com", user_id: "123ABC", name: "Axl Rose")

or using a closure

Customerly.sharedInstance.registerUser(email: emailTextField.text!, user_id: userIdTextField.text, name: nameTextField.text, success: { 
                //Success
            }, failure: { 
                //Failure
            })

You can also logout users:

Customerly.sharedInstance.logoutUser()

In this method, user_id, name, attributes, company, success and failure are optionals.

If you don't have a login method inside your apps don't worry, users can use the chat using their emails.

Chat

You can open the support view controller calling the method openSupport:

Customerly.sharedInstance.openSupport(from: self)

where self is your current view controller.

Surveys (nothing to do)

With the Customerly SDK you can deliver surveys directly into your app app without any lines of code.

They will be automatically displayed to your user as soon as possible.

Remember that you can get updates about new surveys available using the update: method.

Attributes

Inside attributes you can add every custom data you prefer to track.

// Eg. This attribute define what kind of pricing plan the user has purchased 
Customerly.sharedInstance.setAttributes(attributes: ["pricing_plan_type" : "basic"])

Company

You can also set company data by submitting an attribute map, like:

Customerly.sharedInstance.setCompany(company: ["company_id": "123", "name": "My Company", "plan": 3])

When you set a company, "company_id" and "name" are required fields for adding or modifying a company.

Events

Send to Customerly every event you want to segment users better

// Eg. This send an event that track a potential purchase
Customerly.sharedInstance.trackEvent(event: "added_to_cart")

Extra

If you want to get a generic update, call update:

Customerly.sharedInstance.update(success: { 
            //Update success
        }) { 
            //Update failure
        }

Contributing

  • If you need help or you'd like to ask a general question, open an issue or contact our support on Customerly.io
  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.

Acknowledgements

Made with ❤️ by Paolo Musolino for Customerly.

License

Customerly iOS SDK is available under the Apache License 2.0. See the LICENSE file for more info.