Send Push Guide

This tutorial demonstrates how to use Send Push form to send push notifications.

First of all, login into your Pushwoosh Control Panel and click on the application you would like to send push to.

We have separated all our features into two sets of tabs – the first set of tabs is applicable to all platforms, and consists of the General, Scheduling, Additional Data and Filters tabs.

The second group of tabs is platform-specific, and allows you to customize your notifications for each platform.

General tab

Screen Shot 2014-03-11 at 18.20.09

Sending multi-language notifications:

With Multi-language feature you can create push notifications in different languages with one click, and they will be delivered depending on device locale settings. Talk to your users in their language!

Language tabs are intended to compose language-specific pushes to devices with corresponding locale settings. The default language in Pushwoosh is English; if no content for English is specified, Pushwoosh randomly chooses the language as a default from those that are set.

For example, if you input a message only for English (“en” tab), all other language subscribers will receive the content in English, as it is a default language. If you input the message only for “nl” and “fr”, the message will be send to all devices, but English and Turkish subscribers will receive a randomly chosen message – intended either for “nl” or “fr”, since “en” is empty.

In order to send language-specific pushes to language-specific devices only, you should apply Language filters to them. Please refer to Filters tab paragraph below.


Scheduling tab

Screen Shot 2014-03-11 at 18.20.13

Use Scheduling tab to set time you want your notifications to be sent. By default, all notifications are set to be “sent now”, right after you press Woosh!

If you would like to send notifications at a certain time, choose “Send on” and pick the time and date; scheduling date limit is set to one month.

Another sufficient scheduling feature is “Send according to users’s timezone”. Set the toggle to ON, and your users will be notified at the time you set. Please note that in this case the push status (https://cp.pushwoosh.com/notifications) will be changing from pending to processing back and forth for 24 hours, until all timezones are covered.

If you send the push according to user’s timezone, and the date & time you specified has already passed in some timezones, the push will be sent to these timezones immediately. All other timezones will receive the push according to their local time.


Additional Data tab

Screen Shot 2014-03-11 at 18.20.20

URL: You can send a URL along with a push notification. When a user opens this notification, the application will be launched first, and then the URL will be opened in a default browser, for example, Safari on iOS.

Rich HTML Page: Choose one of the rich media pages you have created in the Rich Pages section. These pages are opened in a webview of your application, once a user opens notification. Thus, when a user is done viewing this page, he or she comes back to your application.

Custom data: you can pass any additional JSON data in a {“key”:”value”} format, which you may use for deep linking.


Filters tab

Screen Shot 2014-03-11 at 18.20.23

In this tab you can apply a filter which you should create in the Filters section first.

Use filters if you would like to send push to a specific group of devices only.

For example, in order to send push to devices with French locale only, you have to create a #Language(fr) filter first, and apply this filter to your push. Thus, the message will be sent only to devices subscribed with the French language.

If you do not wish to use a chosen filter, click the “Clear filter” button.


PLATFORM SPECIFIC tabs

iOS

Screen Shot 2014-03-11 at 18.20.51

Badges: an iOS badge number you would like to send with your push. Use +n / -n to increment / decrement the current badge value. Sending 0 clears the badge from your app’s icon.

Sound: here you can specify the name of a custom sound file in the main bundle of your application.

Check Send silent notification if you would like your push to appear without any sound on iOS devices.

Check Newsstand notification to send push to your iOS newsstand application.


Android

Screen Shot 2014-03-11 at 18.21.18

Header: You can specify your Android notification header here.

Sound: Here you can specify the name of a custom sound file in the “res/raw” folder of your application, without the file extension.

Icon: Enter the path to the notification icon.


Windows Phone

Screen Shot 2014-03-11 at 18.21.24

First of all, choose the Windows Phone notification type – toast or tile. You can customize your Tile type push by adding the following parameters:

Count: The number displayed on the front side of the tile.

Front background image: Enter full path to the image to be used as a background for the front side of the tile.

Back content: Single line of text in the top of the back side of the tile.

Back background image: Enter full path to the image to be used as a background for the back side of the tile.

Back title: Single line of text in the bottom of the back side of the title.


Windows 8

Screen Shot 2014-03-11 at 18.22.30

Since Windows 8 provides over 60 toast, tile, raw and badge templates, we added only toast templates to the GUI, since they are used more then the others. Tile, raw and badge templates are available via Remote API only.

The first step is to choose the template from the list on the right to unlock corresponding inputs. Then you can input content for all languages you need. Due to the multiple number of fields in Windows 8 push templates, we had to separate it from all other platforms. It has its very own set of language tabs, which you should use the same way as universal language tabs.


Amazon

Screen Shot 2014-03-11 at 18.36.20

Header: You can specify your Amazon notification header here.

Sound: Here you can specify the name of a custom sound file in the “res/raw” folder of your application, without the file extension.

Icon: Enter the path to the notification icon.


Safari

Screen Shot 2014-03-11 at 18.24.59

Title: Specify your Safari notification title here. This is field is required, otherwise the push will not be delivered to your users.

Action button label (optional): Specify the custom action button label here. If not set, “Show” will be displayed as a default.

URL field: Type in the part of the URL instead of a placeholder you specified in the app’s Safari configuration. A user will be redirected to this URL in Safari upon opening your notification.


That’s it! Easy, isn’t it?