setup-zoom-websockets · openai — Codex skill: what it does, how to install
This skill guides persistent Zoom event delivery over WebSockets instead of HTTP webhooks. Use it when connection behavior, latency, or deployment constraints call for a long-lived channel.
npx skills add openai/plugins --skill websockets -a codexWhat setup-zoom-websockets does
The skill lays out a Zoom WebSockets integration from app and event-subscription setup to connection handling. It covers authentication, heartbeats, reconnects with backoff, and clean shutdown. When a project supports both transports, events can be mapped to the same internal contract used by webhook handlers.
Its reference set includes connection and event guides plus a troubleshooting file. The workflow also adds observability around connection state, reconnect totals, event lag, and dropped messages. Debugging is split across token and auth issues, subscription settings, proxies, TLS interception, and reconnect loops.
The guide draws a clear boundary with regular webhooks: when webhook retries and delivery are sufficient, use setup-zoom-webhooks instead. That distinction matters before choosing a persistent connection.
What it helps with
- configure persistent Zoom event delivery
- subscribe an app to the required event stream
- handle authentication and heartbeat messages
- recover connections with backoff
- trace proxy, TLS, token, and reconnect failures
Example prompts for the agent
- Set up Zoom WebSockets for the event stream used by this integration.
- Add authentication, heartbeat handling, reconnect backoff, and clean shutdown.
- Map WebSocket events to the webhook handler contract and track event lag.
How to install setup-zoom-websockets
1Skills CLI (Vercel)
npx skills add openai/plugins --skill websockets -a codex2Manually: put the files in place
.agents/skills/websockets/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill websockets -a claude-code2Manually: put the files in place
~/.claude/skills/websockets/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/websockets/
Manually: put the files in place
.cursor/skills/websockets/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins websockets2Manually: put the files in place
.github/skills/websockets/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/websocketsManually: put the files in place
.devin/skills/websockets/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 setup-zoom-websockets
How do I install setup-zoom-websockets in Codex?
Run npx skills add openai/plugins --skill websockets -a codex, then check .agents/skills/websockets/SKILL.md.
What does setup-zoom-websockets do?
It guides a persistent Zoom WebSockets integration, including event subscriptions, authentication, heartbeats, reconnect behavior, shutdown handling, and connection troubleshooting.
When should I use this instead of Zoom webhooks?
Use it when latency, firewall rules, connection design, or deployment constraints justify a persistent channel. If normal webhook retries and delivery are enough, choose setup-zoom-webhooks.
Source text
SKILL.md · MIT
--- name: setup-zoom-websockets description: Use when building Zoom WebSockets. --- # Setup Zoom WebSockets Use this skill when the integration needs persistent Zoom event delivery instead of HTTP webhook callbacks. If normal webhook retries and delivery are enough, prefer `setup-zoom-webhooks`. ## Workflow 1. Confirm WebSockets are justified by latency, firewall, connection model, or deployment constraints. 2. Configure the app and event subscriptions for the required event stream. 3. Implement connection setup, authentication, heartbeat, reconnect, backoff, and shutdown handling. 4. Normalize events into the same internal contract used by webhook handlers when both are supported. 5. Add observability for connection state, reconnect count, event lag, and dropped messages. 6. Debug by isolating token/auth problems, app subscription settings, network proxies, TLS interception, and reconnect loops. ## References - Full preserved guide: [references/full-guide.md](references/full-guide.md) - Connection: [references/connection.md](references/connection.md) - Events: [references/events.md](references/events.md) - Common issues: [troubleshooting/common-issues.md](troubleshooting/common-issues.md)
© Zoom · MIT · openai/plugins
Similar skills
SKILL.md skills catalog →setup-zoom-websockets by other authors comes first.
