Connecting Mobile App

Learn how to implement push notifications on Android and iOS devices.

Before you start sending push notifications in your mobile app using our system, you have to connect the mobile app to Reteno.

šŸ“˜

Note

In the Pricing plan section, select the plan that best suits your organization based on the available number of mobile app tokens in your contact list.

To connect your mobile app with Reteno:

  1. Go to Account → Settings.
  2. Click Mob Push in the left-hand side menu.
  3. Click Connect mobile app on the Mobile apps page.
Mob Push settings page with numbered steps highlighting the Settings menu, Mob Push section, and Connect mobile app button.
šŸ“˜

Note

We recommend creating applications with different API keys for the stage and prod environments to minimize risks and ensure high quality of the final product before release.

Step 1. App Name

Type the application name in the Application name field.

App name step of the mobile app connection wizard with the Mobile app name field filled in as My App.

Step 2. Platform

Select whether you need to set up Android and iOS mobile notifications.

Platform step asking whether the app has an Android version, with the Yes option selected.

Step 3. Notification Service

Depending on your choice in Step 2, you will have the following setting options:

  1. Firebase Cloud Messaging (FCM) for all platforms.
  2. Apple Push Notification Service (APN) for iOS.
  3. FCM for Android and APN for iOS.

FCM

  1. Click Upload file.
Configure Firebase Cloud Messaging step with the Upload file button highlighted.
  1. Click on the field and upload the Google Firebase private key JSON file from your computer, or drag your JSON file and drop it in the field.
Configure Firebase Cloud Messaging step showing the drag-and-drop area for uploading the private key file.
šŸ“˜

NOTE

See the Firebase documentation for details on how to generate a private key file in Firebase.

  1. Click Next to complete the configuration.
Configure Firebase Cloud Messaging step with the Firebase key file uploaded and the Next button highlighted.
  1. Click Done on the top right of the window.
Success screen confirming the app was added, with the Done button highlighted and options to copy the access key, send SDK instructions to a developer, or open Debug view.

APN

Select one of two options:

  1. Using tokens
šŸ“˜

See the Apple Developer documentation for details on how to establish a Token-Based Connection to APNs

  1. Using certificates
šŸ“˜

See the Apple Developer documentation for details on how to establish a Certificate-Based Connection to APNs

Configure Apple Push Notification service step with Using tokens and Using certificates options, Using tokens selected, showing Key ID, Team ID, and Topic fields.

Using tokens

  1. Click Upload file.
Configure APNs step with Using tokens selected and the Upload file button highlighted for the .p8 signature key.

Read more about these fields >

  1. Click on the field and upload the Apple push notification authentication key in P8 format from your computer, or drag your P8 file and drop it in the field.
Configure APNs step showing the drag-and-drop area for uploading the .p8 signature key file.
  1. Enter the following in the corresponding fields:
    • Key ID — the 10-character key identifier you obtained from your developer account.
    • Team ID — the issuer key, the value for which is the 10-character Team ID you use for developing your company’s apps. Obtain this value from your developer account.
    • Topic — a unique identifier that causes the notification to arrive in the corresponding app on a user's device. Most often, the Topic is the app bundle identifier.
Configure APNs step with the p8 file uploaded and the Key ID, Team ID, and Topic fields highlighted.
  1. Click Next to complete the configuration.
  2. Click Done on the top right of the window.
Success screen confirming the app was added, with the Done button highlighted and options to copy the access key, send SDK instructions to a developer, or open Debug view.

Using certificates

  1. Click Upload file.
Configure APNs step with Using certificates selected and the Upload file button highlighted for the .p12 signature key.
  1. Click on the field and upload the Apple certificate file in P12 format from your computer, or drag your P12 file and drop it in the field.
Configure APNs step showing the drag-and-drop area for uploading the .p12 signature key file.
  1. Enter the Password and Topic in the corresponding fields.
Configure APNs step with the p12 certificate uploaded and the Password and Topic fields highlighted.

Read more about these fields >

  1. Click Done on the top right of the window.

If everything is configured correctly, you will see a corresponding notification.

Mob Push page showing a green notification confirming push is fully operational, with messages delivered and tracked.

If there are errors in the settings, you will see a list of them and a link to recommendations for fixing them.

Mob Push page showing a red error notification that push will not be delivered for Android because the notification service is not configured, with a Configure FCM button.

Managing Mobile Push Token Duplication

šŸ“˜

Note

By default, the system prevents token duplication when different users log into the same app on one device, helping avoid sending notifications to the wrong contacts. Enabling duplication may affect report accuracy and the uniqueness of contacts.

Enable this setting if one contact manages multiple accounts (e.g., stores or branches) within the app on a single device. This ensures that push notifications are delivered to all associated accounts without requiring the user to log in and out.

  1. Go to your account settings → Mob Push → Advanced settings, and enable the Allow token duplication switch.
Advanced settings tab showing the Allow token duplication switch turned on under Multi-account configuration.
  1. Save your changes.

Did this page help you?