Skip to content

Test your integration

After you integrate the Pushwoosh SDK and connect your messaging channels, register test devices and send a test message to check that everything works.

Register test devices

Anchor link to

Test devices let you preview how a message looks before you send it to your audience. Register a separate test device for each channel you want to check.

  • Push: Requires the app with the Pushwoosh SDK installed. Set up QR deep links once, register from the app, or add the device by HWID. Set up push test devices
  • Email: No app-side integration. Add an email address in Control Panel and confirm it with a verification code. Set up an email test device
  • SMS: No app-side integration. Add a phone number in E.164 format in Control Panel and confirm it with a verification code. Set up an SMS test device

You can also register devices through the API:

  • createTestDevice: registers a device by push token, without the manual Create test device form.
  • listTestDevices: returns the devices already registered for an application.

Test devices are application-specific. Configure them separately for each application.

Send a test message

Anchor link to

After test devices are registered, send a test in one of these ways:

  • Control Panel: Use the Test push notification button in the Push Preset form. For email and SMS, send a test from the message form after those test devices are registered.
  • API: Call notify with test_devices: true in the transactional block. The message goes to the application’s test devices without opening the Push Preset form.
  • Journey: Build a short journey that targets only your testers, then launch it.

Test a journey with a test segment

Anchor link to

To test a journey on a limited audience, create a Segment of test users, use it as the journey entry, and launch the campaign.

  1. Create a Segment that includes only test users, by either:
    • Uploading a CSV file with the necessary conditions. Learn more
    • Assigning a unique Tag value to your test devices by calling the /setTags API method. Then create a segment using this Tag value.
  2. Go to Campaigns → Create Campaign → Build a journey from scratch, or use one of the pre-built customer journey templates.
  3. Add the Audience-based entry element to the canvas and select the Segment you created.
  4. Add a message element such as push, SMS, or email.
  5. Select existing content, or create custom content.
  6. Configure the remaining journey elements as needed.
  7. Click Launch Campaign to start the test.