Troubleshooting mobile SDKs issues can be difficult. You need a lot of up-front information from your development team to troubleshoot a problem, and the nature of mobile development introduces many variables that make diagnosing issues harder. To make the process smoother, include the following information so that our Customer Support team can assist you efficiently.

Note: We do not support any implementation of any of our mobile SDK within wrappers.

Include as much basic SDK information as possible

The information should include:

SDK version

This is necessary for our Customer Support team and developers to scope the issue. If the issue started after upgrading to a more recent version, include that information. Our SDK documentation includes release notes for each product as well as ongoing known issues for the latest version. We recommend checking them to see if the issue you encounter is listed there.

Operating system version

Often, issues are scoped to specific Android/iOS versions. Please include the OS versions you are testing with.

Logger results

Each section of documentation for our SDKs has a code snippet under “Debugging” or “Advanced topics” to add to your project to enable verbose logging. Enable it when reproducing the issue and provide any related logs when submitting a ticket. See the links below for the snippets:

Recordings or screenshots

Any recording of the issue goes a long way, complements the logs very well, and simplifies the explanation of the issue.

Dependencies

If the issue mentions a library or one of the SDK dependencies, please mention it. Using a higher version than the one used by the SDK can lead to unexpected results.

Relevant code

It is always helpful to include your initialization code to see how and when you’re starting up the SDK. If you have multiple SDK settings and Flow Builder, please include it. This will help us know which one you are using.

Timeline

When did the issue start? Has it always been an issue? Include a date when the behavior changed. Also include if the issue coincided with any code changes, such as an upgrade to a new version of the Zendesk SDK, other dependencies, or a change to your code.

Reproduction steps and pattern in occurrence

If you are able to reproduce the issue, please list them in the ticket. In the same manner, if the issue doesn't occur in every case but you can identify a pattern in those case, please add this information to the conversation.

Create an example app that demonstrates the issue

If you can reproduce the issue, please provide an example app with the minimum possible code to reproduce the problem. Remove any business logic so that only the relevant part related to the Zendesk issue remains.

If you cannot reproduce the issue, please gather as much of the above information as possible and ensure that you know how your customer is experiencing the issue, how it manifests, and what they were doing.

Important: Due to the nature of custom development efforts, the Zendesk Customer Support and engineering teams do not troubleshoot and debug production applications. There are many variables involved to effectively diagnose the issue. We need sample applications that demonstrate the problem in an isolated manner.