网有NETHAVE
AGENT SKILL

zoom-general

Cross-product Zoom reference skill. Use after the workflow is clear when you need shared platform guidance, app-model comparisons, authentication context, scopes, marketplace considerations, or API-vs-MCP routing.

适用职业开发工程师产品经理
使用场景后端与接口Skill与智能体开发
License 许可
Apache-2.0
最近更新
2026-11-13
Stars
★ 3.6w
Forks
3.9k

01 前言 Front Matter

name
zoom-general
triggers
[ "zoom integration", "getting started", "which zoom sdk", "zoom platform", "choose zoom api", "zoom scopes", "marketplace", "cross-product", "apis vs mcp", "api vs mcp" ]
description
Cross-product Zoom reference skill. Use after the workflow is clear when you need shared platform guidance, app-model comparisons, authentication context, scopes, marketplace considerations, or API-vs-MCP routing.
user-invocable
false

02 资源文件 72

03 SKILL.md 正文

Zoom General (Cross-Product Skills)

Background reference for cross-product Zoom questions. Prefer the workflow skills first, then use this file for shared platform guidance and routing detail.

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'
  | 'zoom-meeting-sdk-web-component-view'
  | 'zoom-video-sdk'
  | 'zoom-mcp';

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']),
    restApi: hasAny(q, ['rest api', '/v2/', 'create meeting', 'list users', 's2s oauth']),
    webhooks: hasAny(q, ['webhook', 'x-zm-signature', 'event subscription', 'crc']),
    oauth: hasAny(q, ['oauth', 'pkce', 'token refresh', 'account_credentials']),
    mcp: hasAny(q, ['zoom mcp', 'agentic retrieval', 'tools/list', 'semantic meeting search']),
  };
}

function pickPrimarySkill(s: ReturnType<typeof detectSignals>): SkillId {
  if (s.meetingCustomUi) return 'zoom-meeting-sdk-web-component-view';
  if (s.mcp) return 'zoom-mcp';
  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];
  if (s.oauth && !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

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
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
Build an app that runs inside Zoom client zoom-apps-sdk
Transcribe uploaded or stored media with AI Services Scribe scribe
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 (AI Companion/agents) over Zoom data zoom-mcp
Build AI-driven Whiteboard workflows over Zoom Whiteboard MCP zoom-mcp/whiteboard
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
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.
  • 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.
  • 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.
  • MCP remote server works over Streamable HTTP/SSE; use this path when the target client/agent supports MCP transports (for example Claude or 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/library/resources/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 access is evolving; docs indicate a model where Zoom exposes product-scoped MCP servers (for example Meetings, Team Chat, Whiteboard).
  • Use zoom-mcp as the parent MCP entry point.
  • Route Whiteboard-specific MCP requests to zoom-mcp/whiteboard.
  • 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
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
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
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

Prerequisites

  1. Zoom account (Pro, Business, or Enterprise)
  2. App created in Zoom App Marketplace
  3. OAuth credentials (Client ID and Secret)

References

Quick Start

  1. Go to marketplace.zoom.us
  2. Click Develop → Build App
  3. Select app type (see references/app-types.md)
  4. Configure OAuth and scopes
  5. Copy credentials to your application

Detailed References

SDK Maintenance

Resources

Environment Variables

Operations

  • RUNBOOK.md - 5-minute preflight and debugging checklist.

04 同仓库更多 Skills

anthropics
anthropics/knowledge-work-plugins

ticket-deflector

Reads a forwarded customer email or ticket, pulls order and refund status from a payments connector (PayPal, Square, or Stripe) or Shopify, account history from the CRM, and open tickets from a support desk (Zoho Desk), drafts a tone-matched reply in the owner's writing voice, and can issue a refund through the payments connector with explicit owner approval. With Shopify connected it also runs a proactive order-triage mode that surfaces orders needing attention — unfulfilled past the promised window, payment problems, pending refunds, stuck shipments — and drafts the next action for each before the customer has to ask. Use when the user says "draft a response," "answer this customer," "where's my order," "I want a refund," "check my orders," or "anything about to blow up."

★ 3.6w
anthropics
anthropics/knowledge-work-plugins

tax-season-organizer

Prepares tax-season materials for the owner's accountant, not tax advice. US federal tax; a non-US business gets its closed-books packet instead. Two modes: (1) quarterly estimated tax from YTD net income in the ledger (MYOB, NetSuite, QuickBooks, Xero, or Zoho Books); (2) year-end 1099 prep, scanning the ledger, PayPal, and Stripe for contractors paid over USD 600 into a 1099-NEC list with missing W-9 flags. Any tax request routes first to /tax-prep, which confirms the books are closed and reconciled before running this skill. Use this skill directly only when the owner says the period's books are already closed: "books are closed, now do the 1099s," "run the quarterly estimate off the closed numbers," or "just the contractor W-9 list."

★ 3.6w
anthropics
anthropics/knowledge-work-plugins

tax-prep

Prepares tax materials as a two-link chain — month-end-prep confirms the books are closed and reconciled first, then tax-season-organizer calculates the quarterly estimated payment or builds the year-end 1099-NEC list and accountant packet from those closed numbers. Requires a ledger (MYOB, NetSuite, QuickBooks, Xero, or Zoho Books); uses Gusto, PayPal, and Stripe when connected, else CSV upload. US federal tax math; a non-US business gets the closed-books packet. Prep material for a CPA, never tax advice, nothing filed. Trigger on "quarterly taxes," "estimated tax payment," "how much should I set aside," "1099s," "1099-NEC," "W-9s," "year-end tax prep," "get my books ready for my accountant," any phrasing that suggests a tax deadline is coming, or a question about net profit or YTD income that sounds like worry about a tax bill. An owner who says the period's books are already closed routes to tax-season-organizer directly.

★ 3.6w
anthropics
anthropics/knowledge-work-plugins

speed-to-lead

Makes sure no inbound lead goes unanswered. Watches web forms, the shared inbox, and the CRM for new inquiries, qualifies each one against the owner's criteria, drafts a reply in the owner's voice with real meeting times for the owner to approve and send, routes anything hot to a human right away, and logs the whole thing to the CRM. Never sends on its own. Built to run on a schedule so overnight inquiries are drafted and sorted by morning, and works from forwarded or pasted inquiries when no connector is available. Use this whenever the owner is worried about inbound leads or response time — including phrasings like "leads are going cold," "did anyone answer that inquiry," "I keep missing form submissions," "nothing falls through the cracks," "handle my inbound," "respond to this lead," or "we lose people because nobody gets back fast enough." Reach for it for a single unanswered inquiry as readily as for a standing setup.

行政与办公人员
★ 3.6w
anthropics
anthropics/knowledge-work-plugins

social-content-engine

Runs the owner's content operation as a standing thing rather than a one-off: keeps a rolling posting calendar, learns the owner's voice, generates on-brand Canva graphics, writes captions that sound like them, repurposes one asset into every channel format, and stages posts for approval instead of publishing on its own. Pulls product photos and prices from Shopify when connected; with no connectors, drafts the calendar and asset briefs for manual posting. Use this whenever the owner talks about posting, content, or social — including "I need to post more," "we've gone quiet on Instagram," "what should we post this month," "make the content," "give me a month of posts," "write this in my voice," "repurpose this," or "set up our content calendar." Reach for it for a single post as readily as for a full quarter. One handoff: a finished, approved campaign brief goes to canva-creator; this skill owns the standing operation.

内容创作者
★ 3.6w
anthropics
anthropics/knowledge-work-plugins

smb-router

The front door to the Small Business plugin. Listens to what the owner needs right now — vague or specific — and routes them to the best skill or slash command for the moment. Also serves as a guide: explains what's available, suggests what to try next, and adapts recommendations based on stored business context. Trigger whenever the owner asks "what can you do," "help me with my business," "what should I focus on," "I don't know where to start," or any open-ended business request that doesn't clearly match a single skill.

★ 3.6w