How to start Example app

For Mobile Messaging Plugin we've provided an Example app, which can be easily setup and started with your credentials.

How to run example application

Prepare application configuration in portal

As the first step, you will need to have a Mobile Messaging application profile set up in Infobip Portal for your account. If you already have it, then you can skip this section, otherwise:

1. Create new application on Infobip portal.
2. Navigate to your Application where you will get the application code.

Android

1. Prepare your Firebase Cloud Messaging to get google-services.json file and Private Key JSON file.

2. Mark the "Available on Android" checkbox in your application profile.

3. Upload previously obtained Google Private Key JSON file.

   

iOS

1. Prepare your App ID, provisioning profiles and APNs certificate (APNs Certificate Guide).

2. Mark the "Available on iOS" checkbox in your application profile.

3. Click on "UPLOAD" under "APNS Certificates" and locate the .p12 certificate you exported from your Keychain earlier.

   

Run example application

1. Provide your application code in /Example/App.js and /Example/ios/NotificationExtension/NotificationService.swift files:

  configuration = {
    applicationCode: 'Your application code',
    ...
  };

(iOS only)

 MobileMessagingNotificationServiceExtension.startWithApplicationCode( <# Your Application Code #> )

Android

1. Add google-services.json you obtained in previous step to the Example/android/app folder as described in Firebase documentation.
2. Run npm install from the Example app folder to install dependencies.
3. Run npx react-native run-android from the Example app folder to run example application.

Warning The google-services.json file must match the application ID configured in Example/android/app/build.gradle (the applicationId field). If you change the application ID, you need to download a new google-services.json from the Firebase Console that matches the updated package name.

iOS

1. Run npm install from the Example app folder to install dependencies.
2. Install CocoaPods dependencies — run cd Example/ios & pod install.
3. Open Xcode and select your development team for signing the app for both the Example and MobileMessagingNotificationServiceExtension targets.

Warning Before running the example app on iOS, make sure:

• The bundle ID (set under PRODUCT_BUNDLE_IDENTIFIER in Xcode build settings) matches the one registered in your Apple Developer Portal and is associated with your signing certificate and provisioning profile.
• The App Group ID (configured in entitlements and Info.plist under the com.mobilemessaging.app_group key) is registered in the Apple Developer Portal and is added to both your main app's App ID and the Notification Service Extension's App ID.
• Your provisioning profiles include the App Group capability for both targets.

If any of these are misaligned, the build, signing, or message delivery will fail.

Running In-app chat example

Within the example application we offer chat for testing all available In-app chat features first-hand, and for comparing its source code with yours, in case you are facing any issue in your implementation.

In order to test the In-app chat in example application follow instructions in In-app chat Intro.

Our In-app chat has different list of options, from the basic ways of presenting the In-app chat, to not forgetting the change of language for the UI, multiple threads feature, etc. We invite you to play with it and discover everything Livechat has to offer.

Running In-app chat example with WebRTC calls

Within the example application we offer chat with calls for testing all calls features first-hand, and for comparing its source code with yours, in case you are facing any issue in your implementation.

In order to test the In-app chat with calls in example application follow instructions in WebRTC Calls and UI section.

Our calls UI has different list of options: ability to capture video through both, front and back camera, option to mute and use the speaker, ability to capture and share the screen of your mobile device, option to minimise the call UI in a picture-in-picture mode, and more. We invite you to play with it and discover everything Livechat calls have to offer.