Help and support
For the DoTask app on iPhone and Android. Questions: waeil.usa@gmail.com.
Getting started
- Get a free AI key. Go to aistudio.google.com/apikey, sign in with a Google account, choose Create API key, and copy the key.
- Allow AI use. Open DoTask and choose I teach or I'm a student. Read what DoTask sends to Google Gemini, then tap Allow and continue.
- Paste your key. In Settings, paste the key and tap Test connection.
- Try Demo School. In Teach, tap Try Demo School to explore a fictional school with sample students before you connect a real class.
Free key or paid key?
A free key is fine for trying DoTask and for your own study material. On the free tier, Google may use what you send to improve its products and people may review it, so Google asks you not to send personal information. For real student work, turn on billing for the key's project in Google AI Studio so it becomes a paid-tier key. Grading a whole class usually costs a few cents, and Settings shows your usage and an estimated cost. In the EEA, the UK and Switzerland, Google's terms require a paid-tier key.
Connecting your school's Canvas
DoTask signs in to Canvas through your phone's browser, so it never sees your Canvas password. Your school's Canvas administrator creates a developer key for DoTask once, and then every teacher at the school can connect. Send them the next section.
Then, in DoTask, open Teach, enter your school's Canvas address (the one you use in a browser, such as yourschool.instructure.com) and the Client ID your administrator gives you, and tap Sign in with Canvas. Sign in on the Canvas page that opens and tap Authorize. DoTask can only do what your own Canvas role allows.
Use DoTask with real classes only as your school's policies allow, including FERPA.
For Canvas administrators
In Canvas, go to Admin, choose your account, then Developer Keys. Choose + Developer Key, then + API Key, and use these settings:
- Key Name: DoTask
- Owner Email: your email address
- Redirect URIs:
com.agapecare.dotask:/oauth/canvas(exactly this, on its own line) - Client Type: Public, if your Canvas offers this option. DoTask signs in with PKCE, so phones never need to hold a client secret. If your Canvas has no Client Type option, give teachers the key's client secret too (choose Show Key); they enter it under "Client secret" in DoTask, which keeps it in the phone's Keychain or Keystore.
- Enforce Scopes: off. This version of DoTask does not ask Canvas for individual scopes when a teacher signs in, and Canvas turns such a sign-in down when the key enforces scopes. DoTask still acts only with each teacher's own Canvas permissions.
Save the key, switch its State to On, and give teachers the Client ID (the number in the Details column). DoTask acts only with each teacher's own Canvas permissions. Teachers can remove its access at any time under Account, Settings, Approved Integrations, and you can switch the key off to end access for everyone.
Every Canvas API call DoTask makes (as Canvas scope names, for your review)
url:GET|/api/v1/users/:idurl:GET|/api/v1/coursesurl:GET|/api/v1/courses/:course_id/usersurl:GET|/api/v1/courses/:course_id/assignmentsurl:GET|/api/v1/courses/:course_id/assignments/:idurl:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissionsurl:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_idurl:GET|/api/v1/courses/:course_id/students/submissionsurl:PUT|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_idurl:PUT|/api/v1/courses/:course_id/assignments/:assignment_id/anonymous_submissions/:anonymous_idurl:GET|/api/v1/courses/:course_id/discussion_topicsurl:GET|/api/v1/courses/:course_id/discussion_topics/:topic_idurl:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id/viewurl:POST|/api/v1/courses/:course_id/discussion_topicsurl:POST|/api/v1/courses/:course_id/discussion_topics/:topic_id/entriesurl:POST|/api/v1/courses/:course_id/discussion_topics/:topic_id/entries/:entry_id/repliesurl:GET|/api/v1/announcementsurl:GET|/api/v1/conversationsurl:GET|/api/v1/conversations/:idurl:PUT|/api/v1/conversations/:idurl:POST|/api/v1/conversations/:id/add_message
DoTask calls no other Canvas endpoints. If your school requires scoped developer keys, write to us and tell us.
Troubleshooting
The voice tutor cannot hear me
The voice tutor needs microphone permission. On iPhone, open Settings, then DoTask, and turn on Microphone. On Android, open Settings, then Apps, DoTask, Permissions, Microphone, and choose Allow only while using the app. Then start the tutor again.
The camera does not work
Taking a photo of a page and "Show my camera" need camera permission. Turn on Camera in the same place as the microphone. Everything else in DoTask works without it.
"Canvas did not accept the sign-in"
- Check the Canvas address. Use the address of your Canvas in a browser, such as yourschool.instructure.com, not your school's home page.
- Check the Client ID with your administrator, and check that the developer key's State is On.
- The key's Redirect URIs must contain exactly
com.agapecare.dotask:/oauth/canvas. - If the message mentions invalid_scope, the developer key has Enforce Scopes switched on. Ask your administrator to switch it off for this key.
- Sign in again. Canvas sign-ins can expire, or be removed under Approved Integrations.
Key errors and limits
- "API key not valid": copy the whole key again from Google AI Studio, with no spaces, and tap Test connection. If you restricted the key in Google Cloud, it must allow the Generative Language API.
- "Quota exceeded" or "Resource exhausted": the free tier has limits per minute and per day. Wait a minute, try again the next day, or turn on billing for a paid-tier key with higher limits.
- Region or tier not allowed: you may need a paid-tier key. In the EEA, the UK and Switzerland, Google's terms require one.
An answer looks wrong
AI makes mistakes. Everything DoTask writes is a draft, so check grades, feedback and facts before you post or share them.
Delete your data
- In the app: open Settings, tap Delete all, and type DELETE to confirm. This erases student history, drafts, study files and the activity log from this device and cannot be undone, so tap Back up first if you want a copy.
- Your key and Canvas sign-in: Delete all keeps these, so clear the API key field in Settings and choose Sign out of Canvas. Do this before you uninstall: on iPhone, iOS can keep Keychain items after an app is deleted.
- Elsewhere: delete any backup files you saved, delete your API key in Google AI Studio if you no longer need it, and remove DoTask under Approved Integrations in Canvas.
We hold no copy of your data, so there is nothing to delete on our side. The privacy policy has the details.
Contact
Email waeil.usa@gmail.com with your phone model, the DoTask version and what happened. Please never send student information, API keys or passwords.
DoTask is independent and is not affiliated with Instructure (Canvas) or Google.