As soon as I heard about Apple's new Safari push notifications on OS X Mavericks, I got excited to offer it to our readers at However, looking into the details I became worried as it wasn't as simple as I previously imagined.

Then, I found out about Pushwoosh and by that time they had already published a quick tutorial for everyone to easily deploy Safari's notifications via their service. It worked like a charm for us and we even received a personalized support service while the Pushwoosh team updated their WordPress plugin.

I'm very satisfied with the service! Congrats, guys! ;-)

Rafael Fischmann

Founder and editor-in-chief


Native iOS SDK

Download iOS8 SDK Download Sample SDK API Docs

As per May 14th 2014 updated Pushwoosh SDK no longer performs automatic push notifications registration.

If you wish to force old behavior:

1. Add Pushwoosh_AUTO key to the Info.plist with the value true

2. Add -ObjC flag to the Linker Flags in your project.

3. Skip steps 3.1 and 3.2 of the current guide.

NOTE: Simulator is not able neither to subscribe nor receive push notifications. Push Notifications SDK supports iOS 4.0 and higher.

To integrate Pushwoosh into your application you need to do simple following steps:

1. Add Pushwoosh.framework to your project.

2. In your Info.plist add the following key Pushwoosh_APPID with your Pushwoosh Application ID string value

3.1. Add the following import definitions to the AppDelegate.m file.

@import CoreLocation;
@import SystemConfiguration;
@import AVFoundation;
@import ImageIO;

#import <Pushwoosh/PushNotificationManager.h>

3.2. Add the following code to the didFinishLaunchingWithOptions function.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
	//lots of your initialization code

	//-----------PUSHWOOSH PART-----------
	// set custom delegate for push handling, in our case - view controller
	PushNotificationManager * pushManager = [PushNotificationManager pushManager];
	pushManager.delegate = self;
	// handling push on app start
	[[PushNotificationManager pushManager] handlePushReceived:launchOptions];
	// make sure we count app open in Pushwoosh stats
	[[PushNotificationManager pushManager] sendAppOpen];
	// register for push notifications!
	[[PushNotificationManager pushManager] registerForPushNotifications];

    return YES;

3.3. Add the following code to your UIApplicationDelegate (same file as above).

// system push notification registration success callback, delegate to pushManager
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
	[[PushNotificationManager pushManager] handlePushRegistration:deviceToken];

// system push notification registration error callback, delegate to pushManager
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
	[[PushNotificationManager pushManager] handlePushRegistrationFailure:error];

// system push notifications callback, delegate to pushManager
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
	[[PushNotificationManager pushManager] handlePushReceived:userInfo];

3.4. To handle push notifications add the following function to your UIApplicationDelegate (the same file as three steps above)

- (void) onPushAccepted:(PushNotificationManager *)pushManager withNotification:(NSDictionary *)pushNotification {
	NSLog(@"Push notification received");

If you would like to hide notification alerts when the app is in the foreground, simply set Pushwoosh_SHOW_ALERT value to NO in your Info.plist

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

For load balancing purposes we may need to change the API endpoints in your application. This happens automatically and handled by our SDK. Please make sure that nothing in your app is blocking access to any URL that contains * in it.

NOTE: If your device is connected to the Internet via WiFi, and messages don’t get through to the device, please make sure APNs ports are not blocked by your firewall.

Push providers, iOS devices, and Mac computers are often behind firewalls. To send notifications, you will need to allow inbound and outbound TCP packets over port 2195. Devices and computers connecting to the push service over Wi-Fi will need to allow inbound and outbound TCP packets over port 5223.

The IP address range for the push service is subject to change; the expectation is that providers will connect by hostname rather than IP address. The push service uses a load balancing scheme that yields a different IP address for the same hostname. However, the entire address block is assigned to Apple, so you can specify that range in your firewall rules.

Push Notifications SDK API: