1
Send the recording
Your platform sends a link to the MP3, which rubric to use, your teacher ID, the board, grade, and subject IDs, and the date of the lesson. All of those are required, and an institution ID is optional. The link is checked immediately: it must start with
https://, end in .mp3, and be reachable without a password. The date cannot be in the future.You get back an analysis ID straight away. The analysis starts as in progress.2
ClassTrack transcribes the lesson
The recording is turned into text. English and Hindi are recognized. The transcript is kept and returned with the finished analysis, so the feedback can always be checked against what was said.
3
ClassTrack scores the lesson
The transcript is read against every criterion in your rubric. For each one, ClassTrack gives a score written as text, what it observed, what to do about it, and examples taken from the lesson. It then adds an overall judgment, also as text, a summary, insights across whichever teaching and classroom areas it decided to comment on, and an action plan split into immediate actions, short term goals, and long term development.
4
Read the feedback
Ask for the analysis by its ID. While it is still working, it tells you so. When it is done, you get the full feedback and the transcript.
How do we know when it is ready?
Two ways. Your platform can ask for the analysis whenever it likes, and the answer says whether it is still in progress. Or you can set up a webhook, an automatic message CrazyGoldFish sends to your server, and be told as soon as an analysis finishes or fails.What happens if it fails?
The analysis is marked as failed and your webhook, if you have one, is told. The usual cause is a recording that could not be fetched or read from your link. Check that the link still opens with no login, then send the recording again as a new analysis.Frequently asked questions
Can we stream a lesson as it happens?
Can we stream a lesson as it happens?
No. ClassTrack analyzes a complete recording after the lesson.
Can an analysis be run again with a different rubric?
Can an analysis be run again with a different rubric?
An analysis is tied to the rubric it was created with. To score the same lesson against another rubric, send the same recording again as a new analysis.
How long does an analysis take?
How long does an analysis take?
It runs in the background and the time depends on the length of the recording, because the whole lesson has to be transcribed first. Your platform does not wait: it either checks the analysis or waits for the webhook.
What happens to the recording?
What happens to the recording?
ClassTrack fetches the file from your link in order to transcribe it, and the transcript is stored with the analysis and returned to you. There is no upload endpoint, so the MP3 itself stays in the storage you host it in.
Next steps
Use cases
How schools and platforms use ClassTrack.
Developer guide
Analyze a recording with the API, step by step.