Doc / Pushwoosh

Android

You need to register your app (create a project) in your Firebase account. The global configuration between Firebase and Pushwoosh is detailed here: http://docs.pushwoosh.com/docs/fcm-configuration.

What you’ll need regarding this add-on is to copy/paste 2 things to your WP-AppKit app edition screen, in the “Pushwoosh configuration” box:

• Pushwoosh Application Code: something like C77EC-3B228, found in Pushwoosh by clicking on your App.
• Sender ID: something like 41445960243, found in Firebase or in Pushwoosh by clicking on your App then “Configure”, then “Android” > “Edit”.

Then save your WP-AppKit app.

You can now export it, build it on PhoneGap Build and test to send pushs from Pushwoosh!

iOS

You need to register your app in your Apple Developer account. The global configuration between Apple and PushWoosh is detailed here (Mac OSX only): http://docs.pushwoosh.com/docs/apns-configuration.

If you want to create the needed certificates from Windows, you’ll find some help below. You’ll first need the openssl command line, for example by downloading OpenSSL binaries (https://www.openssl.org/community/binaries.html), or any tool that will bring you UNIX CLI commands (Cygwin, Git bash for Windows, etc.).

Generate a certificate request

Execute these commands:

openssl genrsa -out mykey.key 2048
openssl req -new -key mykey.key -out CertificateSigningRequest.certSigningRequest -subj "/emailAddress=yourAddress@example.com, CN=John Doe, C=US"

 

Convert .cer file to .p12 (export certificate)

Execute these commands:

openssl x509 -in apple_certificate.cer -inform DER -out apple_certificate.pem -outform PEM
openssl pkcs12 -export -inkey mykey.key -in apple_certificate.pem -out exported_certificate.p12

Then, enter the password. You’ll need to enter it in PushWoosh configuration later.

One thing you need to understand here is that these certificates are only useful for PushWoosh to communicate with Apple servers, you’ll then need to get different certificates to be able to build and deploy your application.

Sources for certificates generation with Windows:

• http://help.adobe.com/en_US/as3/iphone/WS144092a96ffef7cc-371badff126abc17b1f-8000.html
• http://help.adobe.com/en_US/as3/iphone/WS144092a96ffef7cc-371badff126abc17b1f-7fff.html

Device Push Token

If you want to use the “Test devices” PushWoosh feature, you may need to know your iOS device push token.

You can see this snippet to see how to retrieve it, using Xcode or displaying it directly in your app.

With Free Plan

If you don’t pay a subscription, you can still use WP-AppKit Deep Linking feature only by using the “URL” action.

This time, you’ll have to pass the whole URL, including your custom URL scheme to PushWoosh. Remove the default “http://” value from “URL” field, and type in your custom URL. It should follow this format:

customurlscheme://[route]

For example, to open the page with ID 1, included into the “all-pages” component, type in the following value:

customurlscheme://page/all-pages/1

With Premium Plan

With every PushWoosh premium plan, you can send Custom Data along each push message. This allows you to leverage a specific page (a route) to open.

To use this feature, add the route you want the app to follow when the user clicks on the notification into the PushWoosh Pass additional Custom Data to the app field. You can find this field under “Send Push > Action” tab, with any selected action.

The route should follow this format:

{ "route": "[route]" }

For example, to open the page with ID 1, included into the “all-pages” component, type in the following value:

{ "route": "page/all-pages/1" }

or to open the post with ID 222:

{ "route": "single/posts/222" }