Use this connector to send push notifications to mobile devices using Apple Push Notification Service (APNs) or Firebase Cloud Messaging (FCM).
Mosaic's Journeys allow sending push notifications through the Send push and Generic OTP authentication steps. These steps let you configure an external service to handle parameters like notification content, and return a response indicating success or failure.
Configuring an Apple Push Notification Service (APNs) or Firebase Cloud Messaging (FCM) for sending push notifications involves these steps:
- Establishing the connection: Set up the connection by configuring key parameters (Admin Portal > Management > Integration hub > Apple & Google push notifications).
- Configuring push settings: While the APN and FCM settings define the server setup, notification-specific parameters such as title, notifications, etc. are configured within the Send push or Generic OTP authentication steps.
- Enabling the connector
At runtime, sending a push consists of:
- Sending the request: When the step executes, it uses the preconfigured push notification services to send notifications to the specified device with the provided content.
- Response and handling: The connector processes the request and returns a response (success or failure).
| Field | Description |
|---|---|
| Authentication type | Select the authentication method for APNs:
|
| Identity for Apple-issued provider certificate | (certificate-based connection) Select or add a new Apple-issued certificate that authorizes your app to send push notifications through APNs. |
| Apple-issued token signing key (.p8 file) | (Token-based only) Select or upload the .p8 signing key generated in the Apple Developer portal. This key is used to sign JWT tokens for APNs authentication. |
| Team ID | (Token-based only) Enter your Apple Developer Team ID, available in your Apple Developer account. This value identifies your development team when generating the authentication token. |
| Key ID | (Token-based only) Enter the Key ID associated with the .p8 signing key in the Apple Developer portal. This value identifies which key is used to sign the token. |
| Sandbox mode | Enable this option to test notifications in Apple’s sandbox environment before deploying to production. |
| Topic | Enter the app’s bundle identifier (for example, com.example.app). This value identifies the app receiving notifications. |
| Notification sound | Specify the custom sound file to play when a notification is received. Leave blank to use the default system sound. |
| Field | Description |
|---|---|
| FCM API type | Select FCM HTTP v1 API to use the latest Firebase Cloud Messaging API for sending notifications. FCM Legacy API option is also available. |
| Firebase service account key | Upload or select the JSON key for your Firebase service account. This key authorizes your app to send notifications through FCM. |
| Firebase project name | Enter the Firebase project name associated with your app. |
| Firebase service account email | Enter the email address linked to your Firebase service account. |
| Notification sound | Specify a custom sound file to play when a notification is received. Leave blank to use the default sound. |
| Field | Description |
|---|---|
| Test connection on server start | When enabled, Mosaic tests the connection to APNs or FCM during server startup to ensure configuration validity. |
| Do not send user identifier | Enable this option to prevent sending user identifiers in push payloads for privacy or compliance reasons. |