Zoom General
OpenAIOfficialCreated by ZoomDistributed by OpenAI
- Skill
- Tool integration
- Automation and integrations
- MIT
- Medium risk
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
Zoom General serves as a strategic starting point for developers and architects to navigate the Zoom ecosystem. It provides a structured workflow to classify integration requirements, identify the correct Zoom product surface (such as APIs, SDKs, or webhooks), and determine the necessary authentication model. By guiding users through a decision-making process, it ensures that developers select the right tool for their specific use case before routing to more specialized skills.
What it does
- Classifies integration jobs based on desired outcomes like embedding meetings or automating resources.
- Maps requirements to specific Zoom surfaces including REST APIs, WebSockets, and various SDKs.
- Provides guidance on selecting the correct authentication and scope model for an integration.
- Facilitates routing to specialized skills once the product context is established.
- Offers comparative context for tasks that span multiple Zoom product boundaries.
When to use it
- When you are in the early stages of planning a Zoom integration and need to choose the right app type.
- When you need to compare different Zoom surfaces to determine which fits your technical requirements.
- When a task involves multiple Zoom products and requires a high-level architectural approach.
- When you need to confirm the correct authentication flow for a specific integration scenario.
Advantages
- Prevents premature selection of tools by enforcing a structured classification process.
- Clarifies the distinction between user-level OAuth, account-level OAuth, and SDK signatures.
- Reduces complexity by routing users to narrow, specialized skills after initial planning.
- Provides a clear decision matrix for choosing between General Apps, Server-to-Server OAuth, and Webhook Only apps.
Usage examples
- “I want to build an app that automates meeting reports. Which Zoom app type should I use?”
- The agent will guide you to classify the job as backend automation, leading to the recommendation of Server-to-Server OAuth for its lack of user interaction requirements.
- “Should I use the Meeting SDK or the Video SDK for my project?”
- The agent will help you compare the two based on your specific embedding needs and surface requirements, ensuring you choose the correct SDK for your use case.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/openai/zoom-general/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip zoom-general.zip -d .agents/skills
Documentation by Zoom
Zoom General
Use this skill for cross-product platform context after the user’s goal is understood. For first-step routing, prefer start, plan-zoom-product, or plan-zoom-integration.
Workflow
Classify the job by outcome: embed meetings, custom video, automate resources, consume events, process media, use meeting intelligence, or publish a Marketplace app.
Choose the Zoom surface that owns the behavior: REST API, webhooks, WebSockets, Meeting SDK, Video SDK, Zoom Apps SDK, Phone, Contact Center, Virtual Agent, Scribe, Rivet, or Cobrowse.
Confirm auth and scope model before implementation; Zoom surfaces differ on user-level OAuth, account-level OAuth, and SDK signatures.
Route to the narrow skill once the surface is chosen rather than keeping broad guidance in context.
Use the preserved guide only when a task crosses product boundaries or needs detailed comparison tables.
References
Full preserved guide: references/full-guide.md
App types: references/app-types.md
Authentication: references/authentication.md
Scopes: references/scopes.md
Marketplace: references/marketplace.md
Query routing playbook: references/query-routing-playbook.md
Files
- ATTRIBUTION.mdAdded by AutoGineer866 B
- LICENSELicence file added by AutoGineer1.1 KiB
- RUNBOOK.md2.4 KiB
- SKILL.md1.4 KiB
- agents/openai.yaml133 B
- references/app-types.md2.6 KiB
- references/authentication.md2.0 KiB
- references/authorization-patterns.md21.2 KiB
- references/automatic-skill-chaining-rest-webhooks.md5.5 KiB
- references/community-repos.md9.1 KiB
- references/distributed-meeting-fallback-architecture.md14.0 KiB
- references/environment-variables.md3.0 KiB
- references/full-guide.md5.3 KiB
- references/interview-answer-routing.md796 B
- references/known-limitations.md2.5 KiB
- references/marketplace.md1.6 KiB
- references/meeting-webhooks-oauth-refresh-orchestration.md5.3 KiB
- references/query-routing-playbook.md2.7 KiB
- references/routing-implementation.md3.7 KiB
- references/scopes.md3.4 KiB
- references/sdk-logs-troubleshooting.md5.7 KiB
- references/sdk-upgrade-guide.md4.1 KiB
- references/sdk-upgrade-workflow.md3.5 KiB
- use-cases/ai-companion-integration.md9.8 KiB
- use-cases/ai-integration.md7.2 KiB
- use-cases/backend-automation-s2s-oauth.md4.9 KiB
- use-cases/collaborative-apps.md2.6 KiB
- use-cases/contact-center-app-lifecycle-and-context-switching.md1.2 KiB
- use-cases/contact-center-integration.md1.1 KiB
- use-cases/custom-meeting-ui-web.md2.8 KiB
- use-cases/custom-video.md5.6 KiB
- use-cases/customer-support-cobrowsing.md12.5 KiB
- use-cases/electron-meeting-embed.md1020 B
- use-cases/embed-meetings.md4.8 KiB
- use-cases/enterprise-app-deployment.md1.0 KiB
- use-cases/flutter-video-sessions.md910 B
- use-cases/form-completion-assistant.md15.3 KiB
- use-cases/hd-video-resolution.md8.8 KiB
- use-cases/high-volume-meeting-platform.md1.9 KiB
- use-cases/immersive-experiences.md2.9 KiB
- use-cases/in-meeting-apps.md7.4 KiB
- use-cases/marketplace-publishing.md9.2 KiB
- use-cases/meeting-automation.md6.1 KiB
- use-cases/meeting-bots.md10.6 KiB
- use-cases/meeting-details-with-events.md20.8 KiB
- use-cases/meeting-links-vs-embedding.md988 B
- use-cases/minutes-calculation.md22.5 KiB
- use-cases/native-meeting-sdk-multi-platform.md1.5 KiB
- use-cases/native-video-sdk-multi-platform.md1.2 KiB
- use-cases/prebuilt-video-ui.md12.4 KiB
- use-cases/probe-sdk-preflight-readiness-gate.md1.2 KiB
- use-cases/qss-monitoring.md2.7 KiB
- use-cases/raw-recording.md5.1 KiB
- use-cases/react-native-meeting-embed.md1.0 KiB
- use-cases/react-native-video-sessions.md953 B
- use-cases/real-time-media-streams.md5.4 KiB
- use-cases/recording-download-pipeline.md8.7 KiB
- use-cases/recording-transcription.md7.2 KiB
- use-cases/retrieve-meeting-and-subscribe-events.md32.9 KiB
- use-cases/rivet-event-driven-api-orchestrator.md1.3 KiB
- use-cases/saas-app-oauth-integration.md4.8 KiB
- use-cases/scribe-transcription-pipeline.md1.8 KiB
- use-cases/sdk-size-optimization.md5.0 KiB
- use-cases/sdk-wrappers-gui.md18.4 KiB
- use-cases/server-to-server-oauth-with-webhooks.md1.7 KiB
- use-cases/team-chat-llm-bot.md6.7 KiB
- use-cases/testing-development.md7.2 KiB
- use-cases/token-and-scope-troubleshooting.md2.4 KiB
- use-cases/transcription-bot-linux.md14.3 KiB
- use-cases/usage-reporting-analytics.md8.5 KiB
- use-cases/user-and-meeting-creation.md16.9 KiB
- use-cases/video-sdk-bring-your-own-storage.md6.9 KiB
- use-cases/virtual-agent-campaign-web-mobile-wrapper.md1.4 KiB
- use-cases/virtual-agent-knowledge-base-sync-pipeline.md1.1 KiB
- use-cases/web-sdk-embedding.md4.5 KiB
- use-cases/zoom-phone-smart-embed-crm.md876 B
use-cases/marketplace-publishing.md
Marketplace Publishing & ISV Guide
Build and publish apps on the Zoom App Marketplace for multiple customers.
Overview
This guide covers building multi-tenant applications for the Zoom Marketplace, handling multiple customer accounts, and the app review process.
Skills Needed
general - App configuration
zoom-rest-api - Multi-tenant API calls
webhooks - Per-customer event handling
App Types for Marketplace
| App Type | Visibility | Use Case |
|---|---|---|
| Account-level (Private) | Your org only | Internal tools |
| User-managed (Public) | Individual users | User-facing apps |
| Admin-managed (Public) | Org admins install | Enterprise tools |
For Marketplace publishing, you'll create Public apps.
Multi-Tenant Architecture
Database Schema
Store per-customer OAuth tokens and settings:
CREATE TABLE zoom_installations (
id SERIAL PRIMARY KEY,
account_id VARCHAR(255) UNIQUE NOT NULL,
access_token TEXT NOT NULL,
refresh_token TEXT NOT NULL,
token_expires_at TIMESTAMP NOT NULL,
installed_at TIMESTAMP DEFAULT NOW(),
settings JSONB DEFAULT '{}'
);
CREATE INDEX idx_zoom_account ON zoom_installations(account_id);OAuth Token Storage
// Store tokens after OAuth callback
async function handleOAuthCallback(code, state) {
// Exchange code for tokens
const tokens = await exchangeCodeForTokens(code);
// Get account info
const accountInfo = await getAccountInfo(tokens.access_token);
// Store or update installation
await db.query(`
INSERT INTO zoom_installations
(account_id, access_token, refresh_token, token_expires_at)
VALUES ($1, $2, $3, $4)
ON CONFLICT (account_id)
DO UPDATE SET
access_token = $2,
refresh_token = $3,
token_expires_at = $4
`, [
accountInfo.account_id,
tokens.access_token,
tokens.refresh_token,
new Date(Date.now() + tokens.expires_in * 1000)
]);
return accountInfo.account_id;
}Token Refresh
async function getValidToken(accountId) {
const installation = await db.query(
'SELECT * FROM zoom_installations WHERE account_id = $1',
[accountId]
);
if (!installation) {
throw new Error('Account not installed');
}
// Check if token needs refresh
if (new Date(installation.token_expires_at) < new Date()) {
const newTokens = await refreshTokens(installation.refresh_token);
await db.query(`
UPDATE zoom_installations
SET access_token = $1, refresh_token = $2, token_expires_at = $3
WHERE account_id = $4
`, [
newTokens.access_token,
newTokens.refresh_token,
new Date(Date.now() + newTokens.expires_in * 1000),
accountId
]);
return newTokens.access_token;
}
return installation.access_token;
}Webhook Handling for Multi-Tenant
Routing by Account
app.post('/webhook', async (req, res) => {
// Verify signature first
if (!verifyWebhookSignature(req)) {
return res.status(401).send('Invalid signature');
}
const { event, payload } = req.body;
const accountId = payload.account_id;
// Check if this account has installed our app
const installation = await getInstallation(accountId);
if (!installation) {
console.log(`Webhook for unknown account: ${accountId}`);
return res.status(200).send(); // Still return 200
}
// Process event for this customer
await processEventForCustomer(accountId, event, payload);
res.status(200).send();
});
async function processEventForCustomer(accountId, event, payload) {
switch (event) {
case 'meeting.started':
await handleMeetingStarted(accountId, payload);
break;
case 'recording.completed':
await handleRecordingCompleted(accountId, payload);
break;
}
}Deauthorization Handling
When a customer uninstalls your app:
app.post('/webhook', async (req, res) => {
const { event, payload } = req.body;
if (event === 'app_deauthorized') {
const accountId = payload.account_id;
// Clean up customer data
await db.query('DELETE FROM zoom_installations WHERE account_id = $1', [accountId]);
// Optional: Delete customer data per compliance requirements
await cleanupCustomerData(accountId);
console.log(`App deauthorized for account: ${accountId}`);
}
res.status(200).send();
});API Calls for Specific Customers
class ZoomAPIClient {
constructor(accountId) {
this.accountId = accountId;
}
async request(method, endpoint, data = null) {
const token = await getValidToken(this.accountId);
const response = await axios({
method,
url: `https://api.zoom.us/v2${endpoint}`,
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
},
data
});
return response.data;
}
async createMeeting(userId, meetingData) {
return this.request('POST', `/users/${userId}/meetings`, meetingData);
}
async getUsers() {
return this.request('GET', '/users');
}
}
// Usage
const client = new ZoomAPIClient('customer_account_id');
const meeting = await client.createMeeting('me', { topic: 'Team Sync' });Scopes for Marketplace Apps
Request minimal scopes needed:
// Good - specific scopes
const scopes = [
'meeting:read',
'meeting:write',
'user:read'
];
// Bad - overly broad
const scopes = [
'account:read:admin',
'account:write:admin'
];Scope Descriptions
Provide clear descriptions for each scope in Marketplace:
| Scope | User-Facing Description |
|---|---|
meeting:read | View your meetings |
meeting:write | Create and update meetings on your behalf |
recording:read | Access your meeting recordings |
App Review Process
Pre-Submission Checklist
[ ] All required scopes have descriptions
[ ] Privacy policy URL is valid and accessible
[ ] Terms of service URL is valid
[ ] Support email/URL is configured
[ ] App description is clear and accurate
[ ] Screenshots show actual app functionality
[ ] Deauthorization webhook handles cleanup
[ ] OAuth flow completes successfully
[ ] Error handling is user-friendly
Common Rejection Reasons
Excessive scopes - Only request what you need
Missing deauthorization handling - Must handle
app_deauthorizedBroken OAuth flow - Test thoroughly
Poor error messages - Be user-friendly
Privacy policy issues - Must cover Zoom data usage
Non-functional features - All advertised features must work
Testing Before Submission
// Test OAuth flow
async function testOAuthFlow() {
// 1. Generate auth URL
const authUrl = generateAuthUrl();
console.log('Auth URL:', authUrl);
// 2. Complete OAuth manually in browser
// 3. Verify token storage
// 4. Test API calls
const client = new ZoomAPIClient(testAccountId);
const users = await client.getUsers();
console.log('Users:', users);
// 5. Test webhook handling
await simulateWebhook('meeting.started', testPayload);
}
// Test deauthorization
async function testDeauthorization() {
// Simulate deauth webhook
await simulateWebhook('app_deauthorized', {
account_id: testAccountId
});
// Verify cleanup
const installation = await getInstallation(testAccountId);
console.assert(installation === null, 'Installation should be deleted');
}Data Residency & Compliance
Handle Regional Requirements
// Determine storage region based on user location
async function getStorageRegion(accountId) {
const accountInfo = await zoomClient.getAccountInfo(accountId);
// Map Zoom data center to storage region
const regionMap = {
'US': 'us-east-1',
'EU': 'eu-west-1',
'AU': 'ap-southeast-2',
'IN': 'ap-south-1'
};
return regionMap[accountInfo.data_residency_region] || 'us-east-1';
}
// Store data in correct region
async function storeData(accountId, data) {
const region = await getStorageRegion(accountId);
const regionalStorage = getStorageClient(region);
await regionalStorage.put(data);
}Rate Limiting for Multi-Tenant
Implement per-customer rate limiting:
const rateLimit = require('express-rate-limit');
const RedisStore = require('rate-limit-redis');
const apiLimiter = rateLimit({
store: new RedisStore({
client: redisClient,
prefix: 'rl:'
}),
windowMs: 60 * 1000, // 1 minute
max: 100, // 100 requests per minute per customer
keyGenerator: (req) => {
// Rate limit per customer account
return req.headers['x-account-id'] || req.ip;
}
});
app.use('/api/', apiLimiter);Publishing Steps
Development - Build and test thoroughly
Submit for Review - In Marketplace portal
Review Period - 2-4 weeks typically
Address Feedback - Fix any issues found
Approval - App goes live
Maintenance - Monitor, update, support
Resources
Marketplace Portal: https://marketplace.zoom.us/
Publishing Guide: https://developers.zoom.us/docs/zoom-apps/publishing/
App Review: https://developers.zoom.us/docs/distribute/app-review/
ISV Program: https://zoom.us/partners/isv
Requirements and compatibility
Written for: OpenAI Codex
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
What our scanner noticed· Medium risk
- Possible data-exfiltration endpoints
- Instructions that use the network
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Zoom
- Publisher
- OpenAI (Official)
- Distributed by
- OpenAI
- Source
- openai/plugins · plugins/zoom/skills/general · commit d420d13
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from plugins/zoom/LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Zoom or OpenAI.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download zoom-general.zip