Send Push

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

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

We've split all features into two sets of tabs – the first set applies to all platforms: these are General, Scheduling, Additional Data and Filters tabs.

Tabs in the second set are platform-specific and let you customize notifications for each platform.

General Tab

Sending multi-language notifications. Multi-language lets you 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!

Use Language tabs to create language-speicific pushes for devices with corresponding locales. The default language in Pushwoosh is English; if no content for English is specified, Pushwoosh randomly chooses a default language 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 the default language. If you input the message only for “nl” and “fr”, the message will be sent to all devices, but English and Turkish subscribers will receive a randomly chosen message – intended for either Dutch (“nl”) or French (“fr”) subscribers, since “en”-message is empty.

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

Scheduling Tab

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

If you would like to send notifications at a certain time in the future, click “Send on” and choose the time and date; scheduling date limit is two weeks.

Both scheduled and non-scheduled pushes might be cancelled in the Push History section. This is possible only when the status of a push message is Pending, Waiting, or Processing. The status Done indicates that we've already sent the notification, in which case it's not possible to cancel it.

Another significant scheduling feature is “Send according to user’s timezone”. Set the toggle to ON, and your users will receive the message at the specified local time. Please note that in this case the push status 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.

Action Tab

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 the default browser, for example, Safari on iOS.

Rich Media. Send a deeply customized Rich Media page along with your push notification. Rich Media pages can contain formatted text, links, images, embed videos and other data. It allows to send colorful flyers, pictures and ads directly to your app. Rich Media pages are displayed in the web view, so you can easily come back to your application after closing the page.

Deep Link. Use Deep Links to drive user directly to a specific product or piece of content within your app instead of the home page.

Custom data. Pass any additional JSON parameters in a {“key”:”value”} format to your app.

Filters Tab

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

Filters are used to send push notifications to a specific segment 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

Badges. Set the iOS badge number to be sent with your push. Use +n / -n to increment / decrement the current badge value. Sending 0 clears badge from your app’s icon.

Sound. Specify the custom sound from the main bundle of your application.

iOS8 Category. Select a Category with the set of buttons for iOS8.

iOS Root Params. Root level parameters to the APS dictionary.

iOS10+ Media attachment. URL to any video, audio, picture or GIF for iOS rich notification.
See this guide for more details on iOS 10 Rich Notifications.

Send silent notification. Allows to send a silent push with content-available property. When a silent push arrives, iOS wakes up your app in the background, so you can get new data from your server or do background information processing.

Newsstand notification. Allows to send a push to your iOS newsstand application.

Expiration time. Sets the period after which the push won't be delivered if the device was offline.

Android

Header. Specify your Android notification header here.

Sound. Specify the custom sound filename in the “res/raw” folder of your application. Omit the file extension.

LED. Choose LED color, the device will do its best approximation.

Force Vibration. Vibrate on arrival; use for urgent messages only.

Icon. Path to the notification icon.

Banner. Enter image URL here. Image must be ≤ 450px wide, ~2:1 aspect, and it will be center-cropped.

Android root params. Root level parameters for the Android payload, custom key-value object.

Android Priority. Priority of the push in Android push drawer.

Expiration time. Set the period after which the push won't be delivered if the device was offline.

Notifications Channels. Starting from Android 8.0, you can create Notification Channels. To create a channel, there's two steps you need to do:

  1. Set up the channel’s configuration. Specify all required parameters, such as sound, vibration, LED and priority;
  2. Specify channel's name by adding the following key-value pair to Android root params: {“pw_channel”:“NAME OF CHANNEL”}

To send a notification to an existing channel, you need to specify the very same key-value pair in Android root params.

It is not possible to change the channel’s parameters after it’s created on the device.

BlackBerry

Header. Specify your BlackBerry notification header here.

Windows Phone

First, choose the Windows Phone notification type: Toast or Tile. Customize your Tile type push with the following parameters:

Count. The number displayed on the tile front.

Front background image. Full path to the image to be used as a background for tile front.

Back content. Single line of text at the top of tile backside.

Back background image. Full path to the image to be used as tile backside background.

Back title. Single line of text at the bottom of tile backside.

Windows 8

Windows 8 provides over 60 toast, tile, raw and badge templates, so we added only toast templates to our GUI since they're the most popular. Tile, raw and badge templates are available via Remote API only.

First, choose the template from the list on the right to unlock corresponding inputs. Then you can input content for all languages you need. The number of fields in Windows 8 push templates differs, so we had to separate it from all other platforms. It has its own set of language tabs, used just like the general language tabs.

Amazon

Header. Specify your Amazon notification header here.

Sound. Specify custom sound filename in the “res/raw” folder of your application. Omit the file extension.

Icon. Path to notification icon.

Banner. Full path to notification banner.

Expiration time. Period after which the push won't be delivered if the device was offline.

Safari

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 custom action button label here. If not set, “Show” will be displayed as a default.

URL field. Replace placeholder with part of URL you specified in the app’s Safari configuration. Users will be redirected to this URL in Safari upon opening your notification.

Expiration time. Set the period after which the push won't be delivered if the device was offline.

Chrome

Icon. Specify icon name from your extension resources or full path URL.

Title. Specify Chrome notification title.

Large image. Add a large image to your notification by specifying the full path URL to the image.

Buttons. Create custom buttons for your pushes. Specify the Title (required) and the URL (optional) for buttons if needed.

Duration. Specify time for push to be displayed. Set to infinity, if you would like to display notification until user interacts with it.

Expiration time. Set the period after which the push won't be delivered if the device was offline.

Easy, isn’t it?

Send Push

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