PushizoDocs
Channels

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: [{ "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.

On this page