EsperSdkNotFoundException on `activateSdk` call: device not enrolled or Esper Agent not present on device

Android

If you're seeing an EsperSDKNotFoundException error when calling activateSdk(), it means your device isn't enrolled in Esper or the Esper Agent isn't installed. This article walks you through identifying the issue and re-provisioning your device.

Before you begin

The Esper Device SDK requires the Esper Agent (Esper Agent) to be installed and active on your device. If the agent isn't present or properly provisioned, activateSdk() will fail with EsperSDKNotFoundException.

Step 1: Check if your device is enrolled in Esper

1. Log in to the Esper Console.
2. Go to Devices & Groups.
3. Search for your device by device ID or device name.
4. If your device does not appear in the Esper Console, enrollment has not completed successfully. Skip to Step 4 to re-provision.

Step 2: Verify the Esper Agent is installed on your device

1. On the affected device, open Settings.
2. Go to Apps or Application Manager.
3. Look for the Esper Agent (the package name varies by your setup, but often includes "esper" or your organization's name).
4. Confirm the app is installed and marked as active.
5. If the Esper Agent is not listed, your device was not properly provisioned. Skip to Step 4.

Step 3: Check Device Owner status (optional, requires ADB access)

If you have access to the device via ADB and want to verify Device Owner status:

1. Connect your device to a computer with ADB installed.
2. Run the following command:

adb shell dpm list-owners

3. The output should show the Esper Agent package as Device Owner. If the output is empty or shows a different package, provisioning did not complete correctly. Skip to Step 4.

Step 4: Re-provision your device

If your device is not enrolled or the Esper Agent is not installed, you need to re-provision it. Choose the provisioning method that matches your setup:

• QR code provisioning
• Zero-Touch Enrollment
• Knox Mobile Enrollment (KME)
• Android Esper Console (AMC)

See the Esper Provisioning Guide for detailed steps for each method.

Step 5: Verify enrollment and retry activation

1. After re-provisioning, go to Devices & Groups in the Esper Console and confirm your device now appears in the list.
2. Call activateSdk() again.
3. You should now see success in the onSuccess callback with no exception.

If the error persists after re-provisioning

If your device appears enrolled in the Esper Console but you still see EsperSDKNotFoundException, the Esper Agent service may be in a crashed or disabled state. Collect a bug report from your device:

1. In the Esper Console, go to Devices & Groups.
2. Select your device from the list.
3. Click Actions and select Bug Report.
4. Download the bug report and contact Esper Support with the following information:

• Device make, model, and Android OS version
• Esper Agent version installed on the device
• Full stack trace from the onFailure callback
• The bug report you collected

Still need help?

If you've completed all steps and the issue persists, submit a support ticket. Include the device details, Esper Agent version, stack trace, and bug report to help our team investigate faster.