WebViewGold OneSignal Push

This plugin allows you to connect your Bubble app to the native push functionality of WebViewGold (an app template enabling you to convert your Bubble app, or any web app, into native iOS & Android apps).

***PLEASE NOTE***
1. Video Tutorial: https://www.youtube.com/watch?v=C0HBXlMSK2E
2. The plugin works using the WORKFLOW section of Bubble, so please run the action on a button or a similar element.
3. The plugin and the demo button in the demo page only works if you access the (demo) site using the WebViewGold.com app wrapper for iOS (turn on kPushEnabled and kPushEnhanceUrl) or Android (turn on PUSH_ENABLED and PUSH_ENHANCE_WEBVIEW_URL)
4. Our Terms and Conditions (https://www.onlineappcreator.com/terms) apply. We do not assume any liability for damages or losses resulting from the use of this plugin. By using this plugin, you acknowledge that its use is at your own risk. We make no warranties, express or implied, regarding the functionality, accuracy, or performance of the plugin. Furthermore, we are not liable for any incidental, consequential, or indirect damages, including but not limited to data loss, business interruption, or any other damages arising from the use or inability to use the plugin.
******************


This Bubble plugin is simple and powerful in the configuration: It supports sending push notifications to individual users, all users, and even sending images or deep-linking URLs.

To start, you will need an account with Onesignal.com. They offer free, unlimited push notifications. You will need to get your Rest Secret Key and your App ID from Onesignal.com.  Moreover, you will need a valid license of the WebViewGold.com app template for iOS or/and Android: https://www.webviewgold.com



In the Push Notification - Authorization (Header) Field, type in "Basic ONESIGNAL_REST_API_KEY" ( = put in your ONESIGNAL_REST_API_KEY here after the word "Basic". For example, the format should look like this:

Basic adlkiad9SCINdaicncjdhua8jsdDCDw8a9dj8j

or

Basic [ONESIGNAL_REST_API_KEY]

You will need to put your App ID in the plugin workflow section when you call the plugin.

If you want to send a notification to individual users (instead of all users), you will need to get the unique Player ID's of individual users from WebViewGold.

To get the "player id" from WebViewGold: Please fully read the WebViewGold documentation included in the WebViewGold download. You will need to store that Player ID with the user so you can retrieve it later. To get the individual user ID (Player ID) on Bubble for further processing and individual user push messages, WebViewGold will attach the unique user ID to the WebView URL. If your WebView URL is https://www.example.org, WebViewGold will call https://www.example.org?onesignal_push_id=XYZ instead. Only your FIRST URL request will get that GET variable, so save it in a session or in a cookie to access it on your linked pages. You will then want to grab that URL variable in Bubble to store it for use in this app.
Check the video https://www.youtube.com/watch?v=C0HBXlMSK2E to see how to send push notifications to specific users only. You can also send to multiple id’s if you comma-separate the IDs in the ID field properly.

Usage of Deep-Linking:

With the deep-linking functionality, you can set up a parameter to open a specific page or a particular state in your Bubble app when clicked on the push notification. To do this, you would first need to enable the feature in WebviewGold, and you will need to define your custom deep link URL in Webview Gold. Afterward, you can add the desired (state) URL with a custom field called "url" to each push notification, see https://www.webviewgold.com/docs/iOS/assets/img/onesignal_deeplinking.png

Attach images to Push Notifications:

You can dynamically insert an image that will appear in the push notification. Just put in a web-hosted url of the desired image. Consider AWS/Amazon Web Services for the image hosting URL.


We wish you lots of fun with this powerful plugin! Our support team will be happy to help you.