Need help with react-native-voip-push-notification?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

160 Stars 69 Forks ISC License 69 Commits 3 Opened issues


React Native VoIP Push Notification - Currently iOS only

Services available


Need anything else?

Contributors list

React Native VoIP Push Notification

npm version npm downloads

React Native VoIP Push Notification - Currently iOS >= 8.0 only

RN Version

  • 1.1.0+ ( RN 40+ )
  • 2.0.0+ (RN 60+)


You should use this module with CallKit:

Now Apple forced us to invoke CallKit ASAP when we receive voip push on iOS 13 and later, so you should check react-native-callkeep as well.

Please read below links carefully:

When linking against the iOS 13 SDK or later, your implementation of this method must report notifications of type voIP to the CallKit framework by calling the reportNewIncomingCall(with:update:completion:) method

On iOS 13.0 and later, if you fail to report a call to CallKit, the system will terminate your app.

Repeatedly failing to report calls may cause the system to stop delivering any more VoIP push notifications to your app.

If you want to initiate a VoIP call without using CallKit, register for push notifications using the UserNotifications framework instead of PushKit. For more information, see UserNotifications.

Issue introduced in this change:

When received VoipPush, we should present CallKit ASAP even before RN instance initialization.

This breaks especially if you handled almost call behavior at js side, for example:
Do-Not-Disturb / check if Ghost-Call / using some sip libs to register or waiting invite...etc.

Staff from Apple gives some advisions for these issues in the below discussion:

You may need to change your server for APN voip push:


value should be
for iOS 13
And be aware of
value, adjust according to your call logics

About Silent Push ( Background Push ):

VoIP pushes were intended to specifically support incoming call notifications and nothing else.

If you were using voip push to do things other than

nootify incoming call
, such as:
cancel call
background updates
...etc, You should change to use Notification Service Extension, it contains different kind of pushs.

To use

Background Push
to Pushing Background Updates to Your App, You should: 1. Make sure you enabled
Signing & Capabilities
Background Modes
Remote Notifications
enabled 2. When sending background push from your APN back-end, the push header / payload should set: * content-available = 1 * apns-push-type = 'background' * apns-priority = 5


npm install --save react-native-voip-push-notification
# --- if using pod
cd ios/ && pod install

The iOS version should be >= 8.0 since we are using PushKit.

Enable VoIP Push Notification and Get VoIP Certificate

Please refer to VoIP Best Practices.

Make sure you enabled the folowing in

Signing & Capabilities
: *
Background Modes
Voice over IP
enabled *
Push Notifications

AppDelegate.m Modification


#import /*


On RN60+, auto linking with pod file should work.

Linking Manually

### Add PushKit Framework:

  • In your Xcode project, select
    Build Phases
    Link Binary With Libraries
  • Add

### Add RNVoipPushNotification:

#### Option 1: Use rnpm

  rnpm link react-native-voip-push-notification

Note: If you're using rnpm link make sure the

Header Search Paths
. (In step 3 of manually linking)

#### Option 2: Manually

  1. Drag
  2. Select
    Build Phases
    Link Binary With Libraries
    • Drag
      Link Binary With Libraries
  3. Select
    Build Settings
    • In
      Header Search Paths
      , add

API and Usage:

Native API:

Voip Push is time sensitive, these native API mainly used in AppDelegate.m, especially before JS bridge is up. This usually

  • (void)voipRegistration
    --- register delegate for PushKit if you like to register in AppDelegate.m ASAP instead JS side ( too late for some use cases )
  • (void)didUpdatePushCredentials:(PKPushCredentials *)credentials forType:(NSString *)type
    --- call this api to fire 'register' event to JS
  • (void)didReceiveIncomingPushWithPayload:(PKPushPayload *)payload forType:(NSString *)type
    --- call this api to fire 'notification' event to JS
  • (void)addCompletionHandler:(NSString *)uuid completionHandler:(RNVoipPushNotificationCompletion)completionHandler
    --- add completionHandler to RNVoipPush module
  • (void)removeCompletionHandler:(NSString *)uuid
    --- remove completionHandler to RNVoipPush module


  • registerVoipToken()
    --- JS method to register PushKit delegate
  • onVoipNotificationCompleted(notification.uuid)
    --- JS mehtod to tell PushKit we have handled received voip push


  • 'register'
    --- fired when PushKit give us the latest token
  • 'notification'
    --- fired when received voip push notification
  • 'didLoadWithEvents'
    --- fired when there are not-fired events been cached before js bridge is up

import VoipPushNotification from 'react-native-voip-push-notification';


class MyComponent extends React.Component {


// --- anywhere which is most comfortable and appropriate for you,
// --- usually ASAP, ex: in your app.js or at some global scope.
componentDidMount() {

    // --- NOTE: You still need to subscribe / handle the rest events as usuall.
    // --- This is just a helper whcih cache and propagate early fired events if and only if for
    // --- "the native events which DID fire BEFORE js bridge is initialed",
    // --- it does NOT mean this will have events each time when the app reopened.

    // ===== Step 1: subscribe `register` event =====
    // --- this.onVoipPushNotificationRegistered
    VoipPushNotification.addEventListener('register', (token) => {
        // --- send token to your apn provider server

    // ===== Step 2: subscribe `notification` event =====
    // --- this.onVoipPushNotificationiReceived
    VoipPushNotification.addEventListener('notification', (notification) => {
        // --- when receive remote voip push, register your VoIP client, show local notification ... etc

        // --- optionally, if you `addCompletionHandler` from the native side, once you have done the js jobs to initiate a call, call `completion()`

    // ===== Step 3: subscribe `didLoadWithEvents` event =====
    VoipPushNotification.addEventListener('didLoadWithEvents', (events) => {
        // --- this will fire when there are events occured before js bridge initialized
        // --- use this event to execute your event handler manually by event type

        if (!events || !Array.isArray(events) || events.length < 1) {
        for (let voipPushEvent of events) {
            let { name, data } = voipPushEvent;
            if (name === VoipPushNotification.RNVoipPushRemoteNotificationsRegisteredEvent) {
            } else if (name === VoipPushNotification.RNVoipPushRemoteNotificationReceivedEvent) {

    // ===== Step 4: register =====
    // --- it will be no-op if you have subscribed before (like in native side)
    // --- but will fire `register` event if we have latest cahced voip token ( it may be empty if no token at all )
    VoipPushNotification.registerVoipToken(); // --- register token

// --- unsubscribe event listeners
componentWillUnmount() {

... }

Original Author:



ISC License (functionality equivalent to MIT License)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.