Accelero Edu Integration
The Accelero Edu integration connects ACCELERO to the Accelero Edu application, aimed at the school environment. The app allows the teacher to take attendance (attendance list) of a class directly from their phone, authenticating with their ACCELERO credentials. The recorded attendance is available in ACCELERO through the Attendance Report.
This integration is provided as a plugin (acceleroedu) and must be installed and enabled by IONGRADE's technical team. Contact support to check compatibility with your version of ACCELERO.
Current plugin version: 1.0.0 — compatible with ACCELERO 2.17.0 or higher.
What the integration does
With the plugin active, ACCELERO provides the Accelero Edu application with class and student data, authenticates teachers, and stores the attendance taken by the app.
| Feature | What happens in ACCELERO |
|---|---|
| Marking a class | A person category can be marked as a class, which then appears in the application |
| Class QR Code | Each class gets a QR Code that points to the app's address, identifying the school and the class |
| Password for Accelero Edu | A person (teacher) can have their own password to authenticate in the application |
| Teacher authentication | The app authenticates the teacher using the document (CPF) and password registered in ACCELERO |
| Query of classes and students | The app lists the enabled classes and the students of each class, with photo |
| Attendance recording | The attendance list sent by the app is recorded in ACCELERO (attendance + presence of each student) |
| Attendance Report | Report, within ACCELERO, of the recorded attendance, with filters by period, class, student, and teacher |
Allows the teacher to take class attendance from the application, reusing the person and category records already existing in ACCELERO, without parallel spreadsheets.
Configuration
Navigation path: Settings > Integrations - AcceleroEdu
The configuration screen has the General tab.
Screen Settings > Integrations - AcceleroEdu, General tab, showing the Operator, Authentication token, acceleroEdu URL, and School slug fields.
General tab — Integration data
| Field | Description |
|---|---|
| Operator | ACCELERO operator used by the integration. When not defined, the background process user is used |
| Authentication token (APP > Accelero) | Token used in the communication between the application and ACCELERO |
| acceleroEdu URL | Address (URL) of the Accelero Edu application. It composes the link recorded in the class QR Code |
| School slug | School identifier used in composing the class QR Code |
All fields in the General tab are required. The Token, the URL, and the School slug are provided/defined during deployment by IONGRADE.
Screen buttons
| Button | Function |
|---|---|
| Back | Returns to the settings list |
| Save | Persists the configuration |
Fields added to entities
The plugin extends ACCELERO forms with sections specific to Accelero Edu.
Person
In the person record, the collapsible Accelero Edu section is added:
Person record with the Accelero Edu section expanded, showing the Password for Accelero Edu field.
| Field | Description |
|---|---|
| Password for Accelero Edu | Password used by the person (teacher) to authenticate in the application. It is stored encrypted |
The teacher authenticates in the app by entering the document (CPF) registered in their person record and the Password for Accelero Edu. People without this password defined cannot log into the application.
Category (Class)
In the person category editing, the collapsible Accelero Edu section is added:
Person category editing with the Accelero Edu section expanded, showing the Is it a class? selector and the QR Code area with the Print QRCode button.
| Field | Description |
|---|---|
| Is it a class? | When enabled, marks the category as an Accelero Edu class. Only categories marked as a class appear in the application |
| QR Code | Class QR Code image, automatically generated from the app URL, the school slug, and the class |
| Print QRCode | Button that allows printing the class QR Code |
Only enabled categories marked as a class are listed for the application. Disable the category or uncheck "Is it a class?" to remove it from the app.
Attendance Report
The plugin adds the Attendance Report, which gathers the attendance recorded by the application.
Navigation path: Reports > Attendance Report
Initial screen of the Attendance Report, showing the filters (From, To, Classes, Student name, Student ID, Teacher name) and the generation, template creation, and history buttons.
Available filters
| Filter | Description |
|---|---|
| From | Attendance start date |
| To | Attendance end date |
| Classes | Selection of one or more classes |
| Student name | Filters by student name |
| Student ID | Filters by student code (RA) |
| Teacher name | Filters by the name of the teacher responsible for the attendance |
Report content
The report lists the recorded presences, with the columns:
| Column | Content |
|---|---|
| Student name | Student name |
| RA | Student code (RA) |
| Class | Class description |
| Attendance Date and Time | Moment the attendance was recorded |
| Teacher | Name of the teacher who took the attendance |
| Present | Indicates whether the student was marked as present (Yes/No) |
The screen also provides the Templates (saved filter templates) and History (previously generated reports) tabs, in addition to the button to generate the report asynchronously.
Access to the Attendance Report is controlled by the Attendance report permission, created upon plugin installation. Make sure the operator's profile has this permission.
How the application communicates with ACCELERO
The app usage flow follows these steps:
- Authentication — the teacher enters the document (CPF) and the Password for Accelero Edu; ACCELERO validates the credentials and returns the teacher's data.
- Class listing — the app obtains the classes (categories enabled and marked as a class).
- Student listing — when opening a class, the app receives the students linked to the category, with name, RA, and photo.
- Attendance recording — when finishing, the app sends the list with the presence of each student; ACCELERO records the attendance and the individual presence.
Each class's QR Code points to the application's address, already identifying the school (slug) and the class. It facilitates access to the correct class from the app.
Diagram of the flow between the Accelero Edu application and ACCELERO: teacher authentication, class listing, student listing, and attendance submission.
Use cases
Enabling a class in the application
- Request IONGRADE to install the
acceleroeduplugin. - In
Settings > Integrations - AcceleroEdu, fill in Operator, Token, acceleroEdu URL, and School slug. - Edit the category that represents the class and enable Is it a class? in the Accelero Edu section.
- Make sure the students are linked to this category.
- Use the class QR Code (the Print QRCode button) for quick access from the app.
Enabling a teacher in the application
- Edit the record of the person who will be the teacher.
- Confirm that the document (CPF) is registered.
- In the Accelero Edu section, set the Password for Accelero Edu.
- Provide the teacher with the credentials (CPF and password) to log into the application.
Checking the recorded attendance
- Go to
Reports > Attendance Report. - Enter the period in From and To and, if necessary, filter by Classes, student, or teacher.
- Generate the report and track the result in the History tab.
Best practices
- Categories dedicated to classes: use specific categories to represent classes, avoiding marking generic categories as "Is it a class?".
- Teacher's CPF registered: authentication in the app uses the document (CPF); teachers without a registered CPF cannot log in.
- Individual passwords: set a Password for Accelero Edu per teacher, instead of sharing credentials.
- Report permission: grant the Attendance report permission only to the profiles that need to check attendance.
Troubleshooting
The class does not appear in the application
Possible causes:
- The category is not marked with Is it a class?.
- The category is disabled.
Solution:
- Edit the category and confirm that Is it a class? is active.
- Check whether the category is enabled.
The teacher cannot authenticate
Possible causes:
- The person does not have a document (CPF) registered.
- The Password for Accelero Edu was not defined or is incorrect.
Solution:
- Confirm the CPF in the person record.
- Reset the Password for Accelero Edu in the Accelero Edu section of the record.
The QR Code does not redirect correctly
Possible causes:
- The acceleroEdu URL or School slug fields are not filled in correctly in the configuration.
Solution:
- In
Settings > Integrations - AcceleroEdu, review the acceleroEdu URL and School slug fields. - Save and regenerate/reprint the class QR Code.
Integration with other modules
Categories
Accelero Edu classes are person Categories marked as a class. Enabling and linking students is done in the category record.
People
Students and teachers are ACCELERO People. The teacher uses the document (CPF) and the Accelero Edu password to authenticate; the students are the people linked to the class category.
Reports
The Attendance Report follows ACCELERO's Reports mechanism, with filters, templates, and generation history.
Next Steps
- Categories — Mark the category as a class and link the students
- People — Register the teacher's CPF and password
- Reports — Understand how reports work
- Plugins — Learn more about ACCELERO's plugin system