Browse guidesRegistrants

How Bottega matches Zoom attendance to registrants

The three ways attendance reaches Bottega, and exactly how each one decides which registrant showed up.

6 min read Updated 28 Sept 2026 For everyone
On this page6 sections
  1. 01The three ways attendance arrives
  2. 02How a Zoom participant becomes a registrant
  3. 03One person, matched three ways
  4. 04Which data wins
  5. 05Check how a date was matched
  6. 06Troubleshooting

Zoom knows who was in the room. Bottega knows who registered. Attendance is the step that pairs the two, and how well it works depends on how the data reaches Bottega.

RouteWhen it happensHow people are matchedLabel on the cohort page
Automatic syncWith Zoom connected and a meeting ID on the date. Bottega starts checking 30 minutes into the live and fetches the report as soon as Zoom publishes it, usually within minutes of the host ending the meeting, even when the live finishes before its planned end. It fetches it again 6 hours and 24 hours after the planned end, and stops after 3 days. Each date shows on its own as soon as its report is in, so Night 1 appears before Night 2 has run.Personal join link first, then email.Zoom API · synced
CSV importWhen an admin uploads the participant report exported from Zoom.Email only.CSV import
Live countDuring the live, from Zoom's join and leave notifications.Not matched. It counts everyone in the room.In the room now

Bottega goes through every row in Zoom's report and tries these in order.

With personal join links, each registrant gets their own Zoom link, and Zoom reports which link each person used. Bottega pairs that with the registrant directly, whatever name or email they typed into Zoom. This only works with automatic sync, and only for people who received a personal link for that date.

By registered email

Otherwise Bottega compares the email Zoom recorded with the emails registered for this run. Capital letters don't matter, but the address has to be the same. sarah@brightline.com and sarah.k@gmail.com don't match, and someone who joins from a phone without signing in to Zoom has no email to match.

Unmatched

Anyone left over is kept as an unmatched participant. They count towards peak viewers and the retention chart, and they are listed under Unmatched Zoom participants on the cohort page. They don't count towards show-up, because Bottega can't tell which registrant they are. You can't assign them to a registrant by hand.

Minutes are added up across rejoins, so someone who left for ten minutes and came back is credited with the time they were actually in. With automatic sync, overlapping rows for the same person (two devices at once) are merged so the time isn't counted twice. A CSV import adds the rows up as they are.

Sarah from Brightline registered as sarah@brightline.com. On the night she joins from her phone, where Zoom is signed in as sarah.k@gmail.com.

  • With personal join links and automatic sync, she clicked her own link, so she is matched and counted as attended.
  • With automatic sync but no personal links, Zoom only has sarah.k@gmail.com. She is unmatched, and her row shows Didn't join.
  • With a CSV import, the result is the same as without personal links, even if personal links were on, because Zoom's CSV doesn't say which link someone used.

In the last two cases, the cohort page lists her under Unmatched Zoom participants as Likely Sarah Tan (sarah@brightline.com), joined with a different email, because the name in Zoom matches exactly one registrant.

Each date holds one set of attendance. Whatever arrives last replaces what was there.

  • Importing a CSV replaces whatever the date had, including a Zoom API sync.
  • Automatic sync never overwrites a CSV import. To swap a CSV for Zoom's data, click the date's label on the cohort page and choose Sync now.
  • Removing a report deletes that date's attendance, and show-up goes back to a dash.
BottegaWebinarsAttendanceA run

Once a date has ended, a Data source row appears under the page title with one label per date. Click a label to see By personal link, By email and Unmatched counts, when the data arrived, and a Sync now button if you are an admin and Zoom is connected.

The label reads Waiting for Zoom report between the end of the live and the first successful sync. Zoom usually publishes the report within 30 minutes to a few hours.

What you seeWhyWhat to do
Few people matched, although personal links were onThe attendance came from a CSV, which can only match by email.Click the date's label and choose Sync now.
Waiting for Zoom report for hoursZoom hasn't published the participant report yet.Wait for the 6-hour check, or click Sync now. After 3 days Bottega stops trying, so import the CSV instead.
Zoom sync failed with Add the Zoom meeting ID to this night first.The date has no Zoom meeting ID.Add it on the run's Setup tab, then Sync now.
Zoom sync failed mentioning report:read:adminThe Zoom app can't read reports.Fix the Zoom app's scopes
You (the host) are listed as unmatchedZoom's meeting report includes the host.Nothing. It doesn't affect show-up.
A registrant says they came but shows Didn't joinThey joined with another email, or without signing in to Zoom.Look for them under Unmatched Zoom participants. Turn on personal join links for the next run.

Something here out of date? Tell us and we'll fix the guide.

Still stuck?

Ask a person, not a bot.

Tell us your space and the page you were on. A screenshot helps. Someone on the GOATEDX team reads every email and replies.

bottega@goatedx.com