Ctrlk
Service statusLog in
For the complete documentation index, see llms.txt. This page is also available as Markdown.

SDK integration

This guide assumes that you've already followed the iOS and Android prerequisites.

Batch React-Native Plugin requires react-native 0.77 or higher. If you’re using Expo, version 54 or higher is required.

Batch-React-Native-Plugin is a pure Turbo Module and does not support the legacy architecture anymore since react-native is freezing the legacy architecture codebase. If you are still on the legacy architecture and do not plan to migrate on the new one, please use the Batch-React-Native-Plugin v11.

Swift Package Manager isn't officially supported yet. Even on React Native 0.87 with react-native spm scaffold, SPM requires manual setup and isn't guaranteed to work, please use CocoaPods to integrate the plugin for now.

Integration

Please follow the integration guide according to your application.

Expo IntegrationVanilla Integration

Your first notification

1. Obtaining Your Device Token on iOS

You can find your device's token using the debug tool or locating the token Batch posts to the Xcode console:

Push token (Apple Push Production): <push token>

Based on your Provisioning Profile, the token shown in the console will be Development ("Sandbox/Development") or Production ("Production").

2. Obtaining Your Device Token on Android

You can find your device's token using the debug tool or locating the token Batch posts to the logcat (see here to know more):

3. Sending A Test Push

You can send test notifications to your device with a push token. In the push notification creation form, click the ⚙️ and copy your push token in the corresponding field. Hit "Send a test".

Test push

What's next

Congratulations on finishing the integration of Batch Push!

Here are a couple of extra steps you can take before releasing your app:

  • Small icon / Accent color: On Android, make sure the small icon you are using is opaque white. We also recommend you use an accent color.

  • Custom user identifier: Add support for custom user identifiers if you are planning to use the Profile API.

  • Analytics: Add an event dispatcher to automatically track your campaigns in your third-party analytics tool.

  • Token import: Import your existing tokens if you're coming from another push provider.

PreviousPrerequisites
NextVanilla Integration

Last updated