react-native-push-notification

Android allows adding interactive buttons to notifications via the actions parameter (an array of strings).

Inline Reply

To enable inline text input, add "ReplyInput" to the actions array. You must also provide reply_placeholder_text and reply_button_text.

To retrieve the user's response in your onNotification handler, check the action property and access notification.reply_text.

Requirement: You must add the following receiver to your AndroidManifest.xml:

<receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationActions" />

// Schedule a notification with inline reply
PushNotification.localNotificationSchedule({
  message: "My Notification Message",
  date: new Date(Date.now() + (60 * 1000)),
  actions: ["ReplyInput"],
  reply_placeholder_text: "Write your response...",
  reply_button_text: "Reply"
});

// Handling the reply in onNotification
// ...
if(notification.action === "ReplyInput"가){
  console.log("texto", notification.reply_text)
}

If your 3rd party notification provider uses a custom data format that react-native-push-notification cannot parse, you must implement a custom IntentHandler in your Android native code (Application init or MainActivity.onCreate()).

1. Remove the default intent handler from AndroidManifest.xml.
2. Implement onNewIntent to parse the intent.
3. Implement getBundleFromIntent to return the bundle that will be serialized into notification.data for the onNotification() handler.

// Android Native Implementation
RNPushNotification.IntentHandlers.add(new RNPushNotification.RNIntentHandler() {
  @Override
  public void onNewIntent(Intent intent) {
    // Custom parsing logic here
  }

  @Nullable
  @Override
  public Bundle getBundleFromIntent(Intent intent) {
    if (intent.hasExtra("MY_NOTIFICATION_PROVIDER_DATA_KEY")) {
      return intent.getBundleExtra("MY_NOTIFICATION_PROVIDER_DATA_KEY");
    }
    return null;
  }
});

To use localNotificationSchedule(), you must manually update your AndroidManifest.xml with specific permissions, metadata, and receivers. Note that localNotification() works without these changes.

<!-- In android/app/src/main/AndroidManifest.xml -->
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>

<application ....>
    <!-- Set to true to enable pop-up for in foreground on receiving remote notifications -->
    <meta-data  android:name="com.dieam.reactnativepushnotification.notification_foreground"
                android:value="false"/>
    <!-- Set your App's accent color -->
    <meta-data  android:name="com.dieam.reactnativepushnotification.notification_color"
                android:resource="@color/white"/>

    <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationActions" />
    <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationPublisher" />
    <receiver android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationBootEventReceiver">
        <intent-filter>
            <action android:name="android.intent.action.BOOT_COMPLETED" />
            <action android:name="android.intent.action.QUICKBOOT_POWERON" />
            <action android:name="com.htc.intent.action.QUICKBOOT_POWERON"/>
        </intent-filter>
    </receiver>

    <service
        android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationListenerService"
        android:exported="false" >
        <intent-filter>
            <action android:name="com.google.firebase.MESSAGING_EVENT" />
        </intent-filter>
    </service>
</application>

Android requires notification channels to be created before they can be used. When triggering a notification, you must provide a channelId that matches a created channel.

Note: Once a channel is created, its options cannot be updated. To change channel settings, you must create a new channel with a different channelId.

Create a Channel

Use PushNotification.createChannel(options, callback) to register a channel. The callback returns true if the channel was newly created, or false if it already existed.

List Channels

Use PushNotification.getChannels(callback) to retrieve an array of available channel IDs.

Check Channel Status

• PushNotification.channelExists(channel_id, callback): Returns true/false if the channel exists.
• PushNotification.channelBlocked(channel_id, callback): Returns true/false if the channel is blocked by the user.

Delete a Channel

Use PushNotification.deleteChannel(channel_id) to remove a channel.

import PushNotification, {Importance} from 'react-native-push-notification';

PushNotification.createChannel(
  {
    channelId: "channel-id", // (required)
    channelName: "My channel", // (required)
    channelDescription: "A channel to categorise your notifications", // (optional)
    playSound: false,
    soundName: "default",
    importance: Importance.HIGH,
    vibrate: true,
  },
  (created) => console.log(`createChannel returned '${created}'`)
);

// List channels
PushNotification.getChannels(function (channel_ids) {
  console.log(channel_ids); // ['channel_id_1']
});

// Check if exists
PushNotification.channelExists('channel-id', (exists) => {
  console.log(exists); // true/false
});

// Check if blocked
PushNotification.channelBlocked('channel-id', (blocked) => {
  console.log(blocked); // true/false
});

// Delete channel
PushNotification.deleteChannel('channel-id');

Initialize the notification service using PushNotification.configure().

CRITICAL: Do NOT call .configure() inside a component (even App). It must be called in the app's entry point (e.g., index.js) to ensure notification handlers are loaded correctly.

import PushNotificationIOS from "@react-native-community/push-notification-ios";
import PushNotification from "react-native-push-notification";

PushNotification.configure({
  onRegister: function (token) {
    console.log("TOKEN:", token);
  },

  onNotification: function (notification) {
    console.log("NOTIFICATION:", notification);
    // Required for iOS
    notification.finish(PushNotificationIOS.FetchResult.NoData);
  },

  onAction: function (notification) {
    console.log("ACTION:", notification.action);
    console.log("NOTIFICATION:", notification);
  },

  onRegistrationError: function(err) {
    console.error(err.message, err);
  },

  permissions: {
    alert: true,
    badge: true,
    sound: true,
  },

  popInitialNotification: true,
  requestPermissions: true,
});