Skip to main content

Push Notifications

[中文版本]

Push notifications help send notifications to users about RainMaker events. It is required to set up FCM and APNS environments for Android and iOS notifications respectively.

Configuring Push Notifications for Android​

  1. Configure your Android app for Push Notifications

  2. In the Firebase console, choose your project. In the left navigation pane, choose the gear icon, and then Project settings.

    firebase8

  3. Choose Cloud Messaging. Under Project credentials, find the Server key. This is your FCM project's API Key. Copy it to your clipboard.

    firebase9

  4. Log in to Rainmaker Dashboard with your admin account. Go to deployment settings, then go to the Push Notifications tab.

    push_notification12

  5. Create a new platform application. Choose type - Google Notification

    push_notification13

  6. Paste the API Key that you copied in step 3. Click Save.

    push_notification14

  7. You can now enable Push Notifications.


Configuring Push Notifications for iOS​

  1. Log in to your Apple Developer account

    push_notification1

  2. App Id is required for push notifications to work. Create an App ID from Apple Developer console, if not created already.

  3. Then go to the Certificates tab. Click on +.

    push_notification2

  4. Create a new certificate for Service - Apple Push Notification service SSL (Sandbox & Production). Click on Continue.

    push_notification3

  5. Select the App Id of your app. Click on Continue.

    push_notification4

  6. Now you will have to create Certificate signing request (CSR)

    push_notification5

  7. Open the Keychain Access utility. Then go to the Certificate Assistant -> Request a certificate from a Certificate Authority.

    push_notification6

  8. In the Certificate Assistant dialog, enter an email address in the User Email Address field. Leave the CA Email Address field empty. Choose “Saved to disk”, and click Continue. Save the certificate.

    push_notification7

  9. Upload a Certificate signing request (CSR)

    push_notification8

  10. The certificate is created. Download and view it using Keychain Access.

    push_notification9

  11. Export your certificate from Keychain Access in p12 format.

    push_notification10

    Do not provide any password to protect the exported certificate.

    push_notification16

  12. You would require SSL Certificate and Private Key for enabling push notifications. To extract the SSL Certificate you can use the command:

    openssl pkcs12 -in yourP12Certificate.p12 -clcerts -nokeys

    To extract the Private Key you can use the command:

    openssl pkcs12 -in yourP12Certificate.p12 -nocerts -nodes

  13. Log in to Rainmaker Dashboard with your admin account. Go to deployment settings, then go to the Push Notifications tab.

    push_notification12

  14. Create a new platform application. Choose type - Apple Notification (APNS)

    push_notification13

  15. Paste the SSL Certificate and Private Key that you extracted in step 12. Click Save.

    push_notification11

    Note - The same certificate can be used for both SandBox and Production environment. SandBox environment is used to test notifications and debugging. While, APNS is used for distribution. You may repeat steps 13 and 14. Select type - Apple SandBox (APNS_SANDBOX) to set push notifications for SandBox environment.

  16. You can now enable Push notifications.


Enabling Push Notifications​

  1. Log in to Rainmaker Dashboard with your admin account. Go to deployment settings, then go to the Push Notifications tab.

    push_notification12

  2. Enable push notifications using the toggle. You may also customize the events for which you wish to enable push notifications.

    push_notification15

    Note - You can disable push notifications using the same toggle.