Esper Agent notifications visible on device — suppress via Blueprint JSON

Android

When devices are provisioned or managed by Esper, the Esper Agent, Esper Helper, and Esper Remote Viewer apps generate system notifications that appear in the device notification shade. In production or lab environments where unattended or customer-facing devices must present a clean UI, these notifications are disruptive.

Why this happens

The Esper Agent and its companion apps surface status and activity notifications by default. There is no toggle in the Esper Console UI to suppress them, but the SET_APP_NOTIFICATIONS command in a Blueprint's Global Android Settings JSON gives you per-package control over notification visibility.

Suppress Esper Agent notifications via Blueprint JSON

1. Open the target Blueprint by navigating to Blueprints → [Blueprint Name] → Android Settings → Global Android Settings JSON.
2. Insert the following JSON into the Global Android Settings JSON field. This instructs the Esper Agent to disable notification display for each of its three companion packages.

   {
     "commands": [
       {
         "type": "Simple",
         "command": "SET_APP_NOTIFICATIONS",
         "commandId": "Hide Esper Agent Notifications",
         "packageName": "com.esper.app.Esper Agent",
         "notificationsState": "DISABLED"
       },
       {
         "type": "Simple",
         "command": "SET_APP_NOTIFICATIONS",
         "commandId": "Hide Esper Helper Notifications",
         "packageName": "com.esper.app.helper",
         "notificationsState": "DISABLED"
       },
       {
         "type": "Simple",
         "command": "SET_APP_NOTIFICATIONS",
         "commandId": "Hide Esper Remote Viewer Notifications",
         "packageName": "com.esper.app.remotemonitor",
         "notificationsState": "DISABLED"
       }
     ]
   }

   Important: If the Blueprint already contains a commands array, merge these three command objects into the existing array. Adding a second commands key will cause the configuration to be invalid.
3. Save the Blueprint.
4. Apply the updated Blueprint to your devices by navigating to Devices & Groups → [Group Name] → Blueprint → Apply. This pushes the updated configuration to all devices in the group.
5. Confirm Blueprint convergence by navigating to Devices & Groups → [Device Name] → Blueprint Status and verifying that all commands show a completed status with no failures or pending items.
6. Test on a provisioned device by pulling down the notification shade and confirming no notifications appear from Esper Agent, Esper Helper, or Esper Remote Viewer.

Verify: After Blueprint convergence — typically within 5 minutes of applying — the notification shade on affected devices should show no notifications from Esper Agent, Esper Helper, or Esper Remote Viewer. Android system notifications and notifications from other apps should continue to appear normally. Bug report prompts are unaffected.

If this doesn't resolve it

• Notifications persist after convergence: Navigate to Devices & Groups → [Device Name] → Blueprint Status and check for failed or pending commands. A failed SET_APP_NOTIFICATIONS command typically indicates the device is running an Esper Agent version that does not support this command. Navigate to Devices & Groups → [Device Name] → Apps and confirm the Esper Agent is on a current version via Esper Software Updates.
• Notifications are suppressed on most devices but persist on specific models: Some device manufacturers apply their own notification management layers that can override MDM-level notification commands. Collect a bug report from an affected device by navigating to Devices & Groups → [Device Name] → Actions → Generate Bug Report and note the device make, model, and Android version.
• Supervisor Plugin conflict: If your environment uses a Supervisor Plugin, check whether a conflicting notification policy is applied at the plugin level that may override the Global Android Settings JSON configuration.

If the issue persists after checking the above, contact Esper Support with the device bug report, the Blueprint JSON in use, and the Blueprint Status screenshot from the affected device.

Still need help?

If you're still seeing unwanted Esper Agent notifications after applying the Blueprint JSON configuration, please submit a support ticket and include your device model, Android OS version, and the specific Blueprint JSON settings you've applied.