Show the live viewer count
Turn on Zoom event subscriptions so Home shows how many people are in the room during a live.
On this page5 sections
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 needswebinar:read:participant:admin. - Each live has its Zoom link on the webinar's Setup tab. Bottega only counts people in meetings it knows about.
Turn on Event Subscriptions
On your app's Feature page, switch on Event Subscriptions and add a new subscription. Name it “Bottega”.
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.
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.
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.
Paste it into Zoom
Back on the Feature page, paste the URL into Event Notification Endpoint URL.
Press Validate
Press Validate, under the URL field. Zoom sends a test message, and Bottega answers it using the Secret Token.
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.
Save the subscription in Zoom
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.
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 see | Why | What 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 field | Zoom'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. |
Read next
Something here out of date? Tell us and we'll fix the guide.