Initiate sessions with push

For use with Android, iOS, React Native, and Xamarin SDKs only.

By default, Cobrowse Native SDKs for Android and iOS open a socket to handle incoming session requests.

You may optionally send new session requests over the native push channel. Cobrowse supports this configuration out of box using Firebase Cloud Messaging (FCM).

For sessions to start by push the user needs to have the client application open in the foreground. This method will not send a visible push notification to the user.

If you wish to use visible push, this is possible using your own existing push channel and can be fully customized.

Setup your Firebase account:

  1. Create an account for Firebase.

  2. Create a new project from your Firebase console.

  3. In your Project settings, add entries for your Android and iOS apps.

  4. For iOS, you will need generate an APNs Authentication Key (recommended) or APNs Certificate from You may then upload it under Project Settings -> Cloud Messaging.

  5. Please generate a Firebase Private Key file from Project Settings -> Service Accounts, download it and enter its contents into your Firebase settings.

A few changes to native code as described below.

If you are already using push notifications in your app, there is nothing further required on the native side.

If you are not already using push notifications in your app, please enable them under Capabilities in Xcode and request push permission from the user whenever is appropriate:


func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
    [application registerForRemoteNotifications];

Last updated