Batch.com

Claire

Alexandre

Selma

Need help with push notifications? Check our technical and troubleshooting guides.

Push Notifications

Everything you wanted to know about iOS / Android push notifications but were afraid to ask.

How do mobile push notifications work?

You may want to offer your users a system to disable push notifications from your app.

Allowing users to unsubscribe from push notifications on iOS

Several issues may prevent your device or the device of someone in your team from receiving notifications on iOS.

Why is my device not receiving push notifications on iOS?

How can I use Universal Links with Batch?

Batch servers need to have a valid certificate to communicate with Apple Push Notification Services. Follow that guide to create a new one.

My APNS push certificate expired, what should I do?

Carthage fails to update 'ios-sdk'

Android and iOS handle push notifications differently when the app is already open.

How to show push notifications when my iOS app is in the foreground?

Frequently encountered Xcode 12 issues and their fixes

Xcode 12 fails to build a project containing Batch

iOS 12 introduces grouped notifications, a new feature that keeps multiple notifications from the same app grouped on your lock screen.

Notification groups in iOS 12

Provisional Authorization allows you to send trial notifications without receiving the user's consent first.

Provisional authorization on iOS 12

Starting from iOS 12, users can go directly to the settings of your app from a push notification to disable specific types of alerts.

Supporting additional notification settings on iOS 12

Here is how to use iOS 15's time-sensitive interruption level to change the way notifications are presented to your users in Focus mode.

Understanding and managing iOS 15 time-sensitive interruption level

Baptiste

Arnaud

How can I use a custom notification sound on Android?

Several issues may prevent your device or the device of someone in your team from receiving notifications on Android.

Why is my device not receiving push notifications on Android?

Sometimes after you set up Batch's SDK, you receive push notifications twice due to misconfiguration.

Why am I receiving my push notifications twice on Android?

A simple method allows users to disable push notifications directly from the app (through a toggle system for example).

Allowing users to unsubscribe from push notifications on Android

Use this step-by-step guide to migrate easily from GCM to FCM on Android.

How can I migrate from GCM to FCM?

What to do if you notice the following error : "This push token was registered with a Sender ID that doesn't match this authorization key".

How to fix a mismatch between your push tokens and your Sender ID?

How to explicitly set the Sender ID rather than using the one from google-services.json

Overriding the FCM Sender ID

Mobile manufacturers often include a power-saving mode that kills applications; maybe that's why you don't receive your push notification

How can I fix a notification issue on my Honor/Huawei/Sony/Oppo?

Android

Batch SDK v2 and v3 are compatible with macOS Ventura standard Web Push implementation.

Does macOS Ventura release impact my Web push integration?

Here is everything you need to know on how to migrate your tokens from your current web push provider to Batch.

How can I migrate my website to Batch?

Safari supports Web Push standard protocol from macOS 13. This article details the integration steps to target previous versions of Safari.

How to add Safari support to my existing web push integration?

Several issues may prevent you from receiving Web push notifications on your Browser or Desktop.

Why is my device not receiving Web push notifications?

Everything you wanted to know about web push notifications and we browsers but were afraid to ask.

How do web push notifications work?

Batch lets you send a push notification with a deeplink. Deeplink is a good way to direct your users in a page on your website.

How can I direct users to a page on my website?

Here is everything you should check if your "SUBSCRIPTION" campaign doesn't have any sent.

Why my Trigger campaign on the "SUBSCRIPTION" event doesn't have any sent?

You will find in this article all the information you need on the targeting options available natively and optionally for web push.

How to segment my user base for web push campaign?

Need help understanding your campaign's uninstall/opt-out/deleted tokens? Here's all you need to know to understand it.

How to interpret web push opt-out users?

Here is all you need to know to review your web push integration in a preprod environment.

How to test web push on development environment?

Why did the SDK Auth Key change on my dashboard?

You can change the display duration of the web push notifications you receive from your computer's settings.

How can I configure the display time of web push notifications?

Here is a simple step-by-step guide to reset your web browser opt-in preferences for web push notifications.

How can I reset my browser opt-in preferences?

Everything you need to know to disable web push notifications in Google Chrome, Mozilla Firefox, Microsoft Edge, and more.

How to disable web push notifications?

You can target your mobile device from the dashboard to test your web notifications are displayed correctly on Android.

How can I send a test notification to my web browser on Android?

You can find your Installation ID with the "Find my installation" feature or with the help of the Mac Console.

How can I find my Installation ID on an iOS device?

Firebase may intercept notifications on iOS. This can cause issues with Batch's handling of notifications (landings, deeplinks, and more).

Preventing Firebase from intercepting Batch push notifications

Here are the things to look at if you can't display a Mobile Landing.

My mobile landing does not show

In some cases, Batch will fail sending a send test to your device. This happens when the token you are targeting is not valid anymore.

How to fix the "Unregistered" push test error?

Here is what you need to do when you want to check the effective sending time of a transactional push compared to the API call time.

Push Notifications

iOS

Android

Web

Troubleshooting