zoom-virtual-agent-web — Codex skill: what it does, how to install
Embeds the Zoom Virtual Agent web SDK using campaign or entry ID flows. Helps manage chat lifecycle, handle user context, and set up CSP-safe scripts.
npx skills add openai/plugins --skill web -a codexWhat zoom-virtual-agent-web does
This skill guides Codex when implementing Zoom Virtual Agent Web SDK into browser applications. It covers widget initialization via campaign embed or entry ID, alongside user context updates.
The skill enforces strict SDK sequencing. Methods like show, hide, open, and close fail if called before initialization finishes. Every UI call must wait for the zoomCampaignSdk:ready event or the waitForReady() promise.
Host script policies and Content Security Policy rules must pass checks before troubleshooting chat logic. When reducing onboarding friction is the goal, campaign embeds take precedence over entry ID setups.
What it helps with
- embed Zoom Virtual Agent into web interfaces
- update user context within the active chat session
- synchronize chat UI actions with
waitForReady() - configure Content Security Policy headers for the Zoom SDK
Example prompts for the agent
- Integrate Zoom Virtual Agent into my web app using campaign embed and
waitForReady() - Set up event listeners for
zoomCampaignSdk:readybefore toggling the chat window - Audit CSP headers and script host settings for Zoom Virtual Agent
How to install zoom-virtual-agent-web
1Skills CLI (Vercel)
npx skills add openai/plugins --skill web -a codex2Manually: put the files in place
.agents/skills/web/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill web -a claude-code2Manually: put the files in place
~/.claude/skills/web/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/web/
Manually: put the files in place
.cursor/skills/web/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins web2Manually: put the files in place
.github/skills/web/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/virtual-agent/webManually: put the files in place
.devin/skills/web/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about zoom-virtual-agent-web
How to install zoom-virtual-agent-web in Codex?
Run npx skills add openai/plugins --skill web -a codex. The skill file will be placed at .agents/skills/web/SKILL.md.
What does zoom-virtual-agent-web do?
It provides patterns and hard guardrails for embedding Zoom Virtual Agent chat, handling lifecycle events, and configuring CSP.
Why should show or open calls wait for SDK readiness?
Calling interface methods before initialization completes triggers errors. The SDK requires gating them behind zoomCampaignSdk:ready or waitForReady().
Source text
SKILL.md · MIT
--- name: zoom-virtual-agent-web description: "Zoom Virtual Agent SDK for web embeds. Use for campaign or entry ID chat launch, event-driven controls, user context updates, and CSP-safe deployment." --- # Zoom Virtual Agent SDK - Web Official docs: - https://developers.zoom.us/docs/virtual-agent/web/ - https://developers.zoom.us/docs/virtual-agent/web/reference/ ## Quick Links 1. [concepts/lifecycle-and-events.md](concepts/lifecycle-and-events.md) 2. [examples/campaign-and-entry-patterns.md](examples/campaign-and-entry-patterns.md) 3. [references/web-reference-map.md](references/web-reference-map.md) 4. [troubleshooting/common-issues.md](troubleshooting/common-issues.md) ## Hard Guardrails - Gate calls behind readiness (`zoomCampaignSdk:ready` or `waitForReady()`). - Do not call `show/hide/open/close` before SDK initialization. - Keep CSP and script host policy validated before debugging business logic. - Prefer campaign embed over entry ID when minimizing user friction is a priority. ## Chaining - Product-level architecture and drift checks: [../SKILL.md](../SKILL.md) - Contact Center web context: [../../contact-center/web/SKILL.md](../../contact-center/web/SKILL.md) - OAuth or REST for backend workflows: [../../oauth/SKILL.md](../../oauth/SKILL.md), [../../rest-api/SKILL.md](../../rest-api/SKILL.md)
© Zoom · MIT · openai/plugins