Android and iOS Quick Start
In this chapter, we will learn how to quickly setup Engagespot in your Android and iOS App. At the moment, we don't have UI-Kit and Realtime Notifications for Android and iOS. Features you can use in Android and iOS are -
- Push Notifications using Firebase
- Notification Inbox using REST API
- Notification Preference Manager
Enabling FCM Provider
We use Firebase Cloud Messaging (FCM) to deliver push notifications to your Android and iOS Apps. To enable FCM, login to your Engagespot dashboard. Enable FCM from Channels -> Mobile push menu. To enable FCM, you need to paste the content of your service account JSON which can be generated from your Google Firebase dashboard. Read Firebase documentation to learn how to generate your Service Account JSON File.
Authenticating your App's user with Engagespot
As explained in the Basic Concepts chapter, you should pass any unique identifier of your app's user to Engagespot. Since Engagespot doesn't have a native Android & iOS SDK, we'll use REST APIs to implement this.
For authenticating your app's user with Engagespot, you must call the
/sdk/connect endpoint of our REST API. This API call should be implemented at the authentication step of your app.
/sdk/connect Read API Doc
Please read the API Doc to know more about the required headers & parameters.
"deviceType": "android" //or iOS
This API will return
200 OK if your user has been authenticated with Engagespot.
To list all the notifications for the current user, you should use the GET
/notifications endpoint. Read API Doc.
In the next chapter, we'll learn how to send notifications to users.
Building a Notification Preference Manager
You can quickly build a notification preference manager in your app to help your users set their notification preferences. Please read How to build a Notification Preference Manager.
Enabling Other Notifications Channels
Now we've implemented only Mobile Push notifications. As mentioned in the Basic Concepts chapter, Engagespot can deliver the same notification via multiple channels like Email, Web Push, Mobile Push, SMS etc. To enable more channels, please read Configuring Providers guide.