In order to use Push notification and in-app messaging features, you first need to create an app on the imiconnect platform. This app holds information like the FCM API key corresponding to your mobile app. In return, you get an App ID and a client key, which needs to be embedded in your mobile app to link it to the app created on imiconnect.
Further to send push notifications or in-app messages, you need to map this app asset to a service.
Your account administrator should have been provided a URL to the imiconnect Portal, this URL is unique to your account. If you do not have your account URL, please contact your account administrator.
- Login to your imiconnect Portal account using your unique account URL.
- From the menu bar, go to Assets, and click Apps as shown below.
- Click Configure Apps > Mobile/Web.
- In the app configuration screen, set a name to your app and make a note of CLIENT KEY provided in the section below that.
- Next, click Configure as shown in the image to configure OS-specific Push Notification settings.
In the pop-up that appears, provide the FCM Server key corresponding to your Firebase project. In the second image below, you can see the section from where you can access the FCM server key from the firebase console.
Copy the code snippet provided in the 'PERMISSIONS' section and paste it in your
Get your FCM server key
In the pop-up that appears, if you want to use APNS as the Push Notification gateway, provide the Certificate Password, select the gateway type of your APNS project and provide the certificate file to complete your configuration process. Alternatively, you can use FCM as a gateway.
Supported Certificate Format
.p12 is the only certificate format supported.
- Enable In-App messaging and select the primary and secondary connection protocol from the select list
Two transport protocols are available for establishing an In-App Messaging connection with imiconnect - Web Socket and MQTT. You can configure them as primary and secondary. If a connection fails to establish on the primary protocol, it falls back to the secondary protocol.
- For an end-to-end encrypted messaging service, you must select both the check-boxes (Use Secured Port and Enable Payload Encryption) as shown in the image.
- To monitor device attributes, like IMEI No., Geo-Location, etc, enable Device Attributes and click Configure as shown below.
- In the pop-up that appears, select the device attributes you wish to monitor.
- Next, define the monitoring frequency by selecting an interval from the select-list available.
- Now copy the code snippet available in the 'PERMISSIONS' section and paste it in your
manifest.xmlfile in case of Android or plist file in case of iOS.
Device Attribute configuration for iOS
Device Attribute configuration for Android
- If you want to authorize all communications over in-app messaging, you can do so by enabling JWT Authorization. Once enabled, you'll need to provide the JWT secret key that will be used for validation.
- Finally, click on SAVE to complete your app asset creation process and hit the back button, to land on the apps page. You can now see your app listed with an App-ID.
You'll have to embed this APP ID in your app code. You can learn more about it in Quickstart guides available in each SDK documentation.
Updated 2 months ago
Build your first mobile app.
|Android Quickstart Guide|