Browse guidesZoom

Show the live viewer count

Turn on Zoom event subscriptions so Home shows how many people are in the room during a live.

8 min read Updated 18 Sept 2026 For admins
On this page5 sections
  1. 01Before you start
  2. 02Set up the event subscription
  3. 03What you see during a live
  4. 04Zoom checks the endpoint every 72 hours
  5. 05What the validation messages mean

During a live, Home can show how many people are in the Zoom room right now. Zoom sends Bottega a message each time someone joins or leaves, using a feature called event subscriptions. It's optional. Attendance after the live comes from Zoom's report either way.

  • Zoom is connected to Bottega. See Connect Zoom.
  • Your Zoom app has the scope meeting:read:participant:admin. For Zoom Webinars it also needs webinar:read:participant:admin.
  • Each live has its Zoom link on the webinar's Setup tab. Bottega only counts people in meetings it knows about.
ZoomApp MarketplaceYour Bottega appFeature
  1. Turn on Event Subscriptions

    On your app's Feature page, switch on Event Subscriptions and add a new subscription. Name it “Bottega”.

  2. Copy the Secret Token

    The same page shows a Secret Token. Copy it. Bottega uses it to prove that each message really comes from Zoom.

  3. Save the token in Bottega

    In Settings › Zoom, paste the token into Webhook secret token and press Save & test. Do this before you validate in Zoom, or Zoom's check reaches Bottega before it has the token and fails.

  4. Copy the endpoint URL

    Further down Settings › Zoom, the Set up the Zoom app card shows your endpoint URL in step 4, with a Copy button. The URL is unique to your space, so don't reuse one from another space.

  5. Paste it into Zoom

    Back on the Feature page, paste the URL into Event Notification Endpoint URL.

  6. Press Validate

    Press Validate, under the URL field. Zoom sends a test message, and Bottega answers it using the Secret Token.

  7. Choose the events

    Under Meeting, add Participant or Host joined meeting and Participant/Host left meeting. If you host Zoom Webinars, also add Participant/Host joined webinar and Participant/Host left webinar under Webinar.

    These are the names in Zoom's documentation. If the wording on your screen differs slightly, choose the joined and left events for participants.

  8. Save the subscription in Zoom

  9. Check the result in Bottega

    Reload Settings › Zoom. Under the token field it now says “Zoom validated the endpoint. The live viewer count is on.”, with the time of the last check.

BottegaHome

From the live's start time to its planned end, Home shows In the room now with the number of people in the meeting and the show-up rate against registrations. The number appears when the first person joins. Until then, Home shows the live as on air, for example “Night 1 on air”.

Bottega counts joins and leaves only for a meeting ID saved on one of your lives, from one hour before its start to four hours after its planned end. It ignores everything else.

Zoom validates the endpoint again every 72 hours. Bottega answers automatically, and the line under Webhook secret token shows when the last check happened. After six failed checks in a row, Zoom disables the subscription and the live count stops.

Checks usually fail because the token in Bottega no longer matches Zoom's, for example after someone pasted a different token or disconnected Zoom in Bottega, which deletes the token. To fix it, paste the current Secret Token and save. Then open the subscription in Zoom, check it's switched on, and press Validate again.

What you seeWhyWhat to do
Zoom validated the endpoint. The live viewer count is on.Zoom's check reached Bottega and the token matched.Nothing.
Zoom's check reached Bottega, but the token saved here doesn't match.The token in Bottega isn't the Secret Token for this subscription.Copy the Secret Token from the Feature page again, paste it, save, then press Validate in Zoom.
Zoom's check reached Bottega before a Secret Token was saved here.Validate was pressed before the token was saved in Bottega.Paste the Secret Token, save, then press Validate in Zoom.
Zoom's check arrived with an out-of-date timestamp.The check's time stamp was more than five minutes out. This is a clock problem, not a wrong token.Press Validate in Zoom again.
No message under the token fieldZoom's check hasn't reached Bottega, or you saved a new token since the last check.Make sure the endpoint URL in Zoom is exactly the one in Settings › Zoom, then press Validate again.

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