Push Notifications

Introduction

Catalyst Push notifications enables you to send remote notifications to the users of your application, even when the app is not actively running on the user device. Catalyst provides you with an easy way to integrate push notifications into your Catalyst web, iOS, and Android applications.

Before you send push notifications, you must follow a set of steps to register your app and enroll for Catalyst push notifications. These steps are mentioned in sequence below:

1. Register your iOS app with Apple
2. Generate a certificate from Keychain Access
3. Generate and download the APNs certificate provided by Apple
4. Convert the downloaded APNs certificate into the .p12 format
5. Enroll for iOS Push Notification Services in Catalyst
6. Register a Mobile Device for Push Notifications

Register a Mobile Device for Push Notifications

After you complete the first five steps mentioned above, you can implement the following code in your iOS app that will register the device for Catalyst Push Notifications.

To register an iOS mobile device as a test device, you must call the registerNotification() method with the required parameters as shown in the following code snippet:

    

        
copy
        

            

        
    
    

         ZCatalystApp.shared.registerNotification(token: e5********21, appID: 12345678, testDevice: false) { error in
            if let error = error
            {
                return print("Error : \( error )")
            }
            print("Registered successfully")
        }

    

Parameters:

• token: Device token obtained after registering the device for remote push notifications with APNS.

• appID: The notificationAppID obtained from the AppConfigurationDevelopment.plist/ AppConfigurationProduction.plist file generated by Catalyst for your app when you registered your iOS app in Catalyst.

• testDevice: The value is set to true for test devices, and set to false for production devices.

After your device is registered, you will be able to send push notifications to your app users. The users will need to provide the permission for your app to send push notifications to them on their device, by clicking Allow from the permission prompt.

You can learn about sending test push notifications on your registered devices from the Catalyst console from this help section. You can also send test notifications from the API.

Refer to the Java, Node.js, and Python SDK documentation to learn about sending push notifications through your codebase.