Applications

The Applications section is the starting point for working with Notify Partners. Every push notification is tied to a specific application, and the application determines which transport to use for delivery.

Creating an Application

1. Go to Applications and click "Create".
2. Enter the name of the application — it is displayed in the dashboard and accessible via the {{app_name}} macro.
3. Enter a link (application URL) — used as the default link when opening a push.
4. Select a provider: Firebase, APNs or WebPush.
5. Upload credentials for the selected provider (described below).
6. Click "Save".

After creation, the application is assigned a unique app_id — it is needed for SDK initialization and API requests.

Providers and Credentials

To send pushes, you need to configure transport provider credentials. Without them the system cannot send notifications.

Firebase (Android and Web)

Firebase Cloud Messaging (FCM) is used for sending to Android devices and web browsers if the web application is registered in Firebase.

How to get credentials:

1. Open Firebase Console → select project → "Project Settings" → "Service Accounts" tab.
2. Click "Generate new private key" — a JSON file will be downloaded.
3. In the Notify Partners application settings, upload this JSON to the Firebase Credentials field.

Example JSON structure:

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "...",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "[email protected]",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token"
}

APNs (iOS)

Apple Push Notification service (APNs) is used for sending to iOS devices.

How to get credentials:

1. Open Apple Developer → Certificates, Identifiers & Profiles → Keys.
2. Create a new key and check Apple Push Notifications service (APNs).
3. Download the .p8 file (available only once).
4. In the application settings, fill in the fields:
   • Team ID — found in the top right corner of Apple Developer Console.
   • Key ID — displayed next to the created key.
   • Topic — your application's Bundle ID (e.g., com.example.myapp).
   • Private Key — paste the entire contents of the .p8 file, including the -----BEGIN PRIVATE KEY----- lines.

WebPush

WebPush allows you to send notifications to browsers (Chrome, Firefox, Edge) without Firebase. Uses the VAPID protocol.

How to configure:

VAPID keys are generated automatically when creating an application with the WebPush provider. No external actions are required.

After creating the application, the VAPID Public Key will appear in its settings — it needs to be passed to the Web SDK during initialization:

initNotifyPartners({
  appId: "YOUR_APP_ID",
  vapidKey: "VAPID_PUBLIC_KEY_FROM_SETTINGS",
  serviceWorkerPath: "/notify-partners-sw.js"
});

Attaching Push Packs

In each application's settings there is a Push Packs section — here you can attach push sets that will automatically be sent to users of this application. More details — in the Push Packs section.

Application Macros

After creating an application, macros become available that can be used in push templates:

Full macro list — in the Push Templates section.