Fix Zoom connection and attendance problems
Every message Bottega shows about Zoom, what causes it and how to fix it.
On this page8 sections
Find the message you see in the tables below. When Bottega passes on an error from Zoom, Zoom's own words follow “Zoom said”.
| What you see | Why | What to do |
|---|---|---|
| Paste the Account ID from the app's credentials | The Account ID is empty or too short. | Copy it from the App credentials page of your Zoom app. |
| Paste the Client ID | The Client ID is empty or too short. | Copy it from the same page. |
| Letters, numbers, - and _ only | Something other than the ID came along when you copied. | Copy the value again and paste only the value. |
| Add the Client secret. / Paste the Client secret | No Client secret is saved yet. | Paste the Client secret from App credentials. |
| That doesn't look like a Zoom client secret | The value is too short to be a Zoom client secret. | Copy it again. Usually only part of it was copied. |
| Couldn't save. Only admins can connect Zoom. | Your Bottega role can't change the Zoom settings. | Ask an admin of this space to connect Zoom. |
| Couldn't store the client secret. / Couldn't store the webhook secret token. | Bottega couldn't save the secret securely. | Try again. If it keeps happening, contact the GOATEDX team. |
| Save to test the new credentials. | You have unsaved changes, so Test connection is off. | Press Save & test. |
| Add all three credentials to test. | Account ID, Client ID or Client secret is missing. | Fill in all three and save. |
These appear in red under Test connection, and in the status box as “Zoom couldn't be reached with these credentials”. The badge changes to Needs attention.
| What you see | Why | What to do |
|---|---|---|
| The Zoom app is switched off. | The app was never activated, or someone deactivated it. | Open the Activation page of your Zoom app and activate it. If Zoom won't let you, fill in the developer contact on the Information page first. |
| This isn't a Server-to-Server OAuth app. | The credentials come from another type of Zoom app. | Create a Server-to-Server OAuth app as described in Connect Zoom, and use its credentials. |
| Zoom doesn't recognise the Account ID. | The Account ID is wrong. It's often a Zoom user ID pasted by mistake. | Copy the Account ID from the app's App credentials page. |
| Zoom doesn't accept this Client ID and Client secret together. | One of them is wrong, comes from another app, or the secret was replaced in Zoom. | Check the app is activated, then copy both again. If the secret changed, paste the new one. |
| Zoom rejected these credentials. | Zoom refused for another reason. | Read the text after “Zoom said”, fix what it names, then test again. |
| Couldn't reach Zoom. Try again. | Zoom didn't answer in time. | Test again in a few minutes. |
| Add the Account ID, Client ID and Client secret first. | One of the three isn't saved. | Fill in all three and press Save & test. |
| What you see | Why | What to do |
|---|---|---|
| Add the … scope in the Zoom app (apps made before 2024 use …), then test again. | The app doesn't have that scope. | Add the scope it names on your Zoom app's Scopes page, then test again. If Zoom won't let you add it, your Zoom role lacks permission for that scope, so ask an account admin. |
| Create personal join links, in grey, with “Only needed if you switch on personal join links.” | The optional write scope isn't on the app. | Ignore it unless you use personal join links. |
| No Zoom link yet for Night 1, Night 2 … | Those upcoming lives have no Zoom link in Bottega. | Add the link on the webinar's Setup tab. |
| “…” needs Registration: Required with Automatically approve for personal join links. | Personal join links are on, but the meeting doesn't require registration with automatic approval. | Change the meeting in Zoom as described in Prepare a Zoom meeting for Bottega. |
| This Zoom account has no meeting with that ID. The link belongs to another account, or the meeting was deleted. | The meeting isn't in the connected Zoom account. | Schedule the meeting in the connected account and update the link, or connect the Zoom account that hosts it. |
| Zoom said: … on a meeting line, mentioning scopes | The app can't read that meeting. | Add meeting:read:meeting:admin, or webinar:read:webinar:admin for a Zoom Webinar. |
| Zoom didn't answer. | Zoom didn't respond in time. | Test again. |
| Connected. Add user:read:user:admin to show the account email here. | The connection works. Bottega can't show the account email without that scope. | Nothing. The scope is only for showing the email. |
| What you see | Why | What to do |
|---|---|---|
| This link has no meeting ID. Add it for automatic attendance. | The link doesn't contain the meeting ID, as with some custom links. | Type the meeting ID from Zoom into the box. |
| A Zoom ID has 9 to 12 digits | The ID you typed isn't a Zoom meeting ID. | Copy the ID from the meeting in Zoom. Spaces and dashes are fine. |
| Attendance will come from … , not the room in the link. | The ID you typed differs from the one in the link. | Fine if that's intended. Otherwise press Use the link's ID. |
Each finished live has an attendance label on the webinar's Overview tab and on the run's cohort page. Click it for details and Sync now.
| What you see | Why | What to do |
|---|---|---|
| Waiting for Zoom report | Zoom hasn't published the participants report yet. Zoom says reports can take up to 30 minutes after a meeting ends, and sometimes they take longer. | Wait. Bottega checks every 10 minutes from 30 minutes into the live until the report comes in, then again 6 and 24 hours after the planned end. You can also press Sync now. |
| This night hasn't ended yet. | The live's planned end time hasn't passed. | Wait, or correct the start time and duration on the Setup tab. |
| Add the Zoom meeting ID to this night first. | The live has no Zoom link or ID. | Add it on the Setup tab. |
| Zoom isn't connected for this space. | Zoom isn't connected, or the last test failed. | Go to Settings › Zoom and press Test connection. |
| Attendance was imported from a CSV; sync manually to replace it. | Automatic syncs never overwrite a CSV import. | Press Sync now if you want Zoom's report instead of the CSV. |
| A Zoom error ending in “Check the app's scopes …” | Zoom refused the report. | Add report:read:list_meeting_participants:admin (report:read:admin on older apps). For Zoom Webinars, add report:read:list_webinar_participants:admin. |
| Couldn't reach Zoom. We'll try again shortly. / Couldn't save the attendance. We'll try again shortly. | A temporary problem. | Bottega tries again after about 25 minutes. You can also press Sync now. |
| That date is no longer part of this webinar. | The date was removed from the webinar. | Nothing. |
Still waiting after a day
Bottega looks for the meeting from three hours before the live's start to three hours after its planned end. If the meeting ran outside that window, was hosted in another Zoom account, or wasn't hosted by a paid user, there's no report to find. Check the date, time and link on the Setup tab, then press Sync now.
Automatic checks stop three days after a live. Sync now still works after that, and Zoom keeps reports for 15 months. You can also import the Participants CSV from Zoom instead.
| What you see | Why | What to do |
|---|---|---|
| Connect Zoom first, or registrants keep getting the shared link. | Personal join links are on, but Zoom isn't connected. | Connect Zoom in Settings › Zoom. |
| Turn on personal join links and add the Zoom ID for an upcoming night first. | No upcoming live has both a Zoom link and personal join links switched on and saved. | Add the link, switch on Personal join links, and save the Setup tab. |
| Connect Zoom in Settings first. | Zoom isn't connected, or the last test failed. | Press Test connection in Settings › Zoom. |
| A Zoom error under “… registrants have a personal link” | Zoom refused to register people. Usually the meeting doesn't require registration, or the app lacks the write scope. | Set up registration as in Prepare a Zoom meeting for Bottega, add meeting:write:registrant:admin, then press Create links for existing registrants again. |
| Zoom didn't return a join link. | Zoom accepted the registration but sent no link back. | Press Create links for existing registrants again. |
If Zoom refuses a registration, that person still gets the shared link, so nobody is left without a way in. Bottega also retries missing links for upcoming lives on a schedule.
If Home shows the live as on air (for example “Night 1 on air”) instead of In the room now, no join event has reached Bottega for this live. Check these in order.
- Settings › Zoom says “Zoom validated the endpoint. The live viewer count is on.” If it shows a different message, see the validation messages in the live viewer count guide.
- The subscription is still switched on in Zoom. Zoom disables it after six failed checks in a row.
- The joined and left events are added for the type you host. Meeting events don't cover Zoom Webinars.
- The app has meeting:read:participant:admin, or webinar:read:participant:admin for Zoom Webinars.
- The meeting people are in is the one linked on this live's Setup tab.
The full setup is in Show the live viewer count.
Without personal join links, Bottega matches people by the email Zoom saw when they joined. That's often different from the email they registered with, or empty for people joining by phone. Personal join links match people exactly. For past lives, unmatched people still count as viewers and are listed on the cohort page.
Read next
Something here out of date? Tell us and we'll fix the guide.