Swift Push SDK

Fyno’s iOS (Swift) Push Notification SDK offers a comprehensive set of notification features within your app. It’s designed to efficiently deliver messages, ensuring optimal performance and user experience.

Prerequisites

In order to get started, there are a few prerequisites that needs to be in place:

• Fyno account: A valid Fyno workspace with at least one active API Key. For more info, refer Workspace Docs.
• Configuration: Configure your Fyno Push provider in Fyno App > Integrations.
• Swift iOS application: A working Swift iOS application in which you want to integrate the SDK.
• Apple developer account: Required details are mentioned in APNs Docs.

Installation

target 'MyApp' do
  pod 'fyno-push-ios', '~> 1.1'
end

1
// without FCM
2
3
import Foundation
4
import UIKit
5
import fyno_push_ios
6
7
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
8
let fynosdk = fyno.app
9
10
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
11
       UNUserNotificationCenter.current().delegate = fynosdk
12
13
       self.fynosdk.registerForRemoteNotifications()
14
       fynosdk.requestNotificationAuthorization{ _ in}
15
16
       return true
17
    }
18
19
    func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
20
        print("Failed to register for remote notifications: \(error.localizedDescription)")
21
    }
22
23
    func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
24
        // Send the device token to fynoServer
25
        fynosdk.setdeviceToken(deviceToken: deviceToken)
26
    }
27
28
}

Usage

Initialising the SDK (to be called on app launch)

To initialise the Fyno SDK, you need to provide the following information:

• Workspace ID (Mandatory): Your unique Fyno workspace ID, available on the Fyno App > Workspace Settings page.
• Integration ID (Mandatory): The ID of the integration created in Fyno App > Integrations.
• Distinct ID (Optional): A unique identifier for your user. If not provided, a UUID is automatically generated.
• Version (Optional): Indicates the environment in which the user has to be created. Default is “live”, but you can set it to “test” for testing purposes.

1
fyno.app.initializeApp(
2
    workspaceID: workspaceId,
3
    integrationID: integrationID,
4
    distinctId: distinctID,
5
    version: version
6
){
7
    initResult in
8
    switch initResult {
9
    case .success(_):
10
        print("Initialization successful")
11
    case .failure(let error):
12
        print(error)
13
    }
14
}

Identifying the User

To update/set a distinct ID or user name, call fyno.app.identify().

• Distinct ID (Mandatory): The distinct ID you want to identify the user with.
• User Name (Optional): - The name you want to assign to the user.

1
fyno.app.identify(newDistinctId: distinctID, userName: userName) { identifyResult in
2
    switch identifyResult{
3
    case .success(_):
4
        print("Identify successful")
5
    case .failure(let error):
6
        print(error)
7
    }
8
}

Registering for Push Notifications

To register the application for push notifications, call fyno.app.registerPush().

• isAPNs (Mandatory): Use true if APNs is configured, false if Google FCM is configured in the integration.

1
fyno.app.registerPush(isAPNs: isAPNs){
2
    registerPushResult in
3
    switch registerPushResult{
4
    case .success(_):
5
        print("registerPush successful")
6
    case .failure(let error):
7
        print(error)
8
    }
9
}

Merging User Profiles

If you need to merge two user profiles, call fyno.app.mergeProfile() with the old and new distinct IDs.

1
fyno.app.mergeProfile(newDistinctId:newDistinctId){
2
    mergeResult in
3
    switch mergeResult{
4
    case .success(_):
5
        print("mergeProfile successful")
6
    case .failure(let error):
7
        print(error)
8
    }
9
}

Updating Message Status

You can update the status of a notification (received, clicked or dismissed) using fyno.app.updateStatus().

• Callback URL (Mandatory): You can obtain the Callback URL from the notification additional payload if the notification was triggered from Fyno.
• Status (Mandatory): The status of the notification (one of RECEIVED, CLICKED or DISMISSED).

1
fyno.app.updateStatus(callbackUrl: callbackUrl, status: status){
2
    updateStatusResult in
3
    switch updateStatusResult{
4
    case .success(_):
5
        print("updateStatus successful")
6
    case .failure(let error):
7
        print(error)
8
    }
9
}

Resetting User Information

To reset user information, call fyno.app.resetUser().

• You can invoke this function when the user logs out of the application.
• It handles the deletion of channel data associated with the current user, initiates the creation of a fresh user profile, and transfers this particular channel data (push token) to the newly created profile.
• This feature proves to be invaluable if you plan to send push notifications to an application even after the user has logged out.
• It is also recommmended as it ensures that devices where the users have logged out are no longer associated with them.

1
fyno.app.resetUser() {
2
    resetUserResult in
3
    switch resetUserResult{
4
    case .success(_):
5
        print("resetUser successful")
6
    case .failure(let error):
7
        print(error)
8
    }
9
}