Or write to support@educaplay.com
How to integrate Educaplay into Microsoft Teams
We are committed to continuously improving your experience; some elements of the video interface may not match the current one.
What the integration does
Your students play Educaplay games inside their Microsoft Teams Class, without signing up, and their scores are automatically saved to the class gradebook.
Requirements
- An Academic plan or Commercial plan. With lower plans you can try the integration with up to 5 games.
- Microsoft Teams for Education, with a Class type team. It doesn't work with personal accounts, Teams Business or Enterprise, or with teams that aren't Classes.
- Your Microsoft 365 administrator has granted Educaplay the permissions (just once per organization).
How to know if you have Microsoft Teams for Education
Any of these signs confirms it:
- When you create a new team in Teams, the Class type appears among the options.
- Your classes have a side menu with Home, Class Notebook, Class Materials, Assignments, Grades, Insights and Reflect.
- Your account has a Microsoft 365 A1, A3 or A5 license (or Office 365 A1, A3 or A5). A1 is free for verified educational institutions.
If you're not sure, ask your institution's Microsoft 365 administrator.
Administrator permissions (just once)
The first time, the Microsoft 365 tenant administrator has to grant Educaplay permissions so it can create assignments in classes. It's an action done just once per organization and stays valid forever. Without these permissions, teachers and students will see the message "Needs admin approval".
- In Educaplay, open the Share game box of any game and, under Integrate it into your platform, click the M. Teams button.
- On the Share on Microsoft Teams screen, inside the Grant permissions box, click Grant.
- Sign in with the tenant administrator account (teacher or student accounts won't be able to continue).
- Review the permissions Educaplay requests and click Accept.
Posting a game to a class
Once the permissions are granted, any teacher of a Class can post a game from Educaplay.
- In Educaplay, open Share game for the game you want to post and click M. Teams.
- Below the Grant permissions box, click Share.
- Sign in with your Microsoft account (the first time, Microsoft will ask for your consent for Educaplay to access your classes and assignments; accept it).
- Tick the class or classes where you want to post the game (you can select several at once).
- In the Grade to save selector, choose First grade or Best grade.
- Click Share to post immediately, or Save draft to Microsoft Teams if you want to finish setting up the assignment in Teams (schedule the posting, due date, assignment to specific students…).
If you've created a new class in Teams and it doesn't appear in the list, click Refresh in the Refresh classes section: Educaplay queries the list from Microsoft again.
How the student sees it
The assignment appears both in the class's General channel (as a message from the Assignments bot) and in their personal Assignments section. Clicking View assignment opens the card with the link to the game; clicking it loads the game, automatically identifying the student with their name in Teams.
When the student finishes the game, Educaplay sends the score to Teams automatically and the assignment switches to Returned status without the student having to click Turn in.
Where the scores are shown
Inside the class in Teams, click Grades in the side menu. You'll see one column per assignment, one row per student and the grade in the corresponding cell. You can export the gradebook to Excel.
The games are also recorded in Educaplay's Reports section, where you can check scores, times and, with an Academic plan or Commercial, each player's specific answers too (including those to open questions).
Grading: First or Best
You decide it when you post the assignment from Educaplay. If you change it afterwards, it will only affect the new assignments you post, not the ones already in Teams.
- First grade (default): the score from the first attempt is saved, regardless of later ones.
- Best grade: the highest score across all attempts is saved.
Frequently asked questions
Does it work with any Microsoft Teams?
No. It requires Microsoft Teams for Education and is only posted inside a Class type team. Personal accounts, the Business or Enterprise versions (not Education) and teams that aren't Classes are not compatible.
How do I know if I have Teams for Education?
The most reliable signs are: that the Class type appears when you create a team, that your classes have a side menu with Class Notebook, Class Materials, Assignments, Grades, Insights and Reflect, or that your account has a Microsoft 365 A1, A3 or A5 license (or the equivalent Office 365). If in doubt, ask your institution's Microsoft 365 administrator.
Why does Microsoft tell me I need admin approval?
Because the permissions Educaplay needs to create assignments can only be granted by your organization's administrator. Ask them to go into Educaplay, open the Share game box of any game, click M. Teams → Grant and accept the permissions with their administrator account. After that, all the teachers and students in the organization will be able to use Educaplay with your classes.
Can I post the same game to several classes at once?
Yes. On the Share on Microsoft Teams screen you can tick as many classes as you want before clicking Share. Educaplay will create the same assignment in each one with a single click.
I've created a new class in Teams and it doesn't appear in the list, what do I do?
On the same Share on Microsoft Teams screen, below the buttons, there's a Refresh classes section with a Refresh button. Click it: Educaplay queries Microsoft again and the new class should appear.
How do I finish setting up the assignment (due date, scheduling, assignment)?
Click Save draft to Microsoft Teams instead of Share. The assignment is created as a draft in Teams and from there you can adjust the title, the instructions, schedule the posting date, set a due date and time or assign it to only some students before posting it.
Do my students need an Educaplay account?
No. When they enter the game from the Teams assignment they are automatically identified with the name they have in the class. The score is linked to their Teams user.
Does the student have to click Turn in for the grade to reach the gradebook?
No. When the student finishes the game, Educaplay sends the score to Teams automatically and the assignment switches to Returned status without the student having to turn it in manually.
Can I try the integration with a free account?
Yes. With any plan below Academic, your account can integrate up to 5 games into Microsoft Teams (or any other platform) so you can see how it works. After that you need the Academic plan or the Commercial plan.
