Authentication

Setup

There is a setup call that you need to do before registration or login. You can get your App ID by signing up on Kommunicate dashboard. Add below line in AppDelegate's launch method or just before the registration:

Kommunicate.setup(applicationId: <pass your App ID>)

Registration/Login

Convenient methods are present in Kommunicate class to register a user on Kommunicate.

Currently we support two different types of users on our iOS SDK:

1. Visitors

A random Id will be assigned as an userId if you don't have any information about the users. So first get the userId for an anonymous user as described below and pass the same in the registration process.

let userId = Kommunicate.randomId()

2. Pre chat Lead Collection

For collecting user contact information before initiating the chat, show the Pre chat view like this:

let preChatVC = KMPreChatFormViewController(configuration: Kommunicate.defaultConfiguration)
preChatVC.delegate = self // set the delegate to self to receive callbacks
self.present(preChatVC, animated: false, completion: nil) // To present

Once you show this view, there are two scenarios one in which the user fills in the details(at least emailId or phone number is required), and another one is when the user clicks on the close button. To get the callbacks to handle both these scenarios, confirm your ViewController to KMPreChatFormViewControllerDelegate like this:

extension ViewController: KMPreChatFormViewControllerDelegate {

    func userSubmittedResponse(name: String, email: String, phoneNumber: String) {
        self.dismiss(animated: false, completion: nil)
        
        // Register the user as described below.
        // After successful registration, launch a conversation.
    }

    func closeButtonTapped() {
        self.dismiss(animated: false, completion: nil)
    }
}

3. Registered User

If the user is logged in your app then you can pass the user information in this way.

// Use this while creating a `KMUser` object below.
let userId = <pass a unique key>
let emailId = <pass user's emailId> // Optional

Register User

To register a user to the Kommunicate server, use below method from Kommunicate class:

Create a KMUser object and pass it to the registerUser method:

let kmUser = KMUser()
kmUser.userId = userId
kmUser.email = emailId // Optional
kmUser.applicationId = appId

// Use this same API for login
Kommunicate.registerUser(kmUser, completion: {
    response, error in
    guard error == nil else {return}
    print("Success")
})

To check if user is already logged in, use below API:

if Kommunicate.isLoggedIn {
  // User is already logged in
}

Note: To avoid calling in registration everytime use isLoggedIn to check if the user is already logged in or not.

What Next?

1. Check out the Conversation Section where you will get the details for creating and launching a conversation.
2. Enable Push Notifications to get real-time updates.