FAQ — Mobile App and Researcher Users
Frequently asked questions for researchers and field users accessing Survanta via the mobile app.
Q: How do I log in to the mobile app?
The app sends the user's email address and password when they sign in. Mobile JWT sign-in supports an active tenant user; it does not authenticate Website-only or Platform accounts. A new user can instead validate and accept a one-time organization invitation in the app, then sign in.
Q: What is a JWT token and do I need to worry about it?
A JWT is the bearer credential returned by mobile login. The client must store it appropriately, send Authorization: Bearer <token> to protected mobile endpoints, and stop using it at ExpiresAtUtc. The server exposes no refresh-token, silent-refresh, logout, or revocation endpoint. Integration clients use a different API-key scheme.
Q: How do I see my assigned tasks?
The app shows only tasks assigned to the signed-in active field user. The user can narrow the list by date range or completion status and move through paged results. There is no task-acceptance or in-progress transition.
Q: How do I complete a survey?
The app loads an allowed active survey and sends the completed response. It attaches a stable identifier to each submission so a recognized retry returns the response already accepted instead of creating a duplicate. There is no separate server-side endpoint for saving and resuming an unfinished response for the mobile client; the app saves unfinished responses on the device.
Q: How do I scan a QR code to access a survey?
The app handles QR scanning and sends the extracted token and optional passcode for resolution. The server resolves only single-survey or organization-active-survey access and returns public-safe survey or portal information; an invalid token is not treated as an authenticated assignment.
Q: What if I forget my password?
The mobile surface currently provides POST /api/Researcher/forgot-password to request a confirmation code and POST /api/Researcher/confirm-code to validate it. It does not expose a mobile endpoint that sets a new password, so do not present this as a complete reset-link flow. Use an available supported account-recovery channel after code confirmation.
Q: Can I complete surveys offline?
The documented mobile service is online: it does not expose offline survey-package download, queued local submission synchronization, or conflict-resolution contracts. A client may safely retry an online submission with the same stable identifier attached by the app, but that retry protection is not an offline mode.
Q: Who do I contact if I have problems with the app?
Contact your Tenant Admin for account status, permissions, invitation, task assignment, or tenant subscription issues. The current tenant/mobile controllers do not guarantee a Tenant Admin password-reset action; use the supported account-recovery/support channel for password changes. Technical API issues can be escalated to the Platform team.