[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M718MF72HS9FK8G0VZNFAPBK":3,"skill-same:01M718MF72HS9FK8G0VZNFAPBK":188},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":49,"linkOnly":50,"markdownContent":51,"markdownBody":52,"frontMatter":53,"refName":72,"commitSha":73,"skillDirectory":74,"forksCount":75,"repositoryHtmlUrl":76,"repositoryHomepageUrl":6,"ownerHtmlUrl":77,"ownerBlogUrl":78,"ownerDescription":6,"updatedAt":79,"install":80,"resources":93},"01M718MF72HS9FK8G0VZNFAPBK","zoom-apps-sdk",null,"Reference skill for Zoom Apps SDK. Use after routing to an in-client app workflow when building web apps that run inside Zoom meetings, webinars, the main client, or Zoom Phone.","anthropics\u002Fknowledge-work-plugins","anthropics","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F76263028?v=4","01M697XGDPXJAVQ8391V2BCYTE","Anthropic","01M7188MPC48111TN566QNQE3X",35563,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000034","行政与办公人员","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48],"zoom apps sdk","zoom","sdk","apps","app","for","layers","mode","meeting","URL","panel","client","collaborate","domain","phone","reference","use","meetings","routing","run","2026-11-10 10:12:30",false,"---\nname: zoom-apps-sdk\ndescription: Reference skill for Zoom Apps SDK. Use after routing to an in-client app workflow when building web apps that run inside Zoom meetings, webinars, the main client, or Zoom Phone.\nuser-invocable: false\ntriggers:\n  - \"zoom app\"\n  - \"in-meeting app\"\n  - \"app inside zoom\"\n  - \"zoom client app\"\n  - \"layers api\"\n  - \"immersive mode\"\n  - \"camera mode\"\n  - \"collaborate mode\"\n  - \"appssdk\"\n  - \"in-client oauth\"\n  - \"zoom mail\"\n  - \"domain allowlist\"\n  - \"domain whitelist\"\n  - \"url whitelisting\"\n  - \"blank panel\"\n  - \"runningContext\"\n  - \"zoomSdk\"\n---\n\n# Zoom Apps SDK\n\nBackground reference for web apps that run inside the Zoom client. Prefer `choose-zoom-approach` first, then route here for Layers API, Collaborate Mode, in-client OAuth, and runtime constraints.\n\n# Zoom Apps SDK\n\nBuild web apps that run inside the Zoom client - meetings, webinars, main client, and Zoom Phone.\n\n**Official Documentation**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n**SDK Reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n**NPM Package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n\n## Quick Links\n\n**New to Zoom Apps? Follow this path:**\n\n1. **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking\n2. **[Quick Start](examples\u002Fquick-start.md)** - Complete working Express + SDK app\n3. **[Running Contexts](concepts\u002Frunning-contexts.md)** - Where your app runs (inMeeting, inMainClient, etc.)\n4. **[Zoom Apps vs Meeting SDK](concepts\u002Fmeeting-sdk-vs-zoom-apps.md)** - Stop mixing app types\n4. **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - Seamless authorization with PKCE\n5. **[API Reference](references\u002Fapis.md)** - 100+ SDK methods\n6. **Integrated Index** - see the section below in this file\n7. **[5-Minute Runbook](RUNBOOK.md)** - Preflight checks before deep debugging\n\n**Reference:**\n- **[API Reference](references\u002Fapis.md)** - All SDK methods by category\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API](references\u002Flayers-api.md)** - Immersive and camera mode rendering\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n**Having issues?**\n- App won't load in Zoom → Check [Domain Allowlist](#url-whitelisting-required) below\n- SDK errors → [Common Issues](troubleshooting\u002Fcommon-issues.md)\n- Local dev setup → [Debugging Guide](troubleshooting\u002Fdebugging.md)\n- Version upgrade → [Migration Guide](troubleshooting\u002Fmigration.md)\n- Forum-derived FAQs → [Forum Top Questions](troubleshooting\u002Fforum-top-questions.md)\n\n**Building immersive experiences?**\n- [Layers Immersive Mode](examples\u002Flayers-immersive.md) - Custom video layouts\n- [Camera Mode](examples\u002Flayers-camera.md) - Virtual camera overlays\n\n> **Need help with OAuth?** See the **[zoom-oauth](..\u002Foauth\u002FSKILL.md)** skill for authentication flows.\n\n## SDK Overview\n\nThe Zoom Apps SDK (`@zoom\u002Fappssdk`) provides JavaScript APIs for web apps running in Zoom's embedded browser:\n\n- **Context APIs** - Get meeting, user, and participant info\n- **Meeting Actions** - Share app, invite participants, open URLs\n- **Authorization** - In-Client OAuth with PKCE (no browser redirect)\n- **Layers API** - Immersive video layouts and camera mode overlays\n- **Collaborate Mode** - Shared app state across participants\n- **App Communication** - Message passing between app instances (main client \u003C-> meeting)\n- **Media Controls** - Virtual backgrounds, camera listing, recording control\n- **UI Controls** - Expand app, notifications, popout\n- **Events** - React to meeting state, participants, sharing, and more\n\n## Prerequisites\n\n- Zoom app configured as **\"Zoom App\"** type in [Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n- OAuth credentials (Client ID + Secret) with Zoom Apps scopes\n- Web application (Node.js + Express recommended)\n- **Your domain whitelisted** in Marketplace domain allowlist\n- ngrok or HTTPS tunnel for local development\n- Node.js 18+ (for the backend server)\n\n## Quick Start\n\n### Option A: NPM (Recommended for frameworks)\n\n```bash\nnpm install @zoom\u002Fappssdk\n```\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nasync function init() {\n  try {\n    const configResponse = await zoomSdk.config({\n      capabilities: [\n        'shareApp',\n        'getMeetingContext',\n        'getUserContext',\n        'openUrl'\n      ],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n    \u002F\u002F 'inMeeting' | 'inMainClient' | 'inWebinar' | 'inImmersive' | ...\n\n    const context = await zoomSdk.getMeetingContext();\n    console.log('Meeting ID:', context.meetingID);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n```\n\n### Option B: CDN (Vanilla JS)\n\n```html\n\u003Cscript src=\"https:\u002F\u002Fappssdk.zoom.us\u002Fsdk.js\">\u003C\u002Fscript>\n\n\u003Cscript>\n\u002F\u002F CRITICAL: Do NOT declare \"let zoomSdk\" - the SDK defines window.zoomSdk globally\n\u002F\u002F Using \"let zoomSdk = ...\" causes: SyntaxError: redeclaration of non-configurable global property\nlet sdk = window.zoomSdk;  \u002F\u002F Use a different variable name\n\nasync function init() {\n  try {\n    const configResponse = await sdk.config({\n      capabilities: ['shareApp', 'getMeetingContext', 'getUserContext'],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n\nfunction showDemoMode() {\n  document.body.innerHTML = '\u003Ch1>Preview Mode\u003C\u002Fh1>\u003Cp>Open this app inside Zoom to use.\u003C\u002Fp>';\n}\n\ndocument.addEventListener('DOMContentLoaded', () => {\n  init();\n  setTimeout(() => { if (!sdk) showDemoMode(); }, 3000);\n});\n\u003C\u002Fscript>\n```\n\n## Critical: Global Variable Conflict\n\nThe CDN script defines `window.zoomSdk` globally. **Do NOT redeclare it:**\n\n```javascript\n\u002F\u002F WRONG - causes SyntaxError in Zoom's embedded browser\nlet zoomSdk = null;\nzoomSdk = window.zoomSdk;\n\n\u002F\u002F CORRECT - use different variable name\nlet sdk = window.zoomSdk;\n\n\u002F\u002F ALSO CORRECT - NPM import (no conflict)\nimport zoomSdk from '@zoom\u002Fappssdk';\n```\n\nThis only applies to the CDN approach. The NPM import creates a module-scoped variable, no conflict.\n\n## Browser Preview \u002F Demo Mode\n\nThe SDK only functions inside the Zoom client. When accessed in a regular browser:\n- `window.zoomSdk` exists but `sdk.config()` throws an error\n- Always implement try\u002Fcatch with fallback UI\n- Add timeout (3 seconds) in case SDK hangs\n\n## URL Whitelisting (Required)\n\n**Your app will NOT load in Zoom unless the domain is whitelisted.**\n\n1. Go to [Zoom Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n2. Open your app -> **Feature** tab\n3. Under **Zoom App**, find **Add Allow List**\n4. Add your domain (e.g., `yourdomain.com` for production, `xxxxx.ngrok.io` for dev)\n\nWithout this, the Zoom client shows a blank panel with no error message.\n\n## OAuth Scopes (Required)\n\nCapabilities require matching OAuth scopes enabled in Marketplace:\n\n| Capability | Required Scope |\n|------------|----------------|\n| `getMeetingContext` | `zoomapp:inmeeting` |\n| `getUserContext` | `zoomapp:inmeeting` |\n| `shareApp` | `zoomapp:inmeeting` |\n| `openUrl` | `zoomapp:inmeeting` |\n| `sendAppInvitation` | `zoomapp:inmeeting` |\n| `runRenderingContext` | `zoomapp:inmeeting` |\n| `authorize` | `zoomapp:inmeeting` |\n| `getMeetingParticipants` | `zoomapp:inmeeting` |\n\n**To add scopes:** Marketplace -> Your App -> **Scopes** tab -> Add required scopes.\n\nMissing scopes = capability fails silently or throws error. Users must re-authorize if you add new scopes.\n\n## Running Contexts\n\nYour app runs in different surfaces within Zoom. The `configResponse.runningContext` tells you where:\n\n| Context | Surface | Description |\n|---------|---------|-------------|\n| `inMeeting` | Meeting sidebar | Most common. Full meeting APIs available |\n| `inMainClient` | Main client panel | Home tab. No meeting context APIs |\n| `inWebinar` | Webinar sidebar | Host\u002Fpanelist. Meeting + webinar APIs |\n| `inImmersive` | Layers API | Full-screen custom rendering |\n| `inCamera` | Camera mode | Virtual camera overlay |\n| `inCollaborate` | Collaborate mode | Shared state context |\n| `inPhone` | Zoom Phone | Phone call app |\n| `inChat` | Team Chat | Chat sidebar |\n\nSee **[Running Contexts](concepts\u002Frunning-contexts.md)** for context-specific behavior and APIs.\n\n## SDK Initialization Pattern\n\nEvery Zoom App starts with `config()`:\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nconst configResponse = await zoomSdk.config({\n  capabilities: [\n    \u002F\u002F List ALL APIs you will use\n    'getMeetingContext',\n    'getUserContext',\n    'shareApp',\n    'openUrl',\n    'authorize',\n    'onAuthorized'\n  ],\n  version: '0.16'\n});\n\n\u002F\u002F configResponse contains:\n\u002F\u002F {\n\u002F\u002F   runningContext: 'inMeeting',\n\u002F\u002F   clientVersion: '5.x.x',\n\u002F\u002F   unsupportedApis: []  \u002F\u002F APIs not supported in this client version\n\u002F\u002F }\n```\n\n**Rules:**\n1. `config()` MUST be called before any other SDK method\n2. Only capabilities listed in `config()` are available\n3. Capabilities must match OAuth scopes in Marketplace\n4. Check `unsupportedApis` for graceful degradation\n\n## In-Client OAuth (Summary)\n\nBest UX for authorization - no browser redirect:\n\n```javascript\n\u002F\u002F 1. Get code challenge from your backend\nconst { codeChallenge, state } = await fetch('\u002Fapi\u002Fauth\u002Fchallenge').then(r => r.json());\n\n\u002F\u002F 2. Trigger in-client authorization\nawait zoomSdk.authorize({ codeChallenge, state });\n\n\u002F\u002F 3. Listen for authorization result\nzoomSdk.addEventListener('onAuthorized', async (event) => {\n  const { code, state } = event;\n  \u002F\u002F 4. Send code to backend for token exchange\n  await fetch('\u002Fapi\u002Fauth\u002Ftoken', {\n    method: 'POST',\n    body: JSON.stringify({ code, state })\n  });\n});\n```\n\nSee **[In-Client OAuth Guide](examples\u002Fin-client-oauth.md)** for complete implementation.\n\n## Layers API (Summary)\n\nBuild immersive video layouts and camera overlays:\n\n```javascript\n\u002F\u002F Start immersive mode - replaces gallery view\nawait zoomSdk.runRenderingContext({ view: 'immersive' });\n\n\u002F\u002F Position participant video feeds\nawait zoomSdk.drawParticipant({\n  participantUUID: 'user-uuid',\n  x: 0, y: 0, width: 640, height: 480, zIndex: 1\n});\n\n\u002F\u002F Add overlay images\nawait zoomSdk.drawImage({\n  imageData: canvas.toDataURL(),\n  x: 0, y: 0, width: 1280, height: 720, zIndex: 0\n});\n\n\u002F\u002F Exit immersive mode\nawait zoomSdk.closeRenderingContext();\n```\n\nSee **[Layers Immersive](examples\u002Flayers-immersive.md)** and **[Camera Mode](examples\u002Flayers-camera.md)**.\n\n## Environment Variables\n\n| Variable | Description | Where to Find |\n|----------|-------------|---------------|\n| `ZOOM_APP_CLIENT_ID` | App client ID | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_CLIENT_SECRET` | App client secret | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_REDIRECT_URI` | OAuth redirect URL | Your server URL + `\u002Fauth` |\n| `SESSION_SECRET` | Cookie signing secret | Generate random string |\n| `ZOOM_HOST` | Zoom host URL | `https:\u002F\u002Fzoom.us` (or `https:\u002F\u002Fzoomgov.com`) |\n\n## Common APIs\n\n| API | Description |\n|-----|-------------|\n| `config()` | Initialize SDK, request capabilities |\n| `getMeetingContext()` | Get meeting ID, topic, status |\n| `getUserContext()` | Get user name, role, participant ID |\n| `getRunningContext()` | Get current running context |\n| `getMeetingParticipants()` | List participants |\n| `shareApp()` | Share app screen with participants |\n| `openUrl({ url })` | Open URL in external browser |\n| `sendAppInvitation()` | Invite users to open your app |\n| `authorize()` | Trigger In-Client OAuth |\n| `connect()` | Connect to other app instances |\n| `postMessage()` | Send message to connected instances |\n| `runRenderingContext()` | Start Layers API (immersive\u002Fcamera) |\n| `expandApp({ action })` | Expand\u002Fcollapse app panel |\n| `showNotification()` | Show notification in Zoom |\n\n## Complete Documentation Library\n\n### Core Concepts\n- **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking, X-Zoom-App-Context\n- **[Running Contexts](concepts\u002Frunning-contexts.md)** - All contexts, context-specific APIs, multi-instance communication\n- **[Security](concepts\u002Fsecurity.md)** - OWASP headers, CSP, cookie security, PKCE, token storage\n\n### Complete Examples\n- **[Quick Start](examples\u002Fquick-start.md)** - Hello World Express + SDK app\n- **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - PKCE authorization flow\n- **[Layers Immersive](examples\u002Flayers-immersive.md)** - Custom video layouts\n- **[Camera Mode](examples\u002Flayers-camera.md)** - Virtual camera overlays\n- **[Collaborate Mode](examples\u002Fcollaborate-mode.md)** - Shared state across participants\n- **[Guest Mode](examples\u002Fguest-mode.md)** - Unauthenticated\u002Fauthenticated\u002Fauthorized states\n- **[Breakout Rooms](examples\u002Fbreakout-rooms.md)** - Room detection and cross-room state\n- **[App Communication](examples\u002Fapp-communication.md)** - connect + postMessage between instances\n\n### Troubleshooting\n- **[Common Issues](troubleshooting\u002Fcommon-issues.md)** - Quick diagnostics and error codes\n- **[Debugging](troubleshooting\u002Fdebugging.md)** - Local dev, ngrok, browser preview\n- **[Migration](troubleshooting\u002Fmigration.md)** - SDK version upgrade notes\n\n### References\n- **[API Reference](references\u002Fapis.md)** - All 100+ SDK methods\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API Reference](references\u002Flayers-api.md)** - Drawing and rendering methods\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n## Sample Repositories\n\n### Official (by Zoom)\n\n| Repository | Type | Last Updated | Status | SDK Version |\n|-----------|------|-------------|--------|-------------|\n| [zoomapps-sample-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-sample-js) | Hello World (Vanilla JS) | Dec 2025 | Active | ^0.16.26 |\n| [zoomapps-advancedsample-react](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-advancedsample-react) | Advanced (React + Redis) | Oct 2025 | Active | 0.16.0 |\n| [zoomapps-customlayout-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-customlayout-js) | Layers API | Nov 2023 | Stale | ^0.16.8 |\n| [zoomapps-texteditor-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-texteditor-vuejs) | Collaborate (Vue + Y.js) | Oct 2023 | Stale | ^0.16.7 |\n| [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) | Serverless (Firebase) | Aug 2024 | Stale | ^0.16.21 |\n| [zoomapps-cameramode-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-cameramode-vuejs) | Camera Mode | - | - | - |\n| [zoomapps-workshop-sample](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-workshop-sample) | Workshop | - | - | - |\n\n**Recommended for new projects:** Use `@zoom\u002Fappssdk` version `^0.16.26`.\n\n### Community\n\n| Type | Repository | Description |\n|------|------------|-------------|\n| Library | [harvard-edtech\u002Fzaccl](https:\u002F\u002Fgithub.com\u002Fharvard-edtech\u002Fzaccl) | Zoom App Complete Connection Library |\n\n**Full list**: See [general\u002Freferences\u002Fcommunity-repos.md](..\u002Fgeneral\u002Freferences\u002Fcommunity-repos.md)\n\n### Learning Path\n\n1. **Start**: `zoomapps-sample-js` - Simplest, most up-to-date\n2. **Advanced**: `zoomapps-advancedsample-react` - Comprehensive (In-Client OAuth, Guest Mode, Collaborate)\n3. **Specialized**: Pick based on feature (Layers, Serverless, Camera Mode)\n\n## Critical Gotchas (From Real Development)\n\n### 1. Global Variable Conflict\nThe CDN script defines `window.zoomSdk`. Declaring `let zoomSdk` in your code causes `SyntaxError: redeclaration of non-configurable global property`. Use `let sdk = window.zoomSdk` or the NPM import.\n\n### 2. Domain Allowlist\nYour app URL **must** be in the Marketplace domain allowlist. Without it, Zoom shows a blank panel with no error. Also add `appssdk.zoom.us` and any CDN domains you use.\n\n### 3. Capabilities Must Be Listed\nOnly APIs listed in `config({ capabilities: [...] })` are available. Calling an unlisted API throws an error. This is also true for event listeners.\n\n### 4. SDK Only Works Inside Zoom\n`zoomSdk.config()` throws outside the Zoom client. Always wrap in try\u002Fcatch with browser fallback:\n```javascript\ntry { await zoomSdk.config({...}); } catch { showBrowserPreview(); }\n```\n\n### 5. ngrok URL Changes\nFree ngrok URLs change on restart. You must update 4 places in Marketplace: Home URL, Redirect URL, OAuth Allow List, Domain Allow List. Consider ngrok paid plan for stable subdomain.\n\n### 6. In-Client OAuth vs Web OAuth\nUse `zoomSdk.authorize()` (In-Client) for best UX - no browser redirect. Only fall back to web redirect for initial install from Marketplace.\n\n### 7. Camera Mode CEF Race Condition\nCamera mode uses CEF which takes time to initialize. `drawImage`\u002F`drawWebView` may fail if called too early. Implement retry with exponential backoff.\n\n### 8. Cookie Configuration\nZoom's embedded browser requires cookies with `SameSite=None` and `Secure=true`. Without this, sessions break silently.\n\n### 9. State Validation\nAlways validate the OAuth `state` parameter to prevent CSRF attacks. Generate cryptographically random state, store it, and verify on callback.\n\n## Resources\n\n- **Official docs**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n- **SDK reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n- **NPM package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n- **Developer forum**: https:\u002F\u002Fdevforum.zoom.us\u002F\n- **GitHub SDK source**: https:\u002F\u002Fgithub.com\u002Fzoom\u002Fappssdk\n\n---\n\n**Need help?** Start with Integrated Index section below for complete navigation.\n\n---\n\n## Integrated Index\n\n_This section was migrated from `SKILL.md`._\n\n## Quick Start Path\n\n**If you're new to Zoom Apps, follow this order:**\n\n1. **Run preflight checks first** -> [RUNBOOK.md](RUNBOOK.md)\n\n2. **Read the architecture** -> [concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)\n   - Frontend\u002Fbackend pattern, embedded browser, deep linking\n   - Understand how Zoom loads and communicates with your app\n\n3. **Build your first app** -> [examples\u002Fquick-start.md](examples\u002Fquick-start.md)\n   - Complete Express + SDK Hello World\n   - ngrok setup for local development\n\n4. **Understand running contexts** -> [concepts\u002Frunning-contexts.md](concepts\u002Frunning-contexts.md)\n   - Where your app runs (inMeeting, inMainClient, inWebinar, etc.)\n   - Context-specific APIs and limitations\n\n5. **Implement OAuth** -> [examples\u002Fin-client-oauth.md](examples\u002Fin-client-oauth.md)\n   - In-Client OAuth with PKCE (best UX)\n   - Token exchange and storage\n\n6. **Add features** -> [references\u002Fapis.md](references\u002Fapis.md)\n   - 100+ SDK methods organized by category\n   - Code examples for each\n\n7. **Troubleshoot** -> [troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)\n   - Quick diagnostics for common problems\n\n---\n\n## Documentation Structure\n\n```\nzoom-apps-sdk\u002F\n├── SKILL.md                           # Main skill overview\n├── SKILL.md                           # This file - navigation guide\n│\n├── concepts\u002F                          # Core architectural patterns\n│   ├── architecture.md               # Frontend\u002Fbackend, embedded browser, OAuth flow\n│   ├── running-contexts.md           # Where your app runs + context-specific APIs\n│   └── security.md                   # OWASP headers, CSP, data access layers\n│\n├── examples\u002F                          # Complete working code\n│   ├── quick-start.md                # Hello World - minimal Express + SDK app\n│   ├── in-client-oauth.md            # In-Client OAuth with PKCE\n│   ├── layers-immersive.md           # Layers API - immersive mode (custom layouts)\n│   ├── layers-camera.md              # Layers API - camera mode (virtual camera)\n│   ├── collaborate-mode.md           # Collaborate mode (shared state)\n│   ├── guest-mode.md                 # Guest mode (unauthenticated -> authorized)\n│   ├── breakout-rooms.md             # Breakout room integration\n│   └── app-communication.md          # connect + postMessage between instances\n│\n├── troubleshooting\u002F                   # Problem solving guides\n│   ├── common-issues.md              # Quick diagnostics, error codes\n│   ├── debugging.md                  # Local dev setup, ngrok, browser preview\n│   └── migration.md                  # SDK version migration notes\n│\n└── references\u002F                        # Reference documentation\n    ├── apis.md                        # Complete API reference (100+ methods)\n    ├── events.md                      # All SDK events\n    ├── layers-api.md                  # Layers API detailed reference\n    ├── oauth.md                       # OAuth flows for Zoom Apps\n    └── zmail-sdk.md                   # Zoom Mail integration\n```\n\n---\n\n## By Use Case\n\n### I want to build a basic Zoom App\n1. [Architecture](concepts\u002Farchitecture.md) - Understand the pattern\n2. [Quick Start](examples\u002Fquick-start.md) - Build Hello World\n3. [In-Client OAuth](examples\u002Fin-client-oauth.md) - Add authorization\n4. [Security](concepts\u002Fsecurity.md) - Required headers\n\n### I want immersive video layouts (Layers API)\n1. [Layers Immersive](examples\u002Flayers-immersive.md) - Custom video positions\n2. [Layers API Reference](references\u002Flayers-api.md) - All drawing methods\n3. [App Communication](examples\u002Fapp-communication.md) - Sync layout across participants\n\n### I want a virtual camera overlay\n1. [Camera Mode](examples\u002Flayers-camera.md) - Camera mode rendering\n2. [Layers API Reference](references\u002Flayers-api.md) - Drawing methods\n\n### I want real-time collaboration\n1. [Collaborate Mode](examples\u002Fcollaborate-mode.md) - Shared state APIs\n2. [App Communication](examples\u002Fapp-communication.md) - Instance messaging\n\n### I want guest\u002Fanonymous access\n1. [Guest Mode](examples\u002Fguest-mode.md) - Three authorization states\n2. [In-Client OAuth](examples\u002Fin-client-oauth.md) - promptAuthorize flow\n\n### I want breakout room support\n1. [Breakout Rooms](examples\u002Fbreakout-rooms.md) - Room detection and state sync\n\n### I want to sync between main client and meeting\n1. [App Communication](examples\u002Fapp-communication.md) - connect + postMessage\n2. [Running Contexts](concepts\u002Frunning-contexts.md) - Multi-instance behavior\n\n### I want serverless deployment\n1. [Quick Start](examples\u002Fquick-start.md) - Understand the base pattern first\n2. Sample: [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) - Firebase pattern\n\n### I want to add Zoom Mail integration\n1. [Zoom Mail Reference](references\u002Fzmail-sdk.md) - REST API + mail plugins\n\n### I'm getting errors\n1. [Common Issues](troubleshooting\u002Fcommon-issues.md) - Quick diagnostic table\n2. [Debugging](troubleshooting\u002Fdebugging.md) - Local dev setup, DevTools\n3. [Migration](troubleshooting\u002Fmigration.md) - Version compatibility\n\n---\n\n## Most Critical Documents\n\n### 1. Architecture (FOUNDATION)\n**[concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)**\n\nUnderstand how Zoom Apps work: Frontend in embedded browser, backend for OAuth\u002FAPI, SDK as the bridge. Without this, nothing else makes sense.\n\n### 2. Quick Start (FIRST APP)\n**[examples\u002Fquick-start.md](examples\u002Fquick-start.md)**\n\nComplete working code. Get something running before diving into advanced features.\n\n### 3. Common Issues (MOST COMMON PROBLEMS)\n**[troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)**\n\n90% of Zoom Apps issues are: domain allowlist, global variable conflict, or missing capabilities.\n\n---\n\n## Key Learnings\n\n### Critical Discoveries:\n\n1. **Global Variable Conflict is the #1 Gotcha**\n   - CDN script defines `window.zoomSdk` globally\n   - `let zoomSdk = ...` causes SyntaxError in Zoom's browser\n   - Use `let sdk = window.zoomSdk` or NPM import\n\n2. **Domain Allowlist is Non-Negotiable**\n   - App shows blank panel with zero error if domain not whitelisted\n   - Must include your domain AND `appssdk.zoom.us` AND any CDN domains\n   - ngrok URLs change on restart - must update Marketplace each time\n\n3. **config() Gates Everything**\n   - Must be called first, must list all capabilities\n   - Unlisted capabilities throw errors\n   - Check `unsupportedApis` for client version compatibility\n\n4. **In-Client OAuth > Web OAuth for UX**\n   - `authorize()` keeps user in Zoom (no browser redirect)\n   - Web redirect only needed for initial Marketplace install\n   - Always implement PKCE (code_verifier + code_challenge)\n\n5. **Two App Instances Can Run Simultaneously**\n   - Main client instance + meeting instance\n   - Use `connect()` + `postMessage()` to sync between them\n   - Pre-meeting setup in main client, use in meeting\n\n6. **Camera Mode Has CEF Quirks**\n   - CEF initialization takes time\n   - Draw calls may fail if too early\n   - Use retry with exponential backoff\n\n7. **Cookie Settings Matter**\n   - `SameSite=None` + `Secure=true` required\n   - Without this, sessions silently fail in embedded browser\n\n---\n\n## Quick Reference\n\n### \"App shows blank panel\"\n-> [Domain Allowlist](troubleshooting\u002Fcommon-issues.md) - add domain to Marketplace\n\n### \"SyntaxError: redeclaration\"\n-> [Global Variable](troubleshooting\u002Fcommon-issues.md) - use `let sdk = window.zoomSdk`\n\n### \"config() throws error\"\n-> [Browser Preview](troubleshooting\u002Fdebugging.md) - SDK only works inside Zoom\n\n### \"API call fails silently\"\n-> [OAuth Scopes](troubleshooting\u002Fcommon-issues.md) - add required scopes in Marketplace\n\n### \"How do I implement [feature]?\"\n-> [API Reference](references\u002Fapis.md) - find the method, check capabilities needed\n\n### \"How do I test locally?\"\n-> [Debugging Guide](troubleshooting\u002Fdebugging.md) - ngrok + Marketplace config\n\n---\n\n## Document Version\n\nBased on **@zoom\u002Fappssdk v0.16.x** (latest: 0.16.26+)\n\n---\n\n**Happy coding!**\n\nStart with [Architecture](concepts\u002Farchitecture.md) to understand the pattern, then [Quick Start](examples\u002Fquick-start.md) to build your first app.\n","# Zoom Apps SDK\n\nBackground reference for web apps that run inside the Zoom client. Prefer `choose-zoom-approach` first, then route here for Layers API, Collaborate Mode, in-client OAuth, and runtime constraints.\n\n# Zoom Apps SDK\n\nBuild web apps that run inside the Zoom client - meetings, webinars, main client, and Zoom Phone.\n\n**Official Documentation**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n**SDK Reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n**NPM Package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n\n## Quick Links\n\n**New to Zoom Apps? Follow this path:**\n\n1. **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking\n2. **[Quick Start](examples\u002Fquick-start.md)** - Complete working Express + SDK app\n3. **[Running Contexts](concepts\u002Frunning-contexts.md)** - Where your app runs (inMeeting, inMainClient, etc.)\n4. **[Zoom Apps vs Meeting SDK](concepts\u002Fmeeting-sdk-vs-zoom-apps.md)** - Stop mixing app types\n4. **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - Seamless authorization with PKCE\n5. **[API Reference](references\u002Fapis.md)** - 100+ SDK methods\n6. **Integrated Index** - see the section below in this file\n7. **[5-Minute Runbook](RUNBOOK.md)** - Preflight checks before deep debugging\n\n**Reference:**\n- **[API Reference](references\u002Fapis.md)** - All SDK methods by category\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API](references\u002Flayers-api.md)** - Immersive and camera mode rendering\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n**Having issues?**\n- App won't load in Zoom → Check [Domain Allowlist](#url-whitelisting-required) below\n- SDK errors → [Common Issues](troubleshooting\u002Fcommon-issues.md)\n- Local dev setup → [Debugging Guide](troubleshooting\u002Fdebugging.md)\n- Version upgrade → [Migration Guide](troubleshooting\u002Fmigration.md)\n- Forum-derived FAQs → [Forum Top Questions](troubleshooting\u002Fforum-top-questions.md)\n\n**Building immersive experiences?**\n- [Layers Immersive Mode](examples\u002Flayers-immersive.md) - Custom video layouts\n- [Camera Mode](examples\u002Flayers-camera.md) - Virtual camera overlays\n\n> **Need help with OAuth?** See the **[zoom-oauth](..\u002Foauth\u002FSKILL.md)** skill for authentication flows.\n\n## SDK Overview\n\nThe Zoom Apps SDK (`@zoom\u002Fappssdk`) provides JavaScript APIs for web apps running in Zoom's embedded browser:\n\n- **Context APIs** - Get meeting, user, and participant info\n- **Meeting Actions** - Share app, invite participants, open URLs\n- **Authorization** - In-Client OAuth with PKCE (no browser redirect)\n- **Layers API** - Immersive video layouts and camera mode overlays\n- **Collaborate Mode** - Shared app state across participants\n- **App Communication** - Message passing between app instances (main client \u003C-> meeting)\n- **Media Controls** - Virtual backgrounds, camera listing, recording control\n- **UI Controls** - Expand app, notifications, popout\n- **Events** - React to meeting state, participants, sharing, and more\n\n## Prerequisites\n\n- Zoom app configured as **\"Zoom App\"** type in [Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n- OAuth credentials (Client ID + Secret) with Zoom Apps scopes\n- Web application (Node.js + Express recommended)\n- **Your domain whitelisted** in Marketplace domain allowlist\n- ngrok or HTTPS tunnel for local development\n- Node.js 18+ (for the backend server)\n\n## Quick Start\n\n### Option A: NPM (Recommended for frameworks)\n\n```bash\nnpm install @zoom\u002Fappssdk\n```\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nasync function init() {\n  try {\n    const configResponse = await zoomSdk.config({\n      capabilities: [\n        'shareApp',\n        'getMeetingContext',\n        'getUserContext',\n        'openUrl'\n      ],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n    \u002F\u002F 'inMeeting' | 'inMainClient' | 'inWebinar' | 'inImmersive' | ...\n\n    const context = await zoomSdk.getMeetingContext();\n    console.log('Meeting ID:', context.meetingID);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n```\n\n### Option B: CDN (Vanilla JS)\n\n```html\n\u003Cscript src=\"https:\u002F\u002Fappssdk.zoom.us\u002Fsdk.js\">\u003C\u002Fscript>\n\n\u003Cscript>\n\u002F\u002F CRITICAL: Do NOT declare \"let zoomSdk\" - the SDK defines window.zoomSdk globally\n\u002F\u002F Using \"let zoomSdk = ...\" causes: SyntaxError: redeclaration of non-configurable global property\nlet sdk = window.zoomSdk;  \u002F\u002F Use a different variable name\n\nasync function init() {\n  try {\n    const configResponse = await sdk.config({\n      capabilities: ['shareApp', 'getMeetingContext', 'getUserContext'],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n\nfunction showDemoMode() {\n  document.body.innerHTML = '\u003Ch1>Preview Mode\u003C\u002Fh1>\u003Cp>Open this app inside Zoom to use.\u003C\u002Fp>';\n}\n\ndocument.addEventListener('DOMContentLoaded', () => {\n  init();\n  setTimeout(() => { if (!sdk) showDemoMode(); }, 3000);\n});\n\u003C\u002Fscript>\n```\n\n## Critical: Global Variable Conflict\n\nThe CDN script defines `window.zoomSdk` globally. **Do NOT redeclare it:**\n\n```javascript\n\u002F\u002F WRONG - causes SyntaxError in Zoom's embedded browser\nlet zoomSdk = null;\nzoomSdk = window.zoomSdk;\n\n\u002F\u002F CORRECT - use different variable name\nlet sdk = window.zoomSdk;\n\n\u002F\u002F ALSO CORRECT - NPM import (no conflict)\nimport zoomSdk from '@zoom\u002Fappssdk';\n```\n\nThis only applies to the CDN approach. The NPM import creates a module-scoped variable, no conflict.\n\n## Browser Preview \u002F Demo Mode\n\nThe SDK only functions inside the Zoom client. When accessed in a regular browser:\n- `window.zoomSdk` exists but `sdk.config()` throws an error\n- Always implement try\u002Fcatch with fallback UI\n- Add timeout (3 seconds) in case SDK hangs\n\n## URL Whitelisting (Required)\n\n**Your app will NOT load in Zoom unless the domain is whitelisted.**\n\n1. Go to [Zoom Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n2. Open your app -> **Feature** tab\n3. Under **Zoom App**, find **Add Allow List**\n4. Add your domain (e.g., `yourdomain.com` for production, `xxxxx.ngrok.io` for dev)\n\nWithout this, the Zoom client shows a blank panel with no error message.\n\n## OAuth Scopes (Required)\n\nCapabilities require matching OAuth scopes enabled in Marketplace:\n\n| Capability | Required Scope |\n|------------|----------------|\n| `getMeetingContext` | `zoomapp:inmeeting` |\n| `getUserContext` | `zoomapp:inmeeting` |\n| `shareApp` | `zoomapp:inmeeting` |\n| `openUrl` | `zoomapp:inmeeting` |\n| `sendAppInvitation` | `zoomapp:inmeeting` |\n| `runRenderingContext` | `zoomapp:inmeeting` |\n| `authorize` | `zoomapp:inmeeting` |\n| `getMeetingParticipants` | `zoomapp:inmeeting` |\n\n**To add scopes:** Marketplace -> Your App -> **Scopes** tab -> Add required scopes.\n\nMissing scopes = capability fails silently or throws error. Users must re-authorize if you add new scopes.\n\n## Running Contexts\n\nYour app runs in different surfaces within Zoom. The `configResponse.runningContext` tells you where:\n\n| Context | Surface | Description |\n|---------|---------|-------------|\n| `inMeeting` | Meeting sidebar | Most common. Full meeting APIs available |\n| `inMainClient` | Main client panel | Home tab. No meeting context APIs |\n| `inWebinar` | Webinar sidebar | Host\u002Fpanelist. Meeting + webinar APIs |\n| `inImmersive` | Layers API | Full-screen custom rendering |\n| `inCamera` | Camera mode | Virtual camera overlay |\n| `inCollaborate` | Collaborate mode | Shared state context |\n| `inPhone` | Zoom Phone | Phone call app |\n| `inChat` | Team Chat | Chat sidebar |\n\nSee **[Running Contexts](concepts\u002Frunning-contexts.md)** for context-specific behavior and APIs.\n\n## SDK Initialization Pattern\n\nEvery Zoom App starts with `config()`:\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nconst configResponse = await zoomSdk.config({\n  capabilities: [\n    \u002F\u002F List ALL APIs you will use\n    'getMeetingContext',\n    'getUserContext',\n    'shareApp',\n    'openUrl',\n    'authorize',\n    'onAuthorized'\n  ],\n  version: '0.16'\n});\n\n\u002F\u002F configResponse contains:\n\u002F\u002F {\n\u002F\u002F   runningContext: 'inMeeting',\n\u002F\u002F   clientVersion: '5.x.x',\n\u002F\u002F   unsupportedApis: []  \u002F\u002F APIs not supported in this client version\n\u002F\u002F }\n```\n\n**Rules:**\n1. `config()` MUST be called before any other SDK method\n2. Only capabilities listed in `config()` are available\n3. Capabilities must match OAuth scopes in Marketplace\n4. Check `unsupportedApis` for graceful degradation\n\n## In-Client OAuth (Summary)\n\nBest UX for authorization - no browser redirect:\n\n```javascript\n\u002F\u002F 1. Get code challenge from your backend\nconst { codeChallenge, state } = await fetch('\u002Fapi\u002Fauth\u002Fchallenge').then(r => r.json());\n\n\u002F\u002F 2. Trigger in-client authorization\nawait zoomSdk.authorize({ codeChallenge, state });\n\n\u002F\u002F 3. Listen for authorization result\nzoomSdk.addEventListener('onAuthorized', async (event) => {\n  const { code, state } = event;\n  \u002F\u002F 4. Send code to backend for token exchange\n  await fetch('\u002Fapi\u002Fauth\u002Ftoken', {\n    method: 'POST',\n    body: JSON.stringify({ code, state })\n  });\n});\n```\n\nSee **[In-Client OAuth Guide](examples\u002Fin-client-oauth.md)** for complete implementation.\n\n## Layers API (Summary)\n\nBuild immersive video layouts and camera overlays:\n\n```javascript\n\u002F\u002F Start immersive mode - replaces gallery view\nawait zoomSdk.runRenderingContext({ view: 'immersive' });\n\n\u002F\u002F Position participant video feeds\nawait zoomSdk.drawParticipant({\n  participantUUID: 'user-uuid',\n  x: 0, y: 0, width: 640, height: 480, zIndex: 1\n});\n\n\u002F\u002F Add overlay images\nawait zoomSdk.drawImage({\n  imageData: canvas.toDataURL(),\n  x: 0, y: 0, width: 1280, height: 720, zIndex: 0\n});\n\n\u002F\u002F Exit immersive mode\nawait zoomSdk.closeRenderingContext();\n```\n\nSee **[Layers Immersive](examples\u002Flayers-immersive.md)** and **[Camera Mode](examples\u002Flayers-camera.md)**.\n\n## Environment Variables\n\n| Variable | Description | Where to Find |\n|----------|-------------|---------------|\n| `ZOOM_APP_CLIENT_ID` | App client ID | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_CLIENT_SECRET` | App client secret | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_REDIRECT_URI` | OAuth redirect URL | Your server URL + `\u002Fauth` |\n| `SESSION_SECRET` | Cookie signing secret | Generate random string |\n| `ZOOM_HOST` | Zoom host URL | `https:\u002F\u002Fzoom.us` (or `https:\u002F\u002Fzoomgov.com`) |\n\n## Common APIs\n\n| API | Description |\n|-----|-------------|\n| `config()` | Initialize SDK, request capabilities |\n| `getMeetingContext()` | Get meeting ID, topic, status |\n| `getUserContext()` | Get user name, role, participant ID |\n| `getRunningContext()` | Get current running context |\n| `getMeetingParticipants()` | List participants |\n| `shareApp()` | Share app screen with participants |\n| `openUrl({ url })` | Open URL in external browser |\n| `sendAppInvitation()` | Invite users to open your app |\n| `authorize()` | Trigger In-Client OAuth |\n| `connect()` | Connect to other app instances |\n| `postMessage()` | Send message to connected instances |\n| `runRenderingContext()` | Start Layers API (immersive\u002Fcamera) |\n| `expandApp({ action })` | Expand\u002Fcollapse app panel |\n| `showNotification()` | Show notification in Zoom |\n\n## Complete Documentation Library\n\n### Core Concepts\n- **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking, X-Zoom-App-Context\n- **[Running Contexts](concepts\u002Frunning-contexts.md)** - All contexts, context-specific APIs, multi-instance communication\n- **[Security](concepts\u002Fsecurity.md)** - OWASP headers, CSP, cookie security, PKCE, token storage\n\n### Complete Examples\n- **[Quick Start](examples\u002Fquick-start.md)** - Hello World Express + SDK app\n- **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - PKCE authorization flow\n- **[Layers Immersive](examples\u002Flayers-immersive.md)** - Custom video layouts\n- **[Camera Mode](examples\u002Flayers-camera.md)** - Virtual camera overlays\n- **[Collaborate Mode](examples\u002Fcollaborate-mode.md)** - Shared state across participants\n- **[Guest Mode](examples\u002Fguest-mode.md)** - Unauthenticated\u002Fauthenticated\u002Fauthorized states\n- **[Breakout Rooms](examples\u002Fbreakout-rooms.md)** - Room detection and cross-room state\n- **[App Communication](examples\u002Fapp-communication.md)** - connect + postMessage between instances\n\n### Troubleshooting\n- **[Common Issues](troubleshooting\u002Fcommon-issues.md)** - Quick diagnostics and error codes\n- **[Debugging](troubleshooting\u002Fdebugging.md)** - Local dev, ngrok, browser preview\n- **[Migration](troubleshooting\u002Fmigration.md)** - SDK version upgrade notes\n\n### References\n- **[API Reference](references\u002Fapis.md)** - All 100+ SDK methods\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API Reference](references\u002Flayers-api.md)** - Drawing and rendering methods\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n## Sample Repositories\n\n### Official (by Zoom)\n\n| Repository | Type | Last Updated | Status | SDK Version |\n|-----------|------|-------------|--------|-------------|\n| [zoomapps-sample-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-sample-js) | Hello World (Vanilla JS) | Dec 2025 | Active | ^0.16.26 |\n| [zoomapps-advancedsample-react](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-advancedsample-react) | Advanced (React + Redis) | Oct 2025 | Active | 0.16.0 |\n| [zoomapps-customlayout-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-customlayout-js) | Layers API | Nov 2023 | Stale | ^0.16.8 |\n| [zoomapps-texteditor-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-texteditor-vuejs) | Collaborate (Vue + Y.js) | Oct 2023 | Stale | ^0.16.7 |\n| [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) | Serverless (Firebase) | Aug 2024 | Stale | ^0.16.21 |\n| [zoomapps-cameramode-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-cameramode-vuejs) | Camera Mode | - | - | - |\n| [zoomapps-workshop-sample](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-workshop-sample) | Workshop | - | - | - |\n\n**Recommended for new projects:** Use `@zoom\u002Fappssdk` version `^0.16.26`.\n\n### Community\n\n| Type | Repository | Description |\n|------|------------|-------------|\n| Library | [harvard-edtech\u002Fzaccl](https:\u002F\u002Fgithub.com\u002Fharvard-edtech\u002Fzaccl) | Zoom App Complete Connection Library |\n\n**Full list**: See [general\u002Freferences\u002Fcommunity-repos.md](..\u002Fgeneral\u002Freferences\u002Fcommunity-repos.md)\n\n### Learning Path\n\n1. **Start**: `zoomapps-sample-js` - Simplest, most up-to-date\n2. **Advanced**: `zoomapps-advancedsample-react` - Comprehensive (In-Client OAuth, Guest Mode, Collaborate)\n3. **Specialized**: Pick based on feature (Layers, Serverless, Camera Mode)\n\n## Critical Gotchas (From Real Development)\n\n### 1. Global Variable Conflict\nThe CDN script defines `window.zoomSdk`. Declaring `let zoomSdk` in your code causes `SyntaxError: redeclaration of non-configurable global property`. Use `let sdk = window.zoomSdk` or the NPM import.\n\n### 2. Domain Allowlist\nYour app URL **must** be in the Marketplace domain allowlist. Without it, Zoom shows a blank panel with no error. Also add `appssdk.zoom.us` and any CDN domains you use.\n\n### 3. Capabilities Must Be Listed\nOnly APIs listed in `config({ capabilities: [...] })` are available. Calling an unlisted API throws an error. This is also true for event listeners.\n\n### 4. SDK Only Works Inside Zoom\n`zoomSdk.config()` throws outside the Zoom client. Always wrap in try\u002Fcatch with browser fallback:\n```javascript\ntry { await zoomSdk.config({...}); } catch { showBrowserPreview(); }\n```\n\n### 5. ngrok URL Changes\nFree ngrok URLs change on restart. You must update 4 places in Marketplace: Home URL, Redirect URL, OAuth Allow List, Domain Allow List. Consider ngrok paid plan for stable subdomain.\n\n### 6. In-Client OAuth vs Web OAuth\nUse `zoomSdk.authorize()` (In-Client) for best UX - no browser redirect. Only fall back to web redirect for initial install from Marketplace.\n\n### 7. Camera Mode CEF Race Condition\nCamera mode uses CEF which takes time to initialize. `drawImage`\u002F`drawWebView` may fail if called too early. Implement retry with exponential backoff.\n\n### 8. Cookie Configuration\nZoom's embedded browser requires cookies with `SameSite=None` and `Secure=true`. Without this, sessions break silently.\n\n### 9. State Validation\nAlways validate the OAuth `state` parameter to prevent CSRF attacks. Generate cryptographically random state, store it, and verify on callback.\n\n## Resources\n\n- **Official docs**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n- **SDK reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n- **NPM package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n- **Developer forum**: https:\u002F\u002Fdevforum.zoom.us\u002F\n- **GitHub SDK source**: https:\u002F\u002Fgithub.com\u002Fzoom\u002Fappssdk\n\n---\n\n**Need help?** Start with Integrated Index section below for complete navigation.\n\n---\n\n## Integrated Index\n\n_This section was migrated from `SKILL.md`._\n\n## Quick Start Path\n\n**If you're new to Zoom Apps, follow this order:**\n\n1. **Run preflight checks first** -> [RUNBOOK.md](RUNBOOK.md)\n\n2. **Read the architecture** -> [concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)\n   - Frontend\u002Fbackend pattern, embedded browser, deep linking\n   - Understand how Zoom loads and communicates with your app\n\n3. **Build your first app** -> [examples\u002Fquick-start.md](examples\u002Fquick-start.md)\n   - Complete Express + SDK Hello World\n   - ngrok setup for local development\n\n4. **Understand running contexts** -> [concepts\u002Frunning-contexts.md](concepts\u002Frunning-contexts.md)\n   - Where your app runs (inMeeting, inMainClient, inWebinar, etc.)\n   - Context-specific APIs and limitations\n\n5. **Implement OAuth** -> [examples\u002Fin-client-oauth.md](examples\u002Fin-client-oauth.md)\n   - In-Client OAuth with PKCE (best UX)\n   - Token exchange and storage\n\n6. **Add features** -> [references\u002Fapis.md](references\u002Fapis.md)\n   - 100+ SDK methods organized by category\n   - Code examples for each\n\n7. **Troubleshoot** -> [troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)\n   - Quick diagnostics for common problems\n\n---\n\n## Documentation Structure\n\n```\nzoom-apps-sdk\u002F\n├── SKILL.md                           # Main skill overview\n├── SKILL.md                           # This file - navigation guide\n│\n├── concepts\u002F                          # Core architectural patterns\n│   ├── architecture.md               # Frontend\u002Fbackend, embedded browser, OAuth flow\n│   ├── running-contexts.md           # Where your app runs + context-specific APIs\n│   └── security.md                   # OWASP headers, CSP, data access layers\n│\n├── examples\u002F                          # Complete working code\n│   ├── quick-start.md                # Hello World - minimal Express + SDK app\n│   ├── in-client-oauth.md            # In-Client OAuth with PKCE\n│   ├── layers-immersive.md           # Layers API - immersive mode (custom layouts)\n│   ├── layers-camera.md              # Layers API - camera mode (virtual camera)\n│   ├── collaborate-mode.md           # Collaborate mode (shared state)\n│   ├── guest-mode.md                 # Guest mode (unauthenticated -> authorized)\n│   ├── breakout-rooms.md             # Breakout room integration\n│   └── app-communication.md          # connect + postMessage between instances\n│\n├── troubleshooting\u002F                   # Problem solving guides\n│   ├── common-issues.md              # Quick diagnostics, error codes\n│   ├── debugging.md                  # Local dev setup, ngrok, browser preview\n│   └── migration.md                  # SDK version migration notes\n│\n└── references\u002F                        # Reference documentation\n    ├── apis.md                        # Complete API reference (100+ methods)\n    ├── events.md                      # All SDK events\n    ├── layers-api.md                  # Layers API detailed reference\n    ├── oauth.md                       # OAuth flows for Zoom Apps\n    └── zmail-sdk.md                   # Zoom Mail integration\n```\n\n---\n\n## By Use Case\n\n### I want to build a basic Zoom App\n1. [Architecture](concepts\u002Farchitecture.md) - Understand the pattern\n2. [Quick Start](examples\u002Fquick-start.md) - Build Hello World\n3. [In-Client OAuth](examples\u002Fin-client-oauth.md) - Add authorization\n4. [Security](concepts\u002Fsecurity.md) - Required headers\n\n### I want immersive video layouts (Layers API)\n1. [Layers Immersive](examples\u002Flayers-immersive.md) - Custom video positions\n2. [Layers API Reference](references\u002Flayers-api.md) - All drawing methods\n3. [App Communication](examples\u002Fapp-communication.md) - Sync layout across participants\n\n### I want a virtual camera overlay\n1. [Camera Mode](examples\u002Flayers-camera.md) - Camera mode rendering\n2. [Layers API Reference](references\u002Flayers-api.md) - Drawing methods\n\n### I want real-time collaboration\n1. [Collaborate Mode](examples\u002Fcollaborate-mode.md) - Shared state APIs\n2. [App Communication](examples\u002Fapp-communication.md) - Instance messaging\n\n### I want guest\u002Fanonymous access\n1. [Guest Mode](examples\u002Fguest-mode.md) - Three authorization states\n2. [In-Client OAuth](examples\u002Fin-client-oauth.md) - promptAuthorize flow\n\n### I want breakout room support\n1. [Breakout Rooms](examples\u002Fbreakout-rooms.md) - Room detection and state sync\n\n### I want to sync between main client and meeting\n1. [App Communication](examples\u002Fapp-communication.md) - connect + postMessage\n2. [Running Contexts](concepts\u002Frunning-contexts.md) - Multi-instance behavior\n\n### I want serverless deployment\n1. [Quick Start](examples\u002Fquick-start.md) - Understand the base pattern first\n2. Sample: [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) - Firebase pattern\n\n### I want to add Zoom Mail integration\n1. [Zoom Mail Reference](references\u002Fzmail-sdk.md) - REST API + mail plugins\n\n### I'm getting errors\n1. [Common Issues](troubleshooting\u002Fcommon-issues.md) - Quick diagnostic table\n2. [Debugging](troubleshooting\u002Fdebugging.md) - Local dev setup, DevTools\n3. [Migration](troubleshooting\u002Fmigration.md) - Version compatibility\n\n---\n\n## Most Critical Documents\n\n### 1. Architecture (FOUNDATION)\n**[concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)**\n\nUnderstand how Zoom Apps work: Frontend in embedded browser, backend for OAuth\u002FAPI, SDK as the bridge. Without this, nothing else makes sense.\n\n### 2. Quick Start (FIRST APP)\n**[examples\u002Fquick-start.md](examples\u002Fquick-start.md)**\n\nComplete working code. Get something running before diving into advanced features.\n\n### 3. Common Issues (MOST COMMON PROBLEMS)\n**[troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)**\n\n90% of Zoom Apps issues are: domain allowlist, global variable conflict, or missing capabilities.\n\n---\n\n## Key Learnings\n\n### Critical Discoveries:\n\n1. **Global Variable Conflict is the #1 Gotcha**\n   - CDN script defines `window.zoomSdk` globally\n   - `let zoomSdk = ...` causes SyntaxError in Zoom's browser\n   - Use `let sdk = window.zoomSdk` or NPM import\n\n2. **Domain Allowlist is Non-Negotiable**\n   - App shows blank panel with zero error if domain not whitelisted\n   - Must include your domain AND `appssdk.zoom.us` AND any CDN domains\n   - ngrok URLs change on restart - must update Marketplace each time\n\n3. **config() Gates Everything**\n   - Must be called first, must list all capabilities\n   - Unlisted capabilities throw errors\n   - Check `unsupportedApis` for client version compatibility\n\n4. **In-Client OAuth > Web OAuth for UX**\n   - `authorize()` keeps user in Zoom (no browser redirect)\n   - Web redirect only needed for initial Marketplace install\n   - Always implement PKCE (code_verifier + code_challenge)\n\n5. **Two App Instances Can Run Simultaneously**\n   - Main client instance + meeting instance\n   - Use `connect()` + `postMessage()` to sync between them\n   - Pre-meeting setup in main client, use in meeting\n\n6. **Camera Mode Has CEF Quirks**\n   - CEF initialization takes time\n   - Draw calls may fail if too early\n   - Use retry with exponential backoff\n\n7. **Cookie Settings Matter**\n   - `SameSite=None` + `Secure=true` required\n   - Without this, sessions silently fail in embedded browser\n\n---\n\n## Quick Reference\n\n### \"App shows blank panel\"\n-> [Domain Allowlist](troubleshooting\u002Fcommon-issues.md) - add domain to Marketplace\n\n### \"SyntaxError: redeclaration\"\n-> [Global Variable](troubleshooting\u002Fcommon-issues.md) - use `let sdk = window.zoomSdk`\n\n### \"config() throws error\"\n-> [Browser Preview](troubleshooting\u002Fdebugging.md) - SDK only works inside Zoom\n\n### \"API call fails silently\"\n-> [OAuth Scopes](troubleshooting\u002Fcommon-issues.md) - add required scopes in Marketplace\n\n### \"How do I implement [feature]?\"\n-> [API Reference](references\u002Fapis.md) - find the method, check capabilities needed\n\n### \"How do I test locally?\"\n-> [Debugging Guide](troubleshooting\u002Fdebugging.md) - ngrok + Marketplace config\n\n---\n\n## Document Version\n\nBased on **@zoom\u002Fappssdk v0.16.x** (latest: 0.16.26+)\n\n---\n\n**Happy coding!**\n\nStart with [Architecture](concepts\u002Farchitecture.md) to understand the pattern, then [Quick Start](examples\u002Fquick-start.md) to build your first app.\n",{"name":5,"triggers":54,"description":7,"user-invocable":50},[55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71],"zoom app","in-meeting app","app inside zoom","zoom client app","layers api","immersive mode","camera mode","collaborate mode","appssdk","in-client oauth","zoom mail","domain allowlist","domain whitelist","url whitelisting","blank panel","runningContext","zoomSdk","main","e605d8ddbfb688da57dfaaceebd93f12a64ef1d3","partner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk",3935,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins","https:\u002F\u002Fgithub.com\u002Fanthropics","https:\u002F\u002Fanthropic.com","2026-11-13 04:18:26",{"source":8,"skillName":5,"commands":81,"prompt":91,"zipAvailable":92},[82,85,88],{"tool":83,"command":84},"npx","npx skills add anthropics\u002Fknowledge-work-plugins --skill zoom-apps-sdk",{"tool":86,"command":87},"bunx","bunx skills add anthropics\u002Fknowledge-work-plugins --skill zoom-apps-sdk",{"tool":89,"command":90},"pnpm","pnpm dlx skills add anthropics\u002Fknowledge-work-plugins --skill zoom-apps-sdk","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",true,[94,100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,160,164,168,172,176,180,184],{"path":95,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":98,"sourceHtmlUrl":99},"concepts\u002Farchitecture.md","REFERENCE","参考文档",7864,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fconcepts\u002Farchitecture.md",{"path":101,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":102,"sourceHtmlUrl":103},"concepts\u002Fmeeting-sdk-vs-zoom-apps.md",1066,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fconcepts\u002Fmeeting-sdk-vs-zoom-apps.md",{"path":105,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":106,"sourceHtmlUrl":107},"concepts\u002Frunning-contexts.md",5745,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fconcepts\u002Frunning-contexts.md",{"path":109,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":110,"sourceHtmlUrl":111},"concepts\u002Fsecurity.md",5486,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fconcepts\u002Fsecurity.md",{"path":113,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":114,"sourceHtmlUrl":115},"examples\u002Fapp-communication.md",3724,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Fapp-communication.md",{"path":117,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":118,"sourceHtmlUrl":119},"examples\u002Fbreakout-rooms.md",3313,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Fbreakout-rooms.md",{"path":121,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":122,"sourceHtmlUrl":123},"examples\u002Fcollaborate-mode.md",4185,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Fcollaborate-mode.md",{"path":125,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":126,"sourceHtmlUrl":127},"examples\u002Fguest-mode.md",3585,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Fguest-mode.md",{"path":129,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":130,"sourceHtmlUrl":131},"examples\u002Fin-client-oauth.md",6272,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Fin-client-oauth.md",{"path":133,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":134,"sourceHtmlUrl":135},"examples\u002Flayers-camera.md",5818,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Flayers-camera.md",{"path":137,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":138,"sourceHtmlUrl":139},"examples\u002Flayers-immersive.md",8041,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Flayers-immersive.md",{"path":141,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":142,"sourceHtmlUrl":143},"examples\u002Fquick-start.md",7445,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Fexamples\u002Fquick-start.md",{"path":145,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":146,"sourceHtmlUrl":147},"references\u002Fapis.md",5417,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Freferences\u002Fapis.md",{"path":149,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":150,"sourceHtmlUrl":151},"references\u002Fenvironment-variables.md",1108,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Freferences\u002Fenvironment-variables.md",{"path":153,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":154,"sourceHtmlUrl":155},"references\u002Fevents.md",3904,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Freferences\u002Fevents.md",{"path":157,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":158,"sourceHtmlUrl":159},"references\u002Flayers-api.md",16129,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Freferences\u002Flayers-api.md",{"path":161,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":162,"sourceHtmlUrl":163},"references\u002Foauth.md",5418,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Freferences\u002Foauth.md",{"path":165,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":166,"sourceHtmlUrl":167},"references\u002Fzmail-sdk.md",5616,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Freferences\u002Fzmail-sdk.md",{"path":169,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":170,"sourceHtmlUrl":171},"RUNBOOK.md",3412,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002FRUNBOOK.md",{"path":173,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":174,"sourceHtmlUrl":175},"troubleshooting\u002Fcommon-issues.md",4376,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Ftroubleshooting\u002Fcommon-issues.md",{"path":177,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":178,"sourceHtmlUrl":179},"troubleshooting\u002Fdebugging.md",3626,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Ftroubleshooting\u002Fdebugging.md",{"path":181,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":182,"sourceHtmlUrl":183},"troubleshooting\u002Fforum-top-questions.md",1086,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Ftroubleshooting\u002Fforum-top-questions.md",{"path":185,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":186,"sourceHtmlUrl":187},"troubleshooting\u002Fmigration.md",3030,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk\u002Ftroubleshooting\u002Fmigration.md",[189,215,239,261,286,312],{"skillNo":190,"name":191,"nameZh":6,"description":192,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":193,"categories":194,"keywords":195,"publishedAt":49},"01M718Y97HCGW12Q53PSJDY03W","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.\"","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fsmall-business\u002Fskills\u002Fticket-deflector\u002FSKILL.md",[],[196,197,36,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214],"ticket","ticket deflector","up","payments","open","writing","when","workflow","ask","Connector","text","mail","window","next","customer","support","crm","past","read",{"skillNo":216,"name":217,"nameZh":6,"description":218,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":219,"categories":220,"keywords":221,"publishedAt":49},"01M718Y55HFAN5705ME5VEDZ9K","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.\nAny tax request routes first to \u002Ftax-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.\"","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fsmall-business\u002Fskills\u002Ftax-season-organizer\u002FSKILL.md",[],[222,223,224,225,226,227,228,229,230,231,202,232,233,234,48,235,214,236,237,238],"tax season organizer","tax","us federal","which","netsuite","paid","end","usd","only","now","books","xero","scanning","request","flags","list","stripe",{"skillNo":240,"name":241,"nameZh":6,"description":242,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":243,"categories":244,"keywords":245,"publishedAt":49},"01M718Y13VVPHDD9NTDBVFJ2AZ","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.","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fsmall-business\u002Fskills\u002Ftax-prep\u002FSKILL.md",[],[246,223,247,248,224,249,250,226,251,252,253,254,255,34,256,228,257,258,259,260],"tax prep","prep","SET","as","ready","never","zoho books","get","chain","profit","trigger","material","question","paypal","business",{"skillNo":262,"name":263,"nameZh":6,"description":264,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":265,"categories":266,"keywords":268,"publishedAt":49},"01M718XWTWQZ01GYSG9T8RW8TW","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.","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fsmall-business\u002Fskills\u002Fspeed-to-lead\u002FSKILL.md",[267],{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},[269,270,271,272,273,274,251,275,276,277,278,279,280,281,202,282,283,205,284,285],"speed to lead","lead","speed","shared","back","cold","time","inbox","send","respond","new","web forms","people","schedule","logs","sure","human",{"skillNo":287,"name":288,"nameZh":6,"description":289,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":290,"categories":291,"keywords":295,"publishedAt":49},"01M718XQYMN1KY3TPS33967FK0","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.","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fsmall-business\u002Fskills\u002Fsocial-content-engine\u002FSKILL.md",[292],{"categoryNo":293,"categoryName":294,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000036","内容创作者",[296,297,298,299,300,301,248,302,303,304,305,198,306,202,307,308,309,214,310,311],"social","social content engine","engine","content engine","social content","content","brief","posts","Captions","prices","campaign","me","product","calendar","write","drafts",{"skillNo":313,"name":314,"nameZh":6,"description":315,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":316,"categories":317,"keywords":318,"publishedAt":49},"01M718XMPJVH0EVRVP998BVZPC","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.","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Fblob\u002Fmain\u002Fsmall-business\u002Fskills\u002Fsmb-router\u002FSKILL.md",[],[319,320,321,249,322,34,256,323,200,324,231,260,325,326,327,328,329,307,330,209],"router","smb","smb router","do","front","single","you","vague","can","with","plugin","focus"]