Before you start
- Decide which platforms you need: Web Push, Android, iOS, or a combination.
- For Web Push, prepare VAPID public key, VAPID private key, and contact email.
- For Android, prepare a Firebase service account JSON file.
- For iOS, prepare APNs team ID, key ID, bundle ID, private key, and sandbox setting.
- Make sure your app or website can capture and store push tokens for customers.
Create the push channel
1
Open Channels
In Sagepilot, open Channels and click Create Channel.
2
Select Push Notifications
Choose Push Notifications from the Voice & Mobile category.
3
Set general details
Add the channel name and enable the provider types you plan to use.
4
Configure Web Push
Add VAPID public key, VAPID private key, and contact email.
5
Configure Android
Upload or paste the Firebase service account JSON. Sagepilot reads the Firebase project details from the JSON.
6
Configure iOS
Add APNs team ID, key ID, bundle ID, private key, and choose production or sandbox mode.
7
Save and test
Save the channel, then use Test Send with a valid device token or FCM registration token.
Platform checklist
Verify the setup
- Save the channel with the platform provider enabled.
- Register a push token from your app or website.
- Send a test notification from Sagepilot.
- Confirm the device receives the notification.
- Confirm failure states are visible if the token is invalid or expired.
Operational notes
- Do not mix sandbox and production APNs credentials.
- Store customer push tokens through your app integration before relying on journeys.
- Rotate provider credentials according to your mobile security policy.