zoom-contact-center-web — Codex skill: what it does, how to install
Developer instructions for embedding Zoom Contact Center SDK into web projects. Guides chat widgets, video embeds, iframe postMessage events, and session states.
npx skills add openai/plugins --skill web -a codexWhat zoom-contact-center-web does
This skill guides developers through three Zoom Contact Center integration patterns. The first connects client apps using Zoom Apps SDK events. The second embeds chat or video directly onto external sites via zoomCampaignSdk scripts. The third configures Smart Embed workflows inside an iframe using a strict postMessage contract.
Never execute calls before zoomCampaignSdk:ready. Every SDK call must stay gated behind that ready event. Session persistence requires storing state under engagementId, especially because backgrounding and context switching happen frequently.
Verify Content Security Policy and domain allow-lists before touching your application code. If CSP blocks scripts, debugging frontend logic is pointless. The skill also links to runbooks and companion guides covering OAuth and Cobrowse setups.
What it helps with
- embed Zoom Contact Center chat and video onto an external site
- configure iframe Smart Embed workflows using postMessage events
- track interaction state across context switches using engagementId
- validate CSP headers and allow-lists before SDK initialization
Example prompts for the agent
- Set up a Zoom Contact Center Smart Embed iframe with the postMessage event contract
- Write a web snippet using zoomCampaignSdk that waits for the ready event and stores engagementId
- Check CSP rules and allow-lists needed for embedding Zoom Contact Center video on a website
How to install zoom-contact-center-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/contact-center/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-contact-center-web
How do I install zoom-contact-center-web in Codex?
Run npx skills add openai/plugins --skill web -a codex in your terminal. Codex stores the skill at .agents/skills/web/SKILL.md.
What does zoom-contact-center-web do?
It provides architecture patterns and guardrails for integrating the Zoom Contact Center Web SDK into web apps and iframes. It covers event handling and engagement lifecycles.
What critical guardrails must be followed during implementation?
Do not trigger campaign SDK methods before zoomCampaignSdk:ready fires. Always persist session states keyed by engagementId to handle app backgrounding.
Source text
SKILL.md · MIT
--- name: zoom-contact-center-web description: "Zoom Contact Center SDK for Web. Use for web chat/video/campaign embeds, engagement event handling, app-context integrations, and Smart Embed postMessage workflows." --- # Zoom Contact Center SDK - Web Official docs: - https://developers.zoom.us/docs/contact-center/web/ - https://developers.zoom.us/docs/contact-center/web/sdk-reference/ ## Quick Links 1. [concepts/lifecycle-and-events.md](concepts/lifecycle-and-events.md) 2. [examples/app-context-and-state.md](examples/app-context-and-state.md) 3. [references/web-reference-map.md](references/web-reference-map.md) 4. [troubleshooting/common-issues.md](troubleshooting/common-issues.md) ## Integration Modes 1. Contact Center App in Zoom client: - Zoom Apps SDK engagement APIs/events. 2. External website embed: - Campaign SDK/web scripts (`zoomCampaignSdk` pattern). - Video client initialization pattern. 3. Smart Embed: - iframe + `postMessage` event contract. ## Hard Guardrails - For campaign SDK, gate calls behind `zoomCampaignSdk:ready`. - Persist state by `engagementId`. - Expect context switching and background app behavior. - Validate CSP and allow-list settings before debugging logic. ## Chaining - For in-client app APIs and auth flows: [../../zoom-apps-sdk/SKILL.md](../../zoom-apps-sdk/SKILL.md) - For identity and OAuth: [../../oauth/SKILL.md](../../oauth/SKILL.md) - For cobrowse workflow: [../../cobrowse-sdk/SKILL.md](../../cobrowse-sdk/SKILL.md) ## Operations - [RUNBOOK.md](RUNBOOK.md) - 5-minute preflight and debugging checklist.
© Zoom · MIT · openai/plugins
