Atlas / tournament documentation
Zoom breakout rooms
How a league turns on Zoom breakout rooms for its online rounds, what its Zoom admin sets up once, and how a director puts a round's rooms on a Zoom meeting so every team and judge lands in their own room.
An online round can run in one Zoom meeting with a breakout room for each pairing. Atlas works out who belongs in which room: both teams, a partner whose email is on file, and every judge seated on the panel. Zoom then pre-assigns each person by email, so a competitor or judge who joins signed in to Zoom with that email goes straight to their room.
The feature is off for every league until a league admin turns it on. It applies only to tournaments set to meet online. In-person tournaments do not change.
Who can use it
| Role | What the role can do |
|---|---|
| League owner or admin | Turns Zoom breakout rooms on or off for the league, connects the league's Zoom, and uses every round's Zoom page. |
| Meridian head admin | The same, for any league. |
| Tournament director or tab staff | Opens a round's Zoom page, downloads its CSV and, when Zoom is connected, sends the rooms to Zoom or turns on Automatic Zoom for the tournament. |
| Competitor or judge | Cannot open the Zoom page. Once the round has a meeting, they see its join link on their round page. |
Turning it on for a league
- Sign in as a league owner or admin.
- In the league console, select Zoom in the side menu, under Settings.
- Select Turn on. The page then reads On for this league.
Turn off hides every round's Zoom page and its link again. Nothing already scheduled in Zoom is changed.
Setup flags a league whose breakout rooms are on but whose Zoom keys are not entered yet. On an online tournament, Setup's Tournament section says so, and Setup's Rooms, under Online meetings, says so and, for an owner or admin of the league, opens the form for the keys, the way Registration flags a league that has not connected its payments.
What your Zoom admin sets up once
Pre-assigned breakout rooms need a paid Zoom account, such as Pro or Business, and two settings turned on by the account's Zoom admin. Without them Zoom accepts the meeting but quietly drops the rooms. Atlas checks Zoom's answer and says so when that happens.
- In the Zoom web portal, open Account Management, then Account Settings, then the Meeting tab.
- Turn on Breakout room.
- Tick Allow host to assign participants to breakout rooms when scheduling, and save.
- If the settings are locked at a group level, turn them on for the group the host belongs to as well.
Connecting your Zoom to Atlas
This step is optional. It lets Atlas schedule the meeting and place the rooms for you, on your league's own Zoom account. Your Zoom admin creates a private app that only your account can use:
- Go to the Zoom App Marketplace, choose Develop, then Build App, and pick Server-to-Server OAuth.
- Name it Atlas. On the Scopes tab, select Add Scopes and add the meeting scopes to read, write and update meetings:
meeting:read:meeting:admin,meeting:write:meeting:adminandmeeting:update:meeting:admin. Adduser:read:token:adminas well, which lets the rounds host start each round's meeting inside Atlas. Optionally addmeeting:delete:meeting:admin, so Atlas can delete a meeting when its round is withdrawn; without it Atlas renames that meeting Cancelled instead. - Activate the app on the Activation tab. Zoom will not activate an app that has no scopes yet, and says a scope is missing. Once the app is active, Zoom shows its Account ID, Client ID and Client Secret.
- Choose the licensed Zoom user who will host the rounds. Atlas schedules every meeting under that user.
Then a league owner or admin pastes the four values into Atlas. The keys are the league's: saved once, every online tournament of the league uses them. The same form is in three places, which all save the same keys: the league console's Zoom, the league console's Connectivity, under Connected accounts, and any online tournament's Setup, Rooms, under Online meetings.
- In the league console, select Zoom in the side menu, or open Setup, Rooms on one of the league's online tournaments.
- Under Your Zoom account, paste the Account ID, Client ID and Client Secret, and type the rounds host's email.
- Select Connect Zoom. Atlas signs in to Zoom with the keys and checks the app's scopes before it saves anything. When Zoom accepts the keys but the app lacks a scope, the page says Zoom accepted these keys, then lists each missing scope; add them on the app's Scopes tab, paste the Client Secret again and select Connect Zoom.
The page then reads Connected, with the last four characters of each ID and the host's email. The Client Secret is stored encrypted for your league only and is never shown on any screen again. Paste the values straight from Zoom into the page; never send them in an email or chat, including to Meridian.
Replace keys saves a new set over the old one, for example after a new host takes over. Disconnect Zoom removes them; meetings already scheduled stay in Zoom, and rounds go back to the CSV.
Running a round in Zoom
Prepare and release the round's pairings as usual in Rounds and pairing. On an online tournament in a league that has the feature on, a Zoom line sits above Rounds' release bar. With Zoom connected, select Send to Zoom there: Atlas schedules the round's meeting at its start time with every room pre-assigned, and the line shows the join link. Select Send rooms to Zoom again after a pairing changes.
The round's Zoom page, opened from Rooms on that line or from the round's postings sheet in Printing, lists every room and its people, and is where to send the rooms to a meeting already scheduled or to download the CSV.
The Zoom page lists every room and the people pre-assigned to it. A room keeps the name set in Rounds, such as Courtroom 3. A pairing with no room name, or with a meeting link in place of one, becomes Room 1, Room 2 and so on.
With Zoom connected:
- On the round's Zoom page, leave the meeting box empty to schedule a new meeting at the round's start time, or paste the link or ID of a meeting already scheduled under the host.
- Select Send to Zoom.
- The round's debaters and judges now see the join link on their round pages. You can also copy it and share it.
Without Zoom connected:
- Select Download the Zoom CSV.
- In Zoom on the web, schedule or edit the round's meeting.
- Under Breakout Room, choose Breakout Room pre-assign, then Import from CSV, upload the file and save.
A meeting Atlas schedules keeps your Zoom account's own waiting room setting. If your league keeps waiting rooms on for youth events, they stay on, and the host admits people from the waiting room before opening the rooms.
In either case the host starts the meeting from the Zoom desktop app, opens Breakout Rooms and selects Open All Rooms. Pairings changed after the rooms were sent need sending again, unless Automatic Zoom is on.
Running Zoom by hand, without the automation
Nothing on this page needs the league's Zoom keys except Send to Zoom and Automatic Zoom. A tournament admin can run every online round by hand in one of two ways.
One meeting per room, no breakout rooms. This needs nothing turned on. In Setup, Rooms, paste one meeting link per room, such as a Zoom or Google Meet link. Atlas hands a room to each pairing, and once the round is released its debaters and judges see their room's link on their round page. See Rooms.
One meeting per round, with a breakout room per pairing, from a CSV file. This needs Zoom breakout rooms turned on for the league and the Zoom account settings above, but no keys. For each round:
- Prepare and release the round's pairings in Rounds.
- Open the round's Zoom page: on Rounds, select Rooms and CSV on the Zoom line above the release bar, or open the round's postings sheet from Printing and select Zoom breakout rooms.
- Check the rooms and the warnings, then select Download the Zoom CSV.
- In Zoom on the web, signed in as the host, schedule the round's meeting, or edit one already scheduled.
- Under Breakout Room, choose Breakout Room pre-assign, then Import from CSV, upload the file and save.
- Share the meeting's join link with the round's debaters and judges, for example on Announce, Board, or by email.
- At the round's start, start the meeting from the Zoom desktop app, open Breakout Rooms and select Open All Rooms.
If the pairings change after the import, download the CSV again and import it again before the meeting starts. Zoom takes no room changes once a meeting has started, so after that the host moves people from the Breakout Rooms panel.
Automatic Zoom
With the league's Zoom connected, a tournament can leave the scheduling to Atlas. Open Setup, Rooms, and under Online meetings turn on Automatic Zoom. It saves at once.
- When a round's pairings are released, Atlas schedules the round's meeting on the league's Zoom within a minute, under the rounds host, with every team and judge pre-assigned to their room.
- The meeting is scheduled to open Setup's Zoom opens minutes before the round, 10 unless changed, and the round pages tell debaters and judges to join from then.
- The round's debaters and judges see the meeting's join link on their round pages. A pairing whose room is already a meeting link keeps its own link.
- If the pairings change before the meeting starts, Atlas sends the new rooms within a minute.
- If the round is moved to a new time, Atlas moves the meeting to match within a minute.
- If the pairings are taken back, or the tournament is cancelled or deleted, Atlas deletes the meeting from Zoom, or renames it Cancelled when the app lacks the delete scope. A meeting that has already started is left to the host.
- Each round gets its own meeting, because Zoom loads the rooms only when a meeting starts.
Each round's Zoom line on Rounds says where its meeting stands and anything that went wrong, such as Zoom dropping the rooms. Send rooms to Zoom again sends a round's rooms at once.
Two steps stay with the host, because Zoom gives Atlas no way to do them: start each round's meeting from the Zoom desktop app, signed in as the rounds host, then select Breakout Rooms and Open All Rooms. Once a meeting has started, Zoom takes no room changes, so the host moves anyone whose room changed after that.
Turn off stops Atlas changing the meetings. Meetings already scheduled stay on Zoom, and their links stay on the round pages.
Recording, registered people only, and backup hosts
Three choices for the rounds' meetings sit on the league's Zoom page, under The rounds' meetings. A league owner or admin sets them for every tournament of the league, and a tournament can choose otherwise for itself in Setup, Rooms, under Recording and who gets in. Changes reach meetings already scheduled within a minute, until they start.
- Record rounds to the cloud. Off by default, so no round is recorded unless someone chose it. On, each round's meeting records to the league's Zoom cloud, and once Zoom has finished the recording, the tournament's staff get a Recording link on the round's Zoom line in Rounds. It needs cloud recording on the league's Zoom plan and the app scope
cloud_recording:read:list_recording_files:admin. - Registered people only. Atlas registers each round's debaters and judges for its meeting, and each person's room page shows their own join link. Zoom sends no emails of its own. Anyone else who has the meeting's link must give Zoom a name and email before joining, so nobody joins unnamed, though it does not keep them out. Turn on the waiting room in the league's Zoom settings to admit people by hand as well. A round needs a start time for this. It needs the app scope
meeting:write:registrant:admin. If Zoom will not register an address, the round's Zoom line says so. - Backup hosts. People who may start a round's meeting when the rounds host cannot, one email per line, at most 10. Each must be a licensed user on the league's own Zoom account. If Zoom refuses one, the meeting goes ahead without backup hosts and the round's Zoom line says why.
Once Zoom sends its meeting events to Atlas for the attendance log, each round's Zoom line in Rounds also says whether the meeting is live, how many people are in it, and when it ended.
Joining inside Atlas
By default, Join opens the round's meeting in the Zoom app, and people signed in to Zoom with their registered email land in their room by themselves. A tournament can instead play the meeting on the room page, next to the pairing, the ballot and the room's chat and evidence. Atlas then puts each person in their own breakout room, and nobody needs a Zoom account.
Inside Atlas needs a second Zoom app, with the Meeting SDK turned on, in the same Zoom account as the league's keys. A league owner or admin adds it once:
- In the Zoom App Marketplace, build a second app in the same Zoom account as the league's keys, with the Meeting SDK turned on.
- In the league console, select Zoom. Under Zoom inside Atlas, paste the Meeting SDK Client ID and Meeting SDK Client Secret, and select Save Meeting SDK keys.
- The page then reads Meeting SDK app connected, with the end of the client ID. Replace Meeting SDK keys and Remove Meeting SDK keys change it later.
Then a tournament admin chooses it per tournament. Open Setup, Rooms, and under Online meetings, Where people join, select Inside Atlas. The choice saves at once, and In the Zoom app turns it back. Inside Atlas cannot be chosen until the league's Meeting SDK app is entered.
| Who | What they see |
|---|---|
| Debater or judge | A Meeting panel on the room page and the judge's ballot, with Join here and Open in Zoom app. After joining, the panel says which room they go to once the host opens the rooms, or that they are in the main room and the host moves them. Leave ends it. On a phone the Zoom app is usually smoother, and the panel says so. |
| Tournament admin on Rounds | Host in Atlas on the round's Zoom line, once the round's meeting is scheduled and the round is not closed. It opens a Round meeting panel with Host here. Only a league owner or admin hosts as the rounds host; anyone else joins as a participant and asks the host to make them co-host. |
| Host | Opens the breakout rooms from Zoom's toolbar. Atlas keeps putting each newcomer in the main room into the room their name carries. |
Atlas places guests by the name they join with. If Zoom will not move someone, the panel says so and the host moves them from the Breakout Rooms panel. If the meeting cannot open on the page, the panel says to use the Zoom app instead.
Attendance
Atlas can keep a log of who joined each round's meeting and when. Zoom sends Atlas each join and leave as it happens, and the round's Zoom page shows, room by room, when each debater and judge first joined, how many minutes after the meeting started, and when they left. Anyone not in the meeting 10 minutes after it started is listed at the top. A no-show complaint is settled from the join times, and a missing judge is seen while there is still time to send another.
People are recognised by the email they are signed in to Zoom with. Someone not signed in is recognised only when the name they type in Zoom is exactly their name in Atlas, and the page says matched by name. Anyone Atlas cannot match, such as staff, is listed under Also in the meeting.
Your Zoom admin turns it on once, in the same Server-to-Server app as the league's keys. On the league's Zoom page, under Attendance:
- In the Zoom App Marketplace, open Manage, then the league's Server-to-Server app, then Feature. Copy the Secret Token, paste it under Attendance and select Save Secret Token.
- Turn on Event Subscriptions and add a subscription. Paste the Event notification endpoint URL shown under Attendance, and press Validate.
- Add the events listed under Attendance: meeting started and ended, participant joined and left, and joined or left a breakout room. Add any scope Zoom asks for, and save.
After a meeting ends, Check against Zoom's record on the round's Zoom page reads Zoom's own list of who attended and adds anything the live log missed. It needs the meeting:read:list_past_participants:admin scope on the app.
When a round is marked completed, Atlas also ends its meeting if it is still running, so the rounds host is free for the next round. That needs the meeting:update:status:admin scope; without it the meeting stays open until the host ends it.
Limits and what the warnings mean
| Warning or limit | What it means |
|---|---|
| At most 100 rooms | Zoom pre-assigns at most 100 breakout rooms in one meeting. A larger round needs a second meeting. |
| At most 1,000 people | Zoom pre-assigns at most 1,000 people in one meeting. |
| No email on file | That team or judge cannot be pre-assigned. They join the main room and the host moves them. |
| Already in another room | Two entries share one email, often a parent's. Zoom places that email once, in the first room. |
| No chat messages | Zoom gives Atlas no way to post in a meeting's chat. Put announcements on Announce, Board, or send them by email, or the host posts them in the meeting. |
| Not released | The pairing is still a draft. It is included, so check before sharing the link. |
Someone who joins without signing in to Zoom, or signed in with another email, lands in the main room. The host moves them by hand from the Breakout Rooms panel.
To cut down on that, ask everyone to register with the email they sign in to Zoom with. A tournament's director can put that request on its registration form and judge sign-up, in Setup under Registration, Notes on the sign-up forms, and see a preview of the form there.