Remote Push Notifications

1. Sign up for a free OneSignal account at onesignal.com

   

2. The free tier includes unlimited push notifications with GDPR compliance

3. Paid features include email marketing and SMS (not required for push notifications)

1. In the OneSignal dashboard, click "New App"

2. Enter your app name and organization

3. Select iOS platform first (we'll add Android later)

Important: Use Apple Developer portal, NOT App Store Connect.

1. Go to developer.apple.com

2. Navigate to Certificates, IDs & Profiles → Keys

3. Click the + button to create a new key

4. Name your key (e.g., "OneSignal MyApp")

5. Enable Apple Push Notification service (APNs)

6. Configure the environment:

   • Select both Sandbox and Production

7. Click Continue → Register

8. Download the key immediately (you can only download it once!)

9. Save the .p8 file securely

1. Upload the .p8 file to OneSignal

2. Enter the Key ID (found in Apple Developer portal next to your key)

3. Enter the Team ID (shown next to your company/personal name in Apple Developer)

4. Enter the Bundle ID:

   • Find this in Despia dashboard under Publish App

   • Copy your bundle ID

   Note: To use a custom bundle ID without Despia branding, contact support.

   

5. Click Save & Continue

6. Select Native iOS (Despia creates true native apps!)

   

7. Save & Continue

1. Copy the OneSignal App ID

   

2. In your Despia project editor, scroll to OneSignal Integration

   

3. Paste the App ID in iOS Application ID field

4. Save and publish your project

   

1. Go to Firebase Console

2. Important: Log in with the same Google account linked to your Google Play Console

3. Create a new project with your app name

   

4. Wait for project setup to complete

1. In Firebase project settings, go to Cloud Messaging

2. Ensure Firebase Cloud Messaging API v1 is enabled

3. If disabled:

   • Click the three dots → Open in Cloud Console

   • Click Enable

1. Go to Project Settings → Service Accounts

2. Click Generate New Private Key

3. Download the JSON file and save it securely

1. In OneSignal, go to Settings → Push → Push Platforms

   

2. Click Add Android

3. Upload the Google Service Account JSON file

   

4. Click Save & Continue

5. Select Native Android

   

6. Save & Continue

The OneSignal App ID remains the same for both platforms. In Despia:

1. Add the same App ID to Android Application ID field

   

2. Save and publish your project

   

Add this to your WeWeb app to capture the OneSignal Player ID:

1. Create a variable: onesignalplayerid

   

2. Add a page load workflow to set the variable onesignalplayerid

   

3. In the “change variable value” block run following JavaScript:

   Copy// The player ID is pre-injected by Despia
   return oneSignalPlayerId || "sample-id-for-editor";
   

   

1. In your page load workflow, add an API call to your backend

2. Send:

   • Current user ID (from your auth system)

   • OneSignal Player ID

3. Store this relationship in your database

Example using Xano (adaptable to any backend):

Copycurl -X POST https://onesignal.com/api/v1/notifications \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Basic YOUR_REST_API_KEY" \
  -d '{
    "app_id": "ONESIGNAL-APP-ID",
    "include_player_ids": ["PLAYER-ID"],
    "headings": {"en": "Hello"},
    "contents": {"en": "This is a test notification from Despia"}
  }'