Test Devices

Preview your messages on a device before sending them to users

Watch this video where our dedicated Customer Success team will guide you through the onboarding process at Pushwoosh, from setting up projects to sending your first communications.

You can use Test Devices to preview how push notifications look on a device before sending them to the app users. In order to do that, you need to register your device (with your app installed) as a Test Device.

There are two ways it can be done: manual and automatic.

After you have added your test device, you can go to Channels → Push Notification → One time push and click on the Test Woosh button. The notification will be sent only to registered test devices.

Adding test devices manually

1. To register a Test Device, first get the Device Push Token (taken from the successful /registerDevice call).

2. Go to Settings → Test Devices and click Add Devices:

3. Paste the device token to the corresponding field, give this device a name and choose its type. Click Save to apply changes.

Adding test devices automatically

This method is suitable only for iOS and Android devices.

1. Go to Settings → Test Devices and click Add Devices:

2. Scan the QR code. You will receive a deep link that the Pushwoosh SDK can parse to automatically register your device as a test one.

3. Add the received deep link to AndroidManifest.xml (Android) or Info.plist (iOS). For more details, follow the instructions for Android and iOS in the Implementation section.

Use QR readers right!

Many QR readers will open a link in their own webview. Make sure to open the scanned link in the native browser! (Usually, there's a button in many QR readers to open the link in a browser).

Implementation

Android

1. Integrate Pushwoosh SDK with your application.

2. Add DeepLinkActivity to your AndroidManifest.xml:

<activity
          android:name="com.pushwoosh.DeepLinkActivity"
          android:theme="@android:style/Theme.Translucent.NoTitleBar" >
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="pw-YOUR_PUSHWOOSH_APP_ID" />
  </intent-filter>
</activity>

Don't forget to replace YOUR_PUSHWOOSH_APP_ID in the xml above with your Pushwoosh App ID. Example: <data android:scheme="pw-ABCDE-EDCBA" />

3. Launch the application to subscribe for push notifications.

4. Scan the QR Code in Test Devices form using any appropriate QR Code scanner app*. A toast message will appear indicating the status of the test device registration.

* – most of the QR code scanning apps handle such deep links properly, here are just a few of them:

• QR & Barcode Scanner, Gamma Play

• QR & Barcode Scanner, Maker, AppSourceHub

iOS

1. Integrate Pushwoosh SDK with your application.

2. Add pw-YOUR_PUSHWOOSH_APP_ID URL scheme to the Info.plist file:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>com.pushwoosh.scheme</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>pw-YOUR_PUSHWOOSH_APP_ID</string>
    </array>
  </dict>
</array>

Don't forget to replace YOUR_PUSHWOOSH_APP_ID in the XML above with your Pushwoosh App ID. Example: pw-ABCDE-EDCBA

3. Launch the application to subscribe for push notifications.

4. Scan the QR Code in the Test Devices form using any appropriate QR Code scanner.