Zoom General (Cross-Product Skills)

Entry point for building with Zoom. This skill helps you choose the right SDK or API and provides cross-product guidance.

How zoom-general Routes a Complex Developer Query

Use zoom-general as the classifier and chaining layer:

1. detect product signals in the query
2. pick one primary skill
3. attach secondary skills for auth, events, or deployment edges
4. ask one short clarifier only when two routes match with similar confidence

Minimal implementation:

type SkillId =
  | 'zoom-general'
  | 'zoom-rest-api'
  | 'zoom-webhooks'
  | 'zoom-oauth'
  | 'scribe'
  | 'summarizer'
  | 'translator'
  | 'zoom-meeting-sdk-web-component-view'
  | 'zoom-video-sdk'
  | 'zoom-plugin-sdk'
  | 'zoom-mcp'
  | 'zoom-mcp/team-chat'
  | 'zoom-mcp/whiteboard'
  | 'zoom-mcp/meetings'
  | 'zoom-mcp/canvas'
  | 'zoom-mcp/tasks'
  | 'zoom-mcp/revenue-accelerator';

const hasAny = (q: string, words: string[]) => words.some((w) => q.includes(w));

function detectSignals(rawQuery: string) {
  const q = rawQuery.toLowerCase();
  return {
    meetingCustomUi: hasAny(q, ['zoom meeting', 'custom ui', 'component view', 'embed meeting']),
    customVideo: hasAny(q, ['video sdk', 'custom video session', 'peer-video-state-change']),
    pluginSdk: hasAny(q, ['plugin sdk', 'control zoom workplace', 'zoom workplace ipc', 'desktop companion']),
    marketplaceManifest: hasAny(q, ['marketplace manifest', 'create marketplace app', 'marketplace actions', 'marketplace triggers', 'features.connect', 'external mcp connector']),
    restApi: hasAny(q, ['rest api', '/v2/', 'create meeting', 'list users', 's2s oauth', 'marketplace manifest', 'create marketplace app', 'marketplace actions', 'marketplace triggers', 'features.connect', 'external mcp connector']),
    webhooks: hasAny(q, ['webhook', 'x-zm-signature', 'event subscription', 'crc']),
    oauth: hasAny(q, ['oauth', 'pkce', 'token refresh', 'account_credentials']),
    scribe: hasAny(q, ['scribe', 'transcribe file', 'transcribe recording', 'batch transcription']),
    summarizer: hasAny(q, ['summarizer', 'summarize transcript', 'meeting recap api', 'action items']),
    translator: hasAny(q, ['translator', 'translate text', 'batch translation', 'target_languages']),
    mcp: hasAny(q, ['zoom mcp', 'agentic retrieval', 'tools/list', 'semantic meeting search', 'search zoom', 'zoom docs search', 'zoom chat search']),
    teamChatMcp: hasAny(q, ['team chat mcp', 'zoom chat mcp', 'send zoom chat via mcp', 'zoom_chat_message_send']),
    whiteboardMcp: hasAny(q, ['whiteboard mcp', 'zoom whiteboard mcp']),
    meetingsMcp: hasAny(q, ['meetings mcp', 'meeting mcp server']),
    canvasMcp: hasAny(q, ['zoom canvas mcp', 'canvas mcp server', 'canvas file mcp', 'canvas block mcp']),
    docsMcp: hasAny(q, ['zoom docs mcp', 'docs mcp server', 'create_file_with_content']),
    tasksMcp: hasAny(q, ['zoom tasks mcp', 'tasks mcp server', 'create task mcp']),
    revenueMcp: hasAny(q, ['revenue accelerator mcp', 'zra mcp', 'conversation analysis mcp']),
  };
}

function pickPrimarySkill(s: ReturnType<typeof detectSignals>): SkillId {
  if (s.meetingCustomUi) return 'zoom-meeting-sdk-web-component-view';
  if (s.pluginSdk) return 'zoom-plugin-sdk';
  if (s.marketplaceManifest) return 'zoom-rest-api';
  if (s.teamChatMcp) return 'zoom-mcp/team-chat';
  if (s.whiteboardMcp) return 'zoom-mcp/whiteboard';
  if (s.meetingsMcp) return 'zoom-mcp/meetings';
  if (s.canvasMcp || s.docsMcp) return 'zoom-mcp/canvas';
  if (s.tasksMcp) return 'zoom-mcp/tasks';
  if (s.revenueMcp) return 'zoom-mcp/revenue-accelerator';
  if (s.mcp) return 'zoom-mcp';
  if (s.summarizer) return 'summarizer';
  if (s.translator) return 'translator';
  if (s.scribe) return 'scribe';
  if (s.restApi) return 'zoom-rest-api';
  if (s.customVideo) return 'zoom-video-sdk';
  return 'zoom-general';
}

function buildChain(primary: SkillId, s: ReturnType<typeof detectSignals>): SkillId[] {
  const chain = [primary];
  const needsMcpOAuth = s.mcp || s.teamChatMcp || s.whiteboardMcp || s.meetingsMcp ||
    s.canvasMcp || s.docsMcp || s.tasksMcp || s.revenueMcp;
  if ((s.oauth || s.pluginSdk || s.marketplaceManifest || needsMcpOAuth) && !chain.includes('zoom-oauth')) {
    chain.push('zoom-oauth');
  }
  if (s.webhooks && !chain.includes('zoom-webhooks')) chain.push('zoom-webhooks');
  return chain;
}

Example:

• Create a meeting, configure webhooks, and handle OAuth token refresh -> zoom-rest-api -> zoom-oauth -> zoom-webhooks
• Build a custom video UI for a Zoom meeting on web -> zoom-meeting-sdk-web-component-view
• Control the installed Zoom Workplace client from a Windows desktop app -> zoom-plugin-sdk -> zoom-plugin-sdk-windows -> zoom-oauth

For Plugin SDK chains, check Plugin SDK capabilities before implementation and read Plugin SDK FAQ when the prompt could also mean Meeting SDK for Windows or macOS.

For the full TypeScript implementation and handoff contract, use references/routing-implementation.md.

Choose Your Path

I want to...	Use this skill
Build a custom web UI around a real Zoom meeting	zoom-meeting-sdk-web-component-view
Build deterministic automation/configuration/reporting with explicit request control	zoom-rest-api
Create or update Marketplace apps, manifests, Connect routes, actions, or triggers	zoom-rest-api
Receive event notifications (HTTP push)	zoom-webhooks
Receive event notifications (WebSocket, low-latency)	zoom-websockets
Embed Zoom meetings in my app	zoom-meeting-sdk
Build custom video experiences (Web, React Native, Flutter, Android, iOS, macOS, Unity, Linux)	zoom-video-sdk
Control the installed Zoom Workplace client from a native macOS/Windows app	zoom-plugin-sdk
Build an app that runs inside Zoom client	zoom-apps-sdk
Transcribe uploaded or stored media with AI Services Scribe	scribe
Summarize transcript text with AI Services Summarizer	summarizer
Translate plain text or text files with AI Services Translator	translator
Access live audio/video/transcripts from meetings	zoom-rtms
Enable collaborative browsing for support	zoom-cobrowse-sdk
Build Contact Center apps and channel integrations	contact-center
Build Virtual Agent web/mobile chatbot experiences	virtual-agent
Build Zoom Phone integrations (Smart Embed, Phone API, webhooks, URI flows)	phone
Build Team Chat apps and integrations	zoom-team-chat
Build server-side integrations with Rivet (auth + webhooks + APIs)	rivet-sdk
Run browser/device/network preflight diagnostics before join	probe-sdk
Add pre-built UI components for Video SDK	zoom-ui-toolkit
Implement OAuth authentication (all grant types)	zoom-oauth
Build AI-driven tool workflows over Zoom meetings, Team Chat, Canvas, My Notes, and recordings	zoom-mcp
Search, send, edit, or administer Zoom Team Chat through MCP tools	zoom-mcp/team-chat
Build AI-driven Whiteboard workflows over Zoom Whiteboard MCP	zoom-mcp/whiteboard
Search meetings and retrieve assets or recording resources through dedicated MCP	zoom-mcp/meetings
Create or update Zoom Canvas files and blocks through dedicated MCP	zoom-mcp/canvas
Manage tasks, assignees, comments, and steps through MCP	zoom-mcp/tasks
Retrieve Revenue Accelerator conversations, transcripts, deals, and coaching data	zoom-mcp/revenue-accelerator
Build enterprise AI systems with stable API core + AI tool layer	zoom-rest-api + zoom-mcp

Planning Checkpoint: Rivet SDK (Optional)

When a user starts planning a server-side integration that combines auth + webhooks + API calls, ask this first:

• Rivet SDK is a Node.js framework that bundles Zoom auth handling, webhook receivers, and typed API wrappers.
• Do you want to use Rivet SDK for faster scaffolding, or do you prefer a direct OAuth + REST implementation without Rivet?

Routing after answer:

• If user chooses Rivet: chain rivet-sdk + oauth + rest-api.
• If user declines Rivet: chain oauth + rest-api (+ webhooks or product skill as needed).

SDK vs REST Routing Matrix (Hard Stop)

User intent	Correct path	Do not route to
Embed Zoom meeting in app UI	zoom-meeting-sdk	REST-only join_url flow
Build custom web UI for a real Zoom meeting	zoom-meeting-sdk-web-component-view	zoom-video-sdk
Build custom video UI/session app	zoom-video-sdk	Meeting SDK or REST meeting links
Control installed Zoom Workplace from a native desktop companion	zoom-plugin-sdk	Meeting SDK embedding or Zoom Apps SDK
Get browser join links / manage meeting resources	zoom-rest-api	Meeting SDK join implementation

Routing guardrails:

• If user asks for SDK embed/join behavior, stay in SDK path.
• If the prompt says meeting plus custom UI/video/layout/embed, prefer zoom-meeting-sdk-web-component-view.
• Only use zoom-video-sdk when the user is building a custom session product rather than a Zoom meeting.
• Use zoom-plugin-sdk when the native app controls a separately installed Zoom Workplace client over IPC.
• For zoom-plugin-sdk routes, read Plugin SDK capabilities before claiming an operation is supported.
• If Plugin SDK and native Meeting SDK both match, read Plugin SDK FAQ and ask whether the app controls installed Zoom Workplace or embeds meeting functionality.
• Only use REST path for resource management, reporting, or link distribution unless user explicitly requests a mixed architecture.
• For executable classification/chaining logic and error handling, see references/routing-implementation.md.

API vs MCP Routing Matrix (Hard Stop)

User intent	Correct path	Why
Deterministic backend automation, account/user configuration, reporting, scheduled jobs	zoom-rest-api	Explicit request/response control and repeatable behavior
AI agent chooses tools dynamically, cross-platform AI tool interoperability	zoom-mcp	MCP is optimized for dynamic tool discovery and agentic workflows
Enterprise AI architecture (stable core + adaptive AI layer)	zoom-rest-api + zoom-mcp	APIs run core system actions; MCP exposes curated AI tools/context

Routing guardrails:

• Do not replace deterministic backend APIs with MCP-only routing.
• Route features.connect.mcp to zoom-rest-api, not zoom-mcp: Zoom is connecting to an external MCP server in that manifest mode.
• Do not force raw REST-first routing when the task is AI-agent tool orchestration.
• Prefer hybrid routing when the user needs both stable automation and AI-driven interactions.
• Zoom's current hosted MCP catalog uses Streamable HTTP; use this path when the target client/agent supports MCP transports (for example Claude, Cursor, VS Code).
• Do not design per-tenant custom MCP endpoint provisioning; Zoom MCP endpoints are shared at instance/cluster level.
• Source: https://developers.zoom.us/docs/mcp/apis-vs-mcp/

Ambiguity Resolution (Ask Before Routing)

When a prompt matches both API and MCP paths with similar confidence, ask one short clarifier before execution:

• Do you want deterministic REST API automation, AI-agent MCP tooling, or a hybrid of both?

Then route as:

• REST answer → zoom-rest-api
• MCP answer → zoom-mcp
• Hybrid answer → zoom-rest-api + zoom-mcp

MCP Availability and Topology Notes

• Zoom-hosted MCP currently exposes product-scoped servers for Meetings, Chat, Canvas, Tasks, Whiteboard, and Revenue Accelerator in addition to the unified Zoom MCP Server.
• Use zoom-mcp as the parent MCP entry point.
• Route product-specific requests to the matching child under zoom-mcp/.
• When a request is product-specific and MCP coverage exists, route to that MCP product surface first; otherwise use REST/SDK skills for deterministic implementation.

Webhooks vs WebSockets

Both receive event notifications, but differ in approach:

Aspect	webhooks	zoom-websockets
Connection	HTTP POST to your endpoint	Persistent WebSocket
Latency	Higher	Lower
Security	Requires public endpoint	No exposed endpoint
Setup	Simpler	More complex
Best for	Most use cases	Real-time, security-sensitive

Common Use Cases

Use Case	Description	Skills Needed
Meeting + Webhooks + OAuth Refresh	Create a meeting, process real-time updates, and refresh OAuth tokens safely in one design	zoom-rest-api + zoom-oauth + zoom-webhooks
Scribe Transcription Pipeline	Transcribe uploaded files or S3 archives with AI Services Scribe using fast mode or batch jobs	scribe + optional zoom-rest-api + optional zoom-webhooks
AI Services Text Intelligence	Chain Scribe, Summarizer, and Translator for transcript summary and localization workflows	scribe + summarizer + translator
APIs vs MCP Routing	Decide whether to route to deterministic Zoom APIs, AI-driven MCP, or a hybrid design	zoom-rest-api and/or zoom-mcp
Custom Meeting UI (Web)	Build a custom video UI for a real Zoom meeting in a web app using Meeting SDK Component View	zoom-meeting-sdk-web-component-view + zoom-oauth
Meeting Automation	Schedule, update, delete meetings programmatically	zoom-rest-api
Meeting Bots	Build bots that join meetings for AI/transcription/recording	meeting-sdk/linux + zoom-rest-api + optional zoom-webhooks
High-Volume Meeting Platform	Design distributed meeting creation and event processing with retries, queues, and reconciliation	zoom-rest-api + zoom-webhooks + zoom-oauth
Recording & Transcription	Download recordings, get transcripts	zoom-webhooks + zoom-rest-api
Recording Download Pipeline	Auto-download recordings to your own storage (S3, GCS, etc.)	zoom-webhooks + zoom-rest-api
Real-Time Media Streams	Access live audio, video, transcripts via WebSocket	zoom-rtms + zoom-webhooks
In-Meeting Apps	Build apps that run inside Zoom meetings	zoom-apps-sdk + zoom-oauth
React Native Meeting Embed	Embed meetings into iOS/Android React Native apps	zoom-meeting-sdk-react-native + zoom-oauth
Native Meeting SDK Multi-Platform Delivery	Align Android, iOS, macOS, and Unreal Meeting SDK implementations under one auth/version strategy	zoom-meeting-sdk + platform skills
Native Video SDK Multi-Platform Delivery	Align Android, iOS, macOS, and Unity Video SDK implementations under one auth/version strategy	zoom-video-sdk + platform skills
Native Zoom Workplace Companion	Build macOS/Windows companion apps that control installed Zoom Workplace through Plugin SDK IPC	zoom-plugin-sdk + zoom-oauth
Electron Meeting Embed	Embed meetings into desktop Electron apps	zoom-meeting-sdk-electron + zoom-oauth
Flutter Video Sessions	Build custom mobile video sessions in Flutter	zoom-video-sdk-flutter + zoom-oauth
React Native Video Sessions	Build custom mobile video sessions in React Native	zoom-video-sdk-react-native + zoom-oauth
Immersive Experiences	Custom video layouts with Layers API	zoom-apps-sdk
Collaborative Apps	Real-time shared state in meetings	zoom-apps-sdk
Forum Triage Skill Coverage	Cluster and label forum threads to improve skill coverage	zoom-general + product skills
Contact Center App Lifecycle and Context Switching	Build Contact Center apps that handle engagement events and multi-engagement state	contact-center + zoom-apps-sdk
Virtual Agent Campaign Web and Mobile Wrapper	Deliver one campaign-driven bot flow across web and native mobile wrappers	virtual-agent + contact-center
Virtual Agent Knowledge Base Sync Pipeline	Sync external knowledge content into Zoom Virtual Agent using web sync or custom API connectors	virtual-agent + zoom-rest-api + zoom-oauth
Zoom Phone Smart Embed CRM Integration	Build CRM dialer and call logging flows using Smart Embed plus Phone APIs	phone + zoom-oauth + zoom-webhooks
Rivet Event-Driven API Orchestrator	Build a Node.js backend that combines webhooks and API actions through Rivet module clients	rivet-sdk + zoom-oauth + zoom-rest-api
Probe SDK Preflight Readiness Gate	Add browser/device/network diagnostics and readiness policy before Meeting SDK or Video SDK joins	probe-sdk + zoom-meeting-sdk or zoom-video-sdk

Complete Use-Case Index