Additional push channels
Amazon ADM, Windows WNS, fallback channel, smartwatch, live updates, carousel, VoIP and App Clip (ADR-0052).
Amazon ADM, Windows WNS, fallback channel, smartwatch, live updates, carousel, VoIP and App Clip (docs/adr/0052-ek-kanallar.md).
Fallback channel
Set fallback_channel: "sms" or "email" in the notification body. On a permanent push failure, the same user's subscription on that channel is used. If that channel is disabled, the delivery stays failed. The journey push step has the same field.
Smartwatch
Device registration writes device.form_factor (phone or watch). When sending, form_factor: "watch" goes only to watch subscriptions. iOS models containing "watch" and Android devices with FEATURE_WATCH are treated as watches.
Amazon ADM
Channel adm_push, provider adm. In the dashboard (Channels → Amazon Device Messaging), enter the Client ID and Client Secret of the security profile from the Amazon Developer Console. The token is sent to the Amazon endpoint; no other address is accepted. The ADM subscription is a secondary subscription alongside the main push subscription (android_push).
Automatic path (recommended): the pushizo-adm module. The app adds the com.pushizo:pushizo-android-adm dependency; the module starts ADM registration (ADM.isSupported → startRegister), writes the registration ID as an adm_push subscription, deletes the old one when the ID is refreshed and passes incoming ADM messages into the same notification pipeline as FCM (received, display, opened/dismissed). Permissions, amazon:enable-feature (android:required="false"), handlers and the receiver are added through manifest merging; R8 rules ship with the module.
dependencies {
implementation("com.pushizo:pushizo-android:0.2.0")
implementation("com.pushizo:pushizo-android-adm:0.2.0")
// Amazon's ADM jar (downloaded from developer.amazon.com): compile time only, not included in the APK.
compileOnly(files("libs/amazon-device-messaging-1.1.0.jar")) // file name of the version you downloaded
}The Amazon ADM library is not on Maven and, due to its distribution terms, is not bundled with the SDK; Fire OS provides the classes at runtime. Adding the jar as compileOnly is recommended (so R8 recognizes the classes); without it the module still compiles and is minified. On Google Play devices the ADM classes are absent: the module silently disables itself and the app does not crash. On Fire OS devices, the app's ADM API key from the Amazon Developer Console must be placed in assets/api_key.txt (an Amazon requirement).
Manual path: an app that handles ADM registration itself reports the registration ID with Pushizo.User.registerAdm(registrationId) and passes messages from its own ADM handler to the SDK with HsPushBridge.onMessageReceived(context, data). Do not use the module and the manual path together.
Windows WNS
Channel wns_push. Package SID and secret key. The device channel URI can only be https://*.notify.windows.com.
Android live updates
android_live_update: { "progress": 40, "ongoing": true } writes hs_live_progress and hs_ongoing into the FCM data field. The Android SDK adds a progress bar to the notification.
iOS carousel
ios_carousel: [{ "url": "https://ornek.test/1.jpg" }] goes to the APNs hs.carousel field. The Notification Service Extension downloads the images as attachments.
VoIP and App Clip
voip: true sets the topic to <bundle>.voip and the push type to voip. The device must have push_kind: "voip". app_clip: true sets the topic to the channel setting's app_clip_bundle_id or <bundle>.clip. The device must have push_kind: "app_clip". Regular notifications are not sent to these tokens.
AMP web push
The Web SDK's ampWebPushElement generates the amp-web-push element for an AMP page. The service worker path is the existing Pushizo worker.
Timeline and sessions
On the user page, events and deliveries are shown in a single list. Analytics shows the session_start count and unique users for the last 14 days. These endpoints are dashboard-only.
SMS sender and dedicated IP
The deliverability page records 10DLC, toll-free or short code applications. An approved number can be written to the SMS channel's sender field. Carrier filing is the status of this record. A dedicated IP is the organization's own address; the assignment is written to the email configuration_set field. IPs are not purchased.
Android delivery hardening
On some Android manufacturers notifications arrive late or not at all. This guide explains why, how Pushizo measures it, and how to take users to the right settings screen in your app.
iOS Safari (16.4+) web push and PWA
On iOS 16.4 and later, Safari can send notifications to web apps added to the Home Screen (PWAs) using standard Web Push. The Pushizo Web SDK supports this flow without extra code; the difference is that the user must first add the site to the Home…