Testing your mobile push notification setup

How to run a test

Follow these steps for every test scenario. Depending on what you're testing, add the relevant configuration in step 5 before sending.

1. Launch the app on a physical device — emulators can't receive push notifications.

2. Copy your deviceUUID from the console.

3. Find your customer by deviceUUID in Maestra and verify the following on their profile page:

   • Notifications permission status: Allowed
     Maestra checks whether the user has allowed the app to display notifications. Checked automatically by the SDK on every app launch. On iOS — requires an explicit system prompt. On Android — granted by default based on store settings.

   • Device status: Activated

     Maestra checks whether the device has a valid push token. The token is obtained via the mobile SDK and stays active until APNs or Firebase signals it's no longer valid — which typically means the user uninstalled the app.

   
   
   

4. Create a mobile push campaign and fill in the title and body text.

   📘

   If you are testing mobile push notifications on iOS-based app in the Sandbox environment, remember to tick the "Sandbox Message" box in the campaign profile.
   Details on the Sandbox environment

5. Add the relevant configuration for your test scenario — see the options below.
   Feel free to test just one option or go ahead and try them all at once.

   • Basic push
   • Push with an image
   • Push with action buttons
   • Click tracking

6. Click Test Sending and enter your deviceUUID in the search field.

7. Check the checkbox next to the recipient you want to send the message to and send the message.

8. Open your test message list and confirm the last push shows a Sent status.

9. Verify the result. The notification should appear on your phone.

Test scenarios

Basic push

No extra configuration needed — skip step 5.

---

Push with an image

In step 5, add an image — either paste the image URL or upload it directly to the server.

---

Push with action buttons

In step 5, fill in the button text and button URL fields.

---

Click tracking

No extra configuration needed — skip step 5.

After sending, tap the notification on your device.