Skip to content

zoom/zoom-plugin-codex

Repository files navigation

Zoom

Zoom connects Codex to Zoom meeting context through the Zoom app connector and provides developer workflows for planning, building, debugging, and reviewing Zoom integrations across APIs, SDKs, webhooks, WebSockets, bots, and automation use cases.

Plugin Shape

This repository is packaged as a Codex plugin:

This plugin contains the Zoom app connector mapping, local developer guidance, commands, skills, reviewer agents, and branding assets.

What Zoom Does In Codex

Use Zoom when you want Codex to:

  • search Zoom meetings by topic, attendee, or content
  • retrieve summaries, transcripts, recordings, and related meeting assets
  • pull meeting context into coding, documentation, or follow-up workflows
  • choose the right Zoom product surface for an integration
  • build Zoom REST API, SDK, webhook, WebSocket, bot, and automation workflows
  • debug Zoom auth, event delivery, SDK, and API issues

Local Testing

For local sideload testing, see sideload.md.

Using In Codex

Codex can use this plugin through the Zoom app connector plus command, skill, and reviewer-agent surfaces:

  • install the plugin from /plugins
  • authenticate the Zoom app connector when Codex prompts for it
  • mention the plugin as @Zoom if the UI exposes it
  • use natural language requests that need live Zoom meeting context
  • use slash commands for deterministic flows such as /setup-zoom-oauth, /debug-zoom-auth, /debug-zoom-webhook, and /zoom-integration-doctor
  • invoke a bundled skill explicitly with $skill-name, for example $start or $setup-zoom-oauth
  • describe the task naturally and let Codex route into the right skill

The Zoom app connector auth is managed by Codex. It is not exposed as a shell environment variable or raw bearer token.

If a newly installed skill does not trigger in the current thread, start a new Codex session so the plugin metadata reloads.

Command Workflows

Use the bundled slash commands when you want a deterministic flow rather than open-ended routing:

Command Description
/plan-zoom-product Choose the right Zoom product surface for a use case and explain the tradeoffs clearly
/plan-zoom-integration Turn a Zoom product idea into a practical build plan with auth, architecture, and milestones
/debug-zoom Triage a broken Zoom integration when the failing layer is not yet obvious
/setup-zoom-oauth Inspect the repo, choose the right Zoom OAuth flow, and wire the auth path cleanly
/setup-zoom-webhooks Implement or correct a Zoom webhook receiver with validation, signature checks, and reliable delivery handling
/setup-zoom-websockets Implement or correct a Zoom WebSocket event stream with connection lifecycle and reconnect handling
/debug-zoom-auth Isolate OAuth, SDK auth, or token lifecycle failures and propose the minimal fix
/debug-zoom-webhook Triage webhook registration, signature validation, delivery, and handler issues
/zoom-integration-doctor Run a read-first integration audit across auth, SDK/API choice, and eventing

Build Commands

Use the bundled build commands when you want Codex to drive a specific Zoom implementation path:

Command Description
/build-zoom-rest-api-app Implement a Zoom REST API integration with the right resources, auth path, and verification loop
/build-zoom-apps-sdk-app Implement a Zoom Apps SDK app that runs inside the Zoom client with the right running context and auth path
/build-zoom-meeting-app Implement an embedded or managed Zoom meeting flow in the current codebase
/build-zoom-meeting-sdk-app Implement a Zoom Meeting SDK integration with the right platform-specific join or start flow
/build-zoom-video-sdk-app Implement a custom Zoom Video SDK session workflow
/build-zoom-ui-toolkit-app Implement a Zoom Video SDK UI Toolkit integration for a prebuilt web session UI
/build-zoom-cobrowse-app Implement a Zoom Cobrowse integration with session lifecycle, privacy controls, and support workflow wiring
/build-zoom-rivet-app Implement a server-side Zoom integration with Rivet modules for auth, APIs, and webhooks
/build-zoom-probe-flow Implement readiness checks with Zoom Probe SDK before users join meetings or sessions
/build-zoom-rtms-app Implement a Zoom RTMS workflow for live media, transcript, or event-stream processing
/build-zoom-scribe-app Implement a Zoom Scribe transcription pipeline for uploaded or stored media
/build-zoom-bot Implement a Zoom meeting bot, recorder, or real-time media workflow
/build-zoom-team-chat-app Implement a Zoom Team Chat integration or chatbot flow
/build-zoom-phone-integration Implement a Zoom Phone integration around APIs, Smart Embed, or events
/build-zoom-contact-center-app Implement a Zoom Contact Center integration for web, mobile, or backend workflows
/build-zoom-virtual-agent Implement a Zoom Virtual Agent integration for web or mobile wrappers

Reviewer Agents

The plugin also bundles focused reviewer agents for specialist analysis:

Agent Description
zoom-oauth-scope-auditor Review scope sets for least privilege, missing scopes, and cross-surface mistakes
zoom-integration-reviewer Review a Zoom integration end to end for architectural, auth, webhook, and SDK risks

Primary Workflows

Codex can invoke skills implicitly from task descriptions, or explicitly by mentioning a skill such as $start or $setup-zoom-oauth.

Skill Description
start Start with a Zoom app idea and route to the right product and build path
setup-zoom-oauth Choose the auth model, scopes, and redirect flow for a Zoom app
build-zoom-meeting-app Build an embedded or managed Zoom meeting flow
build-zoom-bot Build bots, recorders, and real-time meeting processors
debug-zoom Triage a broken Zoom integration and isolate the failing layer
build-zoom-rest-api-app Route into Zoom REST endpoints, scopes, and resource patterns
build-zoom-meeting-sdk-app Route into embedded Zoom meeting implementation details
build-zoom-video-sdk-app Route into custom video-session implementation details
build-zoom-rtms-app Route into Zoom RTMS for live media, transcript, and event-stream workflows
setup-zoom-webhooks Set up Zoom webhook subscriptions, signature verification, and handlers
setup-zoom-websockets Set up Zoom WebSocket event delivery when it fits better than webhooks
build-zoom-team-chat-app Build Team Chat user or chatbot integrations
build-zoom-phone-integration Build Zoom Phone integrations around Smart Embed, APIs, and events
build-zoom-contact-center-app Build Contact Center app, web, or native integrations
build-zoom-virtual-agent Build Virtual Agent web or mobile wrapper integrations

Supporting References

The plugin keeps the Zoom product-specific reference library under skills/. These are supporting references, not the primary entry surface:

Example Prompts

Search my recent Zoom meetings for the discussion about SDK migration, then use the findings to plan the implementation work.
Use $start to plan an internal meeting assistant that extracts action items and stores summaries.
Run /build-zoom-meeting-app to add a Zoom join flow to this React app with the right auth and server-side pieces.
Run /debug-zoom-webhook to diagnose why Zoom events reach the endpoint but signature validation fails.
Run /plan-zoom-product for an internal meeting assistant that needs summaries, action items, and follow-up docs so we pick the right Zoom surface first.

About

Codex plugin for planning, building, and debugging Zoom integrations

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors