BPMobileMessaging

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

Quick Start

Adding the SDK to your project

BPMobileMessaging is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'BPMobileMessaging'

• Add the following line into your project’s AppDelegate.swift file: swift import BPMobileMessaging
• Generate the unique clientID string value. The clientID should be generated when application runs for the first time on the mobile device and saved in the local storage. The application should use the same value until it is deleted from the device. The clientID should be unique for each application / device combination. swift var clientID = UUID().uuidString
• Create instance of the ContactCenterCommunicator class which would handle communications with the BPCC server: “`swift let baseURL = URL(string: "https://”)! let tenantURL = URL(string: “”)! var appID = “”

lazy var contactCenterService: ContactCenterCommunicating = { ContactCenterCommunicator(baseURL: baseURL, tenantURL: tenantURL, appID: appID, clientID: clientID) }()

* Register for push notifications. The SDK supports both native APNs and Google Firebase push notifications frameworks. Only one framework should be used at time. Define a variable to store the device token:
```swift
var deviceToken: String?

• If using APNs, implement the function to handle the APNs device token result: swift func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) { self.deviceToken = deviceToken.map { String(format: "%02.2hhx", $0) }.joined() service?.deviceTokenChanged(to: deviceToken) }
• If using Google Firebase, implement MessagingDelegate extension: swift extension AppDelegate: MessagingDelegate { func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) { guard let fcmToken = fcmToken else { print("Empty fcm token") return } print("Received fcm token from Firebase: \(fcmToken)") self.deviceToken = fcmToken } }
• Implement UNUserNotificationCenterDelegate extension to handle push notifications: “`swift extension AppDelegate : UNUserNotificationCenterDelegate {

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) { let userInfo = response.notification.request.content.userInfo contactCenterService.appDidReceiveMessage(userInfo) completionHandler() } }

* Set the delegates for APNs and Google Firebase frameworks:
```swift
UNUserNotificationCenter.current().delegate = self
Messaging.messaging().delegate = self

• Request permissions to receive push notifications: swift let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound] UNUserNotificationCenter.current().requestAuthorization(options: authOptions) { (authorized, error) in guard authorized else { if let error = error { print("Failed to authorize remote notifications: \(error)") } return } DispatchQueue.main.async { UIApplication.shared.registerForRemoteNotifications() } print("Successfully authorized for remote notifications") }
• Implement ContactCenterEventsDelegating extension to receive the chat events:

extension AppDelegate: ContactCenterEventsDelegating {
    func chatSessionEvents(result: Result<[ContactCenterEvent], Error>) {
        switch result {
        case .success(let events):
            print("Received events from contact center")
            DispatchQueue.main.async {
                //  Handle events here ...
            }
        case .failure(let error):
            print("chatSessionEvents failed: \(error)")
        }
    }
}

• Set the delegate for ContactCenterCommunicator:

contactCenterService.delegate = self

• To verify that a chat service is available, call checkAvailability() method:

contactCenterService.checkAvailability { [weak self] serviceAvailabilityResult in
    DispatchQueue.main.async {
        switch serviceAvailabilityResult {
        case .success(let serviceAvailability):
            print("Chat is \(serviceAvailability.chat)")
            self?.isChatAvailable = serviceAvailability.chat == .available
        case .failure(let error):
            print("Failed to check availability: \(error)")
        }
    }
}

• To request a new chat session, call requestChat() method and subscribe for push notifications for the newly created chat session: swift contactCenterService.requestChat(phoneNumber: "12345", from: "54321", parameters: [:]) { [weak self] chatPropertiesResult in DispatchQueue.main.async { switch chatPropertiesResult { case .success(let chatProperties): self?.currentChatID = chatProperties.chatID contactCenterService.subscribeForRemoteNotificationsAPNs(chatID: chatProperties.chatID, deviceToken: deviceToken) { subscribeResult in DispatchQueue.main.async { switch subscribeResult { case .success: print("Subscribe for remote notifications confirmed") case .failure(let error): print("Failed to subscribe for notifications: \(error)") } } } case .failure(let error): print("\(error)") } } ## Author

BrightPattern

License

BPMobileMessaging is available under the MIT license. See the LICENSE file for more info.